Temario Lección 118 de 148 · Inventa tus herramientas
Inventa tus herramientas

Un resumidor de riesgos de diffs

Por qué importa Quien revisa lee por encima. Un resumen de una línea al principio de un pull request ("toca una migración, debilita las pruebas") le dice dónde ir más despacio, y es igual cada vez, a diferencia de pedir a un chat que "revise este diff".

Tu equipo ha escrito sus reglas de revisión y quiere una herramienta que las aplique a un diff unificado (la salida de git diff). Cada archivo del diff es una sección que empieza con una línea diff --git a/OLD b/NEW. Siguen las líneas de cabecera (index, ---, +++, new file mode, deleted file mode, rename from/to, similarity index, Binary files ... differ). Después de la primera línea @@ de una sección, cada línea es contenido: + añadida, - quitada, un espacio para el contexto.

Los diffs reales son más desordenados que el de manual. Un cambio de nombre puro no tiene líneas ---/+++ ni contenido. Un archivo binario no tiene ninguna de las dos. La línea +++ de un archivo borrado dice /dev/null. Y un comentario SQL quitado, -- old note, aparece en el diff como --- old note.

Tu turno

Escribe risk_summary(diff). La ruta de un archivo es NEW de su línea diff --git, u OLD si la sección tiene una línea deleted file mode. Las rutas no tienen espacios. Devuelve un diccionario de categoría a la lista ordenada de rutas que contiene (deja fuera las categorías vacías):

  • schema: una carpeta de la ruta se llama migrations, o el nombre del archivo termina en .sql.
  • secrets: una línea añadida contiene password, secret, api_key o token, en mayúsculas o minúsculas.
  • tests-weakened: un archivo de prueba (el nombre empieza por test_, o una carpeta se llama tests) que se borra, o que tiene más líneas quitadas que añadidas que contengan assert.
  • dependencies: el nombre del archivo es requirements.txt, pyproject.toml, package.json o package-lock.json.
  • config: el nombre del archivo termina en .yml, .yaml, .ini o .env, o es settings.py.
Trampa que vencer: las pruebas usan cambios de nombre, archivos binarios, archivos borrados y nuevos, y comentarios SQL, como se describe arriba.

¿Has visto un problema en esta lección? Avísanos · Preguntar sobre esta lección

Este ejercicio se abre pronto

Termina la lección anterior y esta se desbloquea. Todo el curso es gratis, no hace falta cuenta, y puedes leer esta lección ahora mismo.