La función de formateo de código llega experimentalmente a uv

• La nueva versión de uv ofrece de forma experimental una función de formateo de código
• El comando uv format usa internamente el formateador de Ruff para dar un estilo consistente al código Python
• Ahora es posible ordenar y formatear código fácilmente solo con uv sin necesitar una herramienta aparte
• Los usuarios pueden ajustar en detalle el comportamiento del formateo mediante argumentos adicionales
• Como todavía es una función experimental, es posible que cambien la forma del comando y el manejo de errores

---

Resumen

La versión más reciente de uv (0.8.13) introduce uv format, un comando experimental que los desarrolladores de Python llevaban tiempo esperando. Con esta función, es posible organizar el estilo del código usando solo uv dentro del proyecto, sin tener que gestionar una herramienta de formateo adicional

¿Qué es uv format?

• El comando uv format ofrece formateo de código Python a través de la interfaz de uv
• Internamente, invoca el formateador de Ruff para organizar automáticamente el código de manera consistente

Nota para desarrolladores

Charlie Marsh (desarrollador de uv) explicó lo siguiente en Hacker News

Ruff y uv no se están fusionando; siguen siendo herramientas separadas.
El objetivo es simplemente mejorar la experiencia para que el usuario pueda usar el formateador sin percibirlo como una herramienta aparte.
Es similar a la relación entre cargo fmt y rustfmt en el ecosistema de Rust.

Cómo usarlo

• Debes usar uv 0.8.13 o una versión superior
• Si ejecutas el comando uv format en la raíz del proyecto, el efecto es el mismo que ejecutar ruff format
• La forma de ejecución sigue la interfaz de comandos de uv

Pasar argumentos adicionales

• Con la forma uv format -- [argumentos adicionales] puedes configurar opciones detalladas que se pasan a Ruff
• Así puedes aprovechar al mismo tiempo la comodidad de uv y la configuración fina de Ruff

Aviso sobre la etapa experimental

• Actualmente, esta función está en una etapa experimental, por lo que en el futuro podrían cambiar tanto la forma del comando como la manera en que se integra con la estructura del proyecto
• El manejo de errores y el formato de salida también seguirán mejorándose
• La función evolucionará incorporando los comentarios de los usuarios

Cierre

• Si necesitas un estilo de código simple y consistente en proyectos Python, vale la pena probar uv format
• Como se trata de una incorporación experimental, usarlo directamente y enviar comentarios puede contribuir al desarrollo futuro de uv