بتل کد Battle Codeدارد باز می‌شود…

ابزار تست

وقتی تست‌ها زیاد می‌شوند، ابزار لازم داری: چیزی که آن‌ها را اجرا کند، داده‌ی آماده بدهد و سرویس‌های واقعی را با نسخه‌ی ساختگی عوض کند. و باید بدانی هر هشداری واقعی نیست.

false و true جلوی اسم

false و true می‌توانند مثل صفت جلوی اسم بیایند: a false alarm (هشدار بی‌جا)، a true story (داستان واقعی). در false positive هم false صفت است و positive (به عنوان اسم) یعنی «جواب مثبت». ترتیب عوض نمی‌شود: هیچ‌وقت positive false نمی‌گویند.

هشت کلمه‌ی این درس

fixture (فیکسچِر): چیزهای آماده‌ای که تست قبل از شروع لازم دارد

fixture در انگلیسی یعنی چیزی که در جایش ثابت و نصب شده، مثل لوستر و شیر آب خانه که با خانه فروخته می‌شوند. در تست، fixture آماده‌سازی ثابتی است که چند تست لازم دارند: یک کاربر نمونه، یک پایگاه داده‌ی خالی، یک فایل آزمایشی. به جای این‌که در هر تست از نو بسازی‌اش، یک بار fixture را تعریف می‌کنی و ابزار تست آن را به هر تستی که خواست می‌دهد.

Use the user fixture to get a logged-in test user.

از fixture کاربر استفاده کن تا یک کاربر آزمایشی واردشده بگیری.

stub (اِستاب): جایگزین ساده‌ای که همیشه یک جواب ثابت برمی‌گرداند

stub در انگلیسی یعنی ته‌مانده‌ی کوتاه چیزی: ته بلیت که بعد از پاره کردن دستت می‌ماند، یا ته مداد. در تست، stub یک نسخه‌ی کوتاه و ساختگی از یک تابع یا سرویس است که هیچ کار واقعی نمی‌کند و فقط یک جواب ثابت برمی‌گرداند. مثلا به جای صدا زدن سرویس واقعی آب‌وهوا، stub همیشه می‌گوید «۲۰ درجه، آفتابی». این‌طور تست سریع و قابل پیش‌بینی می‌ماند.

We replaced the payment service with a stub that always returns success.

سرویس پرداخت را با یک stub عوض کردیم که همیشه موفقیت برمی‌گرداند.

test runner (تِست رانِر): برنامه‌ای که تست‌ها را پیدا و اجرا می‌کند و نتیجه را می‌گوید

runner یعنی کسی یا چیزی که run می‌کند، اجرا می‌کند. test runner ابزاری است که فایل‌های تست را پیدا می‌کند، تک‌تک تست‌ها را اجرا می‌کند و در آخر گزارش می‌دهد چند تا رد شدند و چند تا شکست خوردند. pytest در پایتون و Jest و Vitest در جاوااسکریپت test runnerهای معروف‌اند. مثل داوری که مسابقه‌ها را یکی‌یکی برگزار می‌کند و جدول نتیجه را اعلام می‌کند.

Configure the test runner to stop after the first failure.

test runner را طوری تنظیم کن که بعد از اولین شکست بایستد.

test-driven development (تِست دریوِن دِوِلِپمِنت): توسعه‌ی تست‌محور؛ اول تست را بنویس، بعد کد را

driven یعنی «رانده‌شده» یا «هدایت‌شده»؛ test-driven یعنی کاری که تست آن را جلو می‌برد. در این روش اول تستی می‌نویسی که هنوز شکست می‌خورد (قرمز)، بعد کمترین کد لازم را می‌نویسی تا رد شود (سبز)، و بعد کد را تمیز می‌کنی (refactor). این چرخه‌ی کوچک را بارها تکرار می‌کنی. مثل این‌که قبل از ساختن کلید، اول قفل را بسازی.

In test-driven development, you write a failing test before any real code.

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

snapshot (اِسنَپ‌شات): عکس فوری؛ وضعیت ذخیره‌شده‌ی چیزی در یک لحظه

snapshot در انگلیسی یعنی عکسی که سریع و بی‌مقدمه گرفته می‌شود. در برنامه‌نویسی یعنی وضعیت دقیق چیزی در یک لحظه که ذخیره شده است. در تست، snapshot test خروجی (مثلا HTML یک کامپوننت) را یک بار ذخیره می‌کند و دفعه‌های بعد خروجی تازه را با آن مقایسه می‌کند؛ هر فرقی یعنی چیزی عوض شده. در سرورها و ماشین‌های مجازی هم snapshot یعنی کپی کامل دیسک در یک لحظه برای برگشتن به آن.

The snapshot does not match because the button text changed.

snapshot نمی‌خواند چون متن دکمه عوض شده است.

dry run (درای ران): اجرای آزمایشی؛ نشان دادن کار بدون انجام واقعی آن

dry یعنی خشک. می‌گویند اسمش از تمرین آتش‌نشان‌ها آمده: همه‌ی کارها را انجام می‌دادند ولی آب را باز نمی‌کردند. در برنامه‌نویسی dry run یعنی دستوری را اجرا کنی که فقط بگوید «اگر واقعا اجرا می‌شدم این کارها را می‌کردم»، بدون این‌که چیزی را واقعا پاک یا عوض یا ارسال کند. قبل از هر کار خطرناک (پاک کردن، انتشار، deploy) اول dry run بگیر.

Always do a dry run before you delete files on the server.

همیشه قبل از پاک کردن فایل‌ها روی سرور یک اجرای آزمایشی بگیر.

false positive (فالس پازِتیو): مثبت کاذب؛ هشدار بی‌جا وقتی در واقع مشکلی نیست

false یعنی نادرست و positive یعنی «مثبت»، یعنی جواب «بله، پیدا کردم». false positive وقتی است که ابزار می‌گوید مشکلی هست ولی در واقع نیست؛ مثل دزدگیر ماشین که با رد شدن یک گربه آژیر می‌کشد. آنتی‌ویروسی که فایل سالم را ویروس می‌داند، linter که کد درست را غلط می‌گیرد، یا هشداری که نصف شب بی‌دلیل زنگ می‌زند، همه false positive هستند.

This warning is a false positive: the variable is used in another file.

این هشدار بی‌جاست؛ متغیر در فایل دیگری استفاده شده است.

false negative (فالس نِگِتیو): منفی کاذب؛ مشکلی که هست ولی ابزار آن را نمی‌بیند

negative یعنی جواب «نه، چیزی پیدا نکردم». false negative وقتی است که ابزار می‌گوید همه‌چیز خوب است ولی در واقع مشکلی هست؛ مثل دزدگیری که دزد واقعی را نمی‌بیند. تستی که همیشه سبز است حتی وقتی کد خراب است، یا اسکنری که آسیب‌پذیری را جا می‌اندازد، false negative می‌دهد. معمولا از false positive خطرناک‌تر است چون خیالت راحت می‌شود.

A test without an assertion can hide bugs and give a false negative.

تستی که هیچ assertion ندارد می‌تواند باگ‌ها را پنهان کند و منفی کاذب بدهد.

گفت‌وگو درباره‌ی یک تست عجیب

Sara: The test runner says test_checkout failed, but the code looks fine.
Ali: Is it a false positive? The test calls the real payment service.
Sara: Yes, and the service was slow today.
Ali: Replace it with a stub that always returns "paid". Put the test user in a fixture, too.
Sara: Good idea. Should I also update the snapshot?
Ali: Only if the page really changed. And next time, try test-driven development: write the test first.

سارا: test runner می‌گوید test_checkout شکست خورده، ولی کد درست به نظر می‌رسد.
علی: هشدار بی‌جا نیست؟ تست سرویس پرداخت واقعی را صدا می‌زند.
سارا: آره، و سرویس امروز کند بود.
علی: آن را با یک stub عوض کن که همیشه «پرداخت شد» برمی‌گرداند. کاربر آزمایشی را هم در یک fixture بگذار.
سارا: فکر خوبی است. snapshot را هم به‌روز کنم؟
علی: فقط اگر صفحه واقعا عوض شده. و دفعه‌ی بعد توسعه‌ی تست‌محور را امتحان کن: اول تست را بنویس.