El análisis estático en Python te permite encontrar bugs, problemas de estilo y hasta vulnerabilidades de seguridad sin ejecutar una sola línea de código. Si trabajas en equipo o en proyectos grandes, esta práctica te ahorra tiempo y mejora la calidad del software desde el primer commit. Aquí aprenderás a configurar y usar Ruff, la herramienta moderna que reemplaza a Pylint y Flake8.
Por qué Ruff reemplaza a Pylint y Flake8
Antes trabajábamos con dos opciones que no terminaban de convencer. Pylint era poderoso, pero lento y con configuraciones complejas. Flake8 corría más rápido, pero ofrecía menos reglas. Ninguno resolvía todo.
Hoy Ruff reemplaza a ambos y la razón es simple: fue escrito en Rust, lo que lo hace ultrarrápido. Combina las reglas de Pylint, Flake8 y otras herramientas en un solo paquete, y puede procesar miles de archivos en segundos [01:00].
¿Qué es el análisis estático? Es la revisión del código fuente sin ejecutarlo. Detecta errores de sintaxis, imports innecesarios y problemas potenciales antes de que lleguen a producción.
Esto convierte a Ruff en una pieza fundamental del desarrollo profesional, porque atrapa problemas que de otro modo descubrirías mucho más tarde.
Qué diferencia hay entre un formatter y un linter
Aquí viene una confusión común. Ruff cumple dos funciones distintas y conviene separarlas bien.
El formatter modifica tu código para cumplir las reglas de estilo de PEP 8. El linter, en cambio, detecta problemas dentro del código sin ejecutarlo, analizando el código fuente en busca de errores de sintaxis o problemas potenciales [02:30].
¿Cómo ejecuto el formatter y el linter de Ruff? Usas ruff format para formatear el código y ruff check para correr el linter. Son dos comandos independientes con objetivos diferentes.
La configuración de ambos vive en el archivo pyproject.toml, donde defines tus propias reglas o adaptas las recomendadas a tu proyecto.
Cómo detectar errores con ruff check
Al ejecutar ruff check en el proyecto, Ruff muestra de inmediato los errores con indicadores que señalan la ubicación exacta gracias a la última versión de Python [03:30].
Un caso típico: imports no usados. El formatter no los detecta, pero el linter sí. Sin ejecutar nada, descubres que estás importando código innecesario dentro de tu aplicación.
En el ejemplo, Ruff encontró 10 errores y marcó 8 como arreglables o fixeables.
Cómo arreglar errores automáticamente con fix
Para corregir de forma automática, agregas la palabra fix al comando:
bash
ruff check --fix
Al ejecutarlo, Ruff borra los imports no usados y modifica varios archivos. De los 10 errores, arregló 8 y dejó 2 pendientes [05:00].
¿Por qué quedaron dos sin resolver? Porque eran variables asignadas que nunca se usan, como unused_var. Ruff no las borra por su cuenta para no modificar el comportamiento de la aplicación. Esa decisión queda en tus manos.
Cómo configurar las reglas de Ruff
Ruff se trae automáticamente reglas de Flake8, PyFlakes y PyCodeStyle, pero no todas están activadas por defecto. Vienen seleccionadas las más básicas.
Si ejecutas el comando llamando todas las reglas, el panorama cambia por completo:
bash
ruff check --select ALL
En el ejemplo, esto reveló 266 errores [06:30]. Lo importante aquí no es la cifra, sino lo que demuestra: Ruff es altamente configurable y te permite elegir exactamente qué reglas aplicar según las necesidades de tu proyecto.
¿Cómo elijo qué reglas activar en Ruff? Vas a la documentación, buscas la regla que necesitas y la agregas al pyproject.toml. Puedes seleccionar reglas específicas o ignorar las que no apliquen a tu caso.
Qué reglas conviene activar primero
La documentación recomienda tres grupos de lints que vale la pena copiar al proyecto:
- PyCodeStyle y PyFlakes, para estilo y detección de errores básicos.
- PyUpgrade, que moderniza la sintaxis a la versión de Python que usas.
- isort, con la letra
I, para mantener todos los imports ordenados.
Una recomendación práctica: agrupa estas reglas junto a las demás bajo tool.ruff en tu pyproject.toml, así tu configuración se mantiene legible.
Con isort activado, al correr ruff check --fix no solo se borran los imports no usados, también se organizan en el orden correcto: primero los imports de Python, luego los de librerías externas y al final los locales, cada grupo separado por un enter y dos enters antes del código [08:30].
Qué errores no arregla Ruff solo
Algunos cambios son automáticos y muy útiles. Por ejemplo, PyUpgrade transforma un format en un literal string, que es la recomendación en versiones modernas de Python [09:30].
Otros errores quedan en tus manos. Un caso frecuente es el tamaño de línea: PEP 8 permite un máximo de 88 caracteres, y si una línea llega a 94 o 95, Ruff te lo marca.
Aquí hay un detalle clave: no puedes partir la línea en cualquier punto, porque romperías la ejecución del código. Debes cortarla en un lugar que mantenga el comportamiento intacto y a la vez cumpla la regla de los 88 caracteres.
Tres buenas prácticas con análisis estático
Para sacarle el máximo provecho a Ruff en tu flujo de trabajo, ten en cuenta tres hábitos.
- Configúralo desde el inicio del proyecto para mantener la consistencia.
- Ejecuta
ruff check de forma regular, idealmente en cada commit con pre-commit.
- Combínalo con otras herramientas como MyPy para los tipos y PyTest para los tests.
Esa combinación crea una suite completa de calidad de código que atrapa problemas antes de que crezcan. ¿Ya lo configuraste en tu proyecto? Cuéntame en los comentarios qué reglas activaste primero.