سرفصل‌ها درس 118 از 148 · ابزارهایتان را اختراع کنید
ابزارهایتان را اختراع کنید

یک خلاصه‌گر ریسک diff

چرا مهم است بازبین‌ها سرسری می‌خوانند. یک خلاصهٔ یک‌خطی بالای یک pull request («به یک migration دست می‌زند، آزمون‌ها را ضعیف می‌کند») به آن‌ها می‌گوید کجا آهسته کنند، و هر بار یکی است، برخلاف درخواست از یک گفت‌وگو برای «بازبینی این diff».

تیم شما قاعده‌های بازبینی‌اش را نوشته و ابزاری می‌خواهد که آن‌ها را روی یک unified diff (خروجی git diff) اعمال کند. هر فایل در diff بخشی است که با یک خط diff --git a/OLD b/NEW شروع می‌شود. خط‌های سرآیند پس از آن می‌آیند (index، ---، +++، new file mode، deleted file mode، rename from/to، similarity index، Binary files ... differ). پس از نخستین خط @@ یک بخش، هر خط محتواست: + افزوده، - حذف‌شده، یک فاصله برای زمینه.

diffهای واقعی از نمونهٔ کتاب درسی آشفته‌ترند. یک تغییر نام خالص هیچ خط ---/+++ و هیچ محتوایی ندارد. یک فایل دودویی هیچ‌کدام را ندارد. خط +++ یک فایل حذف‌شده /dev/null می‌گوید. و یک توضیح SQL حذف‌شده، -- old note، در diff به شکل --- old note ظاهر می‌شود.

نوبت شما

risk_summary(diff) را بنویسید. مسیر یک فایل NEW از خط diff --git آن است، یا OLD اگر بخش یک خط deleted file mode داشته باشد. مسیرها فاصله ندارند. یک dict از دسته به فهرست مرتب مسیرهای آن برگردانید (دسته‌های خالی را کنار بگذارید):

  • 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 را به کار می‌برند، همان‌طور که بالا توصیف شد.

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.