Saltar al contenido

Motor de 268 controles para el repositorio

Desarrollé el motor de comprobaciones del repositorio — 268 controles de commit registrados, 277 reglas de análisis estático y 15 reglas ESLint propias —, además de 146 pruebas de los propios controles, para que la compilación haga cumplir el criterio de calidad.

268 controles de commit y 146 pruebas de los propios controles

Situación. Las normas escritas en una guía de contribución son sugerencias. Todo el mundo está de acuerdo con ellas, hasta que llega el viernes, el cambio es pequeño y la guía acaba perdiendo. El criterio de cero advertencias solo iba a mantenerse si lo sostenía algo más que la buena voluntad. Además, los analizadores que acompañan a cada lenguaje se quedan muy lejos de las reglas propias del proyecto que realmente importan: las que definen cómo debe funcionar este código en concreto.

Tarea. Las reglas importantes para el proyecto debían poder ejecutarse, de modo que incumplir una hiciera fallar el commit en lugar de esperar a que una persona revisora tuviera tiempo y se acordara de detectarlo.

Acción. De ahí surgió un motor de controles. Hay 274 scripts de comprobación, 268 registrados en los hooks de commit, junto con 277 analizadores JavaScript, 96 validadores Shell y 17 Python. Cubren lo que las herramientas generales no examinan: que una migración pueda revertirse, que una clave de traducción exista en ambos idiomas, que una ruta registrada aparezca en la descripción OpenAPI o que nadie añada discretamente una supresión en línea. Quince reglas ESLint propias mantienen los patrones del proyecto en TypeScript. Una regla merece mencionarse por separado: cualquier commit con prefijo fix: debe incluir una prueba que falle sin la corrección, lo que proporciona una comprobación ejecutable de esa regresión. Y como un control averiado es peor que ninguno — lo aprueba todo sin que nadie lo descubra —, los controles tienen 146 pruebas propias.

Resultado. Las personas revisoras podían dedicar más tiempo al diseño porque las comprobaciones automáticas se ocupaban de las reglas mecánicas que codificaban antes de enviar la rama al remoto. La contrapartida es real y debe decirse: confirmar cambios es lento y trabajar alrededor de un control mal escrito puede resultar realmente exasperante. Esas 146 pruebas existen porque eso ocurrió.

  • Torre de observación, nieve, invierno
    Foto: schauhi / Pixabay
  • Curva de carretera, barrera de seguridad, postes delineadores
    Foto: Monsterkoi / Pixabay

Aplique esta experiencia a su proyecto

Utilice «Motor de 268 controles para el repositorio» como punto de partida para un reto similar en su organización. Los servicios que respaldan este trabajo están disponibles para su proyecto. Un agente conectado a los sistemas que utiliza, probado con casos definidos por sus especialistas, supervisado por su personal y sin depender de un único modelo.

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. Motor de 268 controles para el repositorio — 268 controles de commit y 146 pruebas de los propios controles

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 aplicar sus criterios de calidad automáticamente?

Pregunte por las decisiones detrás de «Motor de 268 controles para el repositorio». 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 Desarrollé el motor de comprobaciones del repositorio — 268 controles de commit registrados, 277 reglas de análisis estático y 15 reglas ESLint propias —, además de 146 pruebas de los propios controles, para que la compilación haga cumplir el criterio de calidad.
Llévese esta páginahttps://software.engineer.company/es/portfolio/built-a-268-check-guard-engine-for-the-repo/