Programme Leçon 118 sur 148 · Invente tes outils
Invente tes outils

Un résumeur de risques de diff

Pourquoi c'est important Les relecteurs survolent. Un résumé d'une ligne en haut d'une pull request (« touche une migration, affaiblit les tests ») leur dit où ralentir, et il est le même à chaque fois, contrairement à demander à une discussion de « relire ce diff ».

Ton équipe met par écrit ses règles de relecture et veut un outil qui les applique à un diff unifié (la sortie de git diff). Chaque fichier du diff est une section qui commence par une ligne diff --git a/OLD b/NEW. Des lignes d'en-tête suivent (index, ---, +++, new file mode, deleted file mode, rename from/to, similarity index, Binary files ... differ). Après la première ligne @@ d'une section, chaque ligne est du contenu : + ajoutée, - retirée, une espace pour le contexte.

Les vrais diffs sont plus désordonnés que celui des manuels. Un simple renommage n'a pas de lignes ---/+++ ni de contenu. Un fichier binaire n'a ni l'un ni l'autre. La ligne +++ d'un fichier supprimé dit /dev/null. Et un commentaire SQL retiré, -- old note, apparaît dans le diff comme --- old note.

À ton tour

Écris risk_summary(diff). Le chemin d'un fichier est NEW tiré de sa ligne diff --git, ou OLD si la section a une ligne deleted file mode. Les chemins n'ont pas d'espaces. Renvoie un dict de la catégorie vers la liste triée des chemins qu'elle contient (laisse de côté les catégories vides) :

  • schema : un dossier du chemin s'appelle migrations, ou le nom du fichier finit par .sql.
  • secrets : une ligne ajoutée contient password, secret, api_key ou token, quelle que soit la casse.
  • tests-weakened : un fichier de test (le nom commence par test_, ou un dossier s'appelle tests) qui est supprimé, ou qui a plus de lignes retirées qu'ajoutées contenant assert.
  • dependencies : le nom du fichier est requirements.txt, pyproject.toml, package.json ou package-lock.json.
  • config : le nom du fichier finit par .yml, .yaml, .ini ou .env, ou est settings.py.
Piège à battre : les tests utilisent des renommages, des fichiers binaires, des fichiers supprimés et nouveaux, et des commentaires SQL, comme décrit ci-dessus.

Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon

Cet exercice s'ouvre bientôt

Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.