Saltar al contenido

Cada regla del analizador tratada como error

Activé como errores todas las reglas del analizador Python y resolví 1.815 hallazgos hasta llegar a cero, con un motivo escrito para cada una de las escasas excepciones y dos de ellas respaldadas por una comprobación, además de un comentario.

1,815 hallazgos del analizador resueltos hasta llegar a cero

Situación. La mayoría de los proyectos eligen un subconjunto cómodo de las reglas de su analizador, y ese subconjunto se decide según las reglas que no producían diagnósticos el día de la configuración. Eso convierte la configuración en un registro de los hábitos existentes del código en lugar de un estándar al que someterlo, y cada regla desactivada es una clase de defecto de la que nadie recibirá aviso jamás.

Tarea. Había que invertir el valor predeterminado — activar como error todas las reglas que implementa la herramienta — y reducir a cero los problemas resultantes mediante correcciones, en lugar de negociarlos a la baja desactivando reglas otra vez.

Acción. Seleccionar el conjunto completo de reglas produjo 1.815 hallazgos en la primera ejecución. Se abordaron por categoría y no por archivo, porque las categorías dicen algo: los argumentos no usados y los nombres que ocultan funciones integradas son ruido, pero las categorías de seguridad, de valores predeterminados mutables y de gestión de excepciones señalaban comportamientos reales. Existen incompatibilidades genuinas — un formateador y un analizador pueden discrepar sobre la misma línea, y unas pocas reglas contradicen decisiones deliberadas del propio proyecto — y cada una de las escasas exenciones lleva un motivo escrito en el punto de aplicación que explica qué pedía la regla y por qué este código hace otra cosa. Dos van más allá y se respaldan con una comprobación en lugar de un comentario, para que la exención no pueda ampliarse silenciosamente: la regla está desactivada y una prueba verifica la propiedad concreta que habría exigido. La comprobación de tipos se ejecuta en modo estricto junto a ella, un estándar distinto y más exigente, y es la que detectó defectos que el analizador no podía ver porque afectan a qué es un valor y no a cómo se escribe.

Resultado. El analizador funciona con toda su exigencia y cero hallazgos, y cada desviación está documentada en la línea en que se aplica. El coste es real y merece nombrarse: la configuración más estricta produce hallazgos sobre los que de verdad no merece la pena actuar, y alguien tiene que emitir ese juicio 1.815 veces en lugar de una.

  • Bolígrafo junto a «Tuesday 8», marcado con un círculo en una agenda
    Foto: Roy_Inove / Pixabay
  • Lápices de colores, estuche, colorear
    Foto: congerdesign / Pixabay

Aplique esta experiencia a su proyecto

Utilice «Cada regla del analizador tratada como error» como punto de partida para un reto similar en su organización. Los servicios que respaldan este trabajo están disponibles para su proyecto. La parte que el usuario no ve: dónde se guardan los datos, qué reglas se aplican y cómo pueden comunicarse otros sistemas con ella.

Explore nuestros servicios Póngase en contacto

Mire más allá del resultado

Lea la situación, las decisiones y el resultado de este ejemplo. Podemos hablar de qué partes se adaptan a sus restricciones y cuáles necesitan otro enfoque. Cada regla del analizador tratada como error — 1,815 hallazgos del analizador resueltos hasta llegar a cero

Explore nuestros servicios Póngase en contacto

Una parte de una trayectoria más amplia — y toda ella está en este sitio.

Cada entrada sigue la misma estructura: la situación, la tarea, lo que hicimos y lo que cambió.

Vea la trayectoria completa

Defina la mejora que necesita

Describa el flujo de trabajo, las interfaces existentes y los usuarios que necesitan el cambio. Podemos definir una entrega comprobable y un traspaso que permita a su equipo mantener lo entregado.

Vea cuánto cuesta Póngase en contacto

¿Quiere convertir cada advertencia en un error real?

Pregunte por las decisiones detrás de «Cada regla del analizador tratada como error». Hablará con las personas que pueden explicar el trabajo y valorar su propio proyecto.

Explore nuestros servicios
welcome@engineer.company +45 50 10 61 84 Copenhague, Dinamarca
Código QR de Activé como errores todas las reglas del analizador Python y resolví 1.815 hallazgos hasta llegar a cero, con un motivo escrito para cada una de las escasas excepciones y dos de ellas respaldadas por una comprobación, además de un comentario.
Llévese esta páginahttps://engineer.company/es/portfolio/enabled-every-linter-rule-as-an-error/