Programma Lezione 118 di 148 · Inventa i tuoi strumenti
Inventa i tuoi strumenti

Un riassunto dei rischi di un diff

Perché è importante I revisori leggono di corsa. Un riassunto di una riga in cima a una pull request ("tocca una migrazione, indebolisce i test") dice loro dove rallentare, ed è uguale ogni volta, a differenza di chiedere a una chat di "rivedere questo diff".

Il tuo team mette per iscritto le sue regole di revisione e vuole uno strumento che le applichi a un diff unificato (l'output di git diff). Ogni file nel diff è una sezione che inizia con una riga diff --git a/OLD b/NEW. Seguono righe di intestazione (index, ---, +++, new file mode, deleted file mode, rename from/to, similarity index, Binary files ... differ). Dopo la prima riga @@ di una sezione, ogni riga è contenuto: + aggiunta, - tolta, uno spazio per il contesto.

I diff veri sono più disordinati di quello da manuale. Un puro cambio di nome non ha righe ---/+++ e nessun contenuto. Un file binario non ha né le une né l'altro. La riga +++ di un file cancellato dice /dev/null. E un commento SQL tolto, -- old note, compare nel diff come --- old note.

Tocca a te

Scrivi risk_summary(diff). Il percorso di un file è NEW dalla sua riga diff --git, o OLD se la sezione ha una riga deleted file mode. I percorsi non hanno spazi. Restituisci un dict dalla categoria alla lista ordinata dei percorsi che contiene (lascia fuori le categorie vuote):

  • schema: una cartella nel percorso si chiama migrations, o il nome del file finisce con .sql.
  • secrets: una riga aggiunta contiene password, secret, api_key o token, con qualsiasi maiuscola.
  • tests-weakened: un file di test (il nome inizia con test_, o una cartella si chiama tests) che viene cancellato, o che ha più righe tolte che aggiunte contenenti assert.
  • dependencies: il nome del file è requirements.txt, pyproject.toml, package.json o package-lock.json.
  • config: il nome del file finisce con .yml, .yaml, .ini o .env, oppure è settings.py.
Trappola da battere: i test usano cambi di nome, file binari, file cancellati e nuovi, e commenti SQL, come descritto sopra.

Hai notato un problema in questa lezione? Segnalalo · Chiedi qualcosa su questa lezione

Questo esercizio si apre presto

Finisci la lezione precedente e questa si sblocca. L'intero corso è gratuito, senza account, e puoi leggere questa lezione subito.