シラバス レッスン 148 中 118 · 道具を発明する
道具を発明する

差分の危険のまとめ

なぜ大切か レビューする人は流し読みします。プルリクエストの一番上の 1 行のまとめ(「移行に触れ、テストを弱める」)は、どこで速度を落とすかを教え、チャットに「この差分をレビューして」と頼むのと違って毎回同じです。

チームはレビューの規則を書き留めていて、それをユニファイド形式の差分(git diff の出力)に当てはめる道具を求めています。差分のそれぞれのファイルは、diff --git a/OLD b/NEW の行で始まる部分です。見出しの行が続きます(index、---、+++、new file mode、deleted file mode、rename from/to、similarity index、Binary files ... differ)。部分の最初の @@ の行のあとは、どの行も中身です:+ は追加、- は削除、空白は文脈。

本物の差分は教科書のものより散らかっています。純粋な名前の変更には ---/+++ の行も中身もありません。バイナリのファイルにはどちらもありません。削除したファイルの +++ の行は /dev/null と言います。そして取り除かれた SQL のコメント -- old note は、差分の中で --- old note として現れます。

あなたの番

risk_summary(diff) を書いてください。ファイルのパスは、その diff --git の行の NEW、または部分に deleted file mode の行があれば OLD です。パスに空白はありません。分類から、それに入るパスの並べたリストへの辞書を返します(空の分類は省く):

  • schema:パスの中のディレクトリが migrations という名前か、ファイル名が .sql で終わる。
  • secrets:加えた 行が、大文字小文字を問わず password、secret、api_key、token を含む。
  • tests-weakened:テストのファイル(名前が test_ で始まるか、ディレクトリが tests という名前)で、削除されたか、assert を含む行の削除が追加より多い。
  • dependencies:ファイル名が requirements.txt、pyproject.toml、package.json、package-lock.json。
  • config:ファイル名が .yml、.yaml、.ini、.env で終わるか、settings.py。
破るべき罠:テストは、上で説明したとおり、名前の変更、バイナリのファイル、削除したファイルと新しいファイル、SQL のコメントを使います。

このレッスンに問題を見つけましたか?報告する · このレッスンについて質問する

この演習はまもなく開きます

その前のレッスンを終えると、このレッスンが解放されます。コース全体が無料でアカウントも不要、このレッスンは今すぐ読めます。