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

با خطا چه کنیم

پیام خطا را خواندی؛ حالا چه؟ این هشت فعل کارهایی‌اند که می‌شود با یک خطا کرد، و اسم دکمه‌هایی که زیر پیام‌ها می‌بینی: Retry، ‏Ignore، ‏Skip، ‏Cancel.

جمله‌ی امری: فعل اول جمله

وقتی کامپیوتر یا مستندات می‌خواهند بگویند «این کار را بکن»، جمله را با خودِ فعل شروع می‌کنند، بدون you: Fix conflicts and then commit. با Please مؤدبانه‌تر می‌شود: Please commit your changes. منفی‌اش با Do not ساخته می‌شود: Do not ignore this warning. دکمه‌ها هم همین‌طورند: Retry، ‏Cancel، ‏Skip.

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

fix (فیکس): درست کردن؛ تعمیر کردن

fix یعنی تعمیر کردن، مثل درست کردن دوچرخه‌ی خراب. در برنامه‌نویسی یعنی باگ یا خطا را برطرف کردن. اسم هم هست: a fix یعنی «یک راهِ درست کردن». هر روز در پیام‌های commit می‌بینی‌اش: Fix login bug. بعضی ابزارها هم گزینه‌ای به همین اسم دارند که خودشان اشتباه‌های ساده را درست می‌کنند.

I fixed the bug, and now all the tests pass.

باگ را درست کردم و حالا همه‌ی تست‌ها قبول می‌شوند.

solve (سالْو): حل کردن

solve یعنی حل کردن: جواب یک مسئله را پیدا کردن. فرقش با fix ظریف است: چیزِ خراب را fix می‌کنی، ولی مسئله یا مشکل را solve می‌کنی. اسمش solution است، یعنی راه‌حل. در انجمن‌ها کنار سؤال‌هایی که جواب گرفته‌اند می‌نویسند Solved، یعنی «حل شد».

Restarting the editor solved the problem for me.

برای من، دوباره باز کردن ادیتور مشکل را حل کرد.

resolve (ریزالْو): برطرف کردن؛ (اسم یا نشانی را) پیدا کردن

resolve دو معنی دارد. اول، چیزی نزدیک به solve: یک اختلاف یا مشکل را تمام کردن؛ resolve a conflict یعنی تداخل گیت را برطرف کردن، و در GitHub روی گفت‌وگوی تمام‌شده می‌زنند Resolved. دوم، در خطاها: یک اسم را به جای واقعی‌اش رساندن. Could not resolve host یعنی «نتوانستم نشانی این سایت را پیدا کنم».

Please resolve the merge conflict before you push again.

لطفاً قبل از این‌که دوباره push کنی، تداخل ادغام را برطرف کن.

retry (ری‌تْرای): دوباره امتحان کردن

re- یعنی «دوباره» و try یعنی امتحان کردن: retry یعنی دوباره امتحان کردن. بعضی خطاها موقتی‌اند، مثل قطع شدن یک‌لحظه‌ای اینترنت، و با یک بار دیگر امتحان کردن برطرف می‌شوند. برنامه‌های خوب خودشان چند بار retry می‌کنند و بعد تسلیم می‌شوند. دکمه‌ی Retry را هم زیر خیلی از پیام‌های خطا دیده‌ای.

The request failed, so the app will retry in five seconds.

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

ignore (ایگنور): نادیده گرفتن

ignore یعنی نادیده گرفتن: چیزی را ببینی و کاری به کارش نداشته باشی. فایل ‎.gitignore فهرست چیزهایی است که گیت باید نادیده بگیرد. در پیام‌ها ignoring یعنی «این یکی را کنار گذاشتم و ادامه دادم». یک توصیه: warning را شاید بشود مدتی ignore کرد، ولی error را نه.

Do not ignore this warning; it will become an error soon.

این هشدار را نادیده نگیر؛ به‌زودی به خطا تبدیل می‌شود.

skip (اِسکیپ): رد شدن از چیزی؛ پریدن از روی آن

skip یعنی از روی چیزی پریدن و سراغ بعدی رفتن، مثل رد کردن تبلیغ اول ویدیو. در کد یعنی یک مرحله را انجام ندهی: یک تست، یک فایل، یک دور از حلقه. فرقش با ignore: در skip اصلاً سراغ آن کار نمی‌روی؛ در ignore چیزی را می‌بینی و به آن اهمیت نمی‌دهی.

You can skip this step if Python is already installed.

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

abort (اَبورت): نیمه‌کاره متوقف کردن و دست کشیدن

abort یعنی کاری را که شروع شده وسط راه رها کردن، چون ادامه دادنش خطرناک یا بی‌فایده است؛ مثل هواپیمایی که وسط باند از پرواز منصرف می‌شود. وقتی برنامه می‌نویسد Aborting، یعنی «برای این‌که چیزی خراب نشود، ادامه نمی‌دهم». در گیت با ‎--abort می‌توانی یک merge یا rebase نیمه‌کاره را به حالت قبل برگردانی.

The installer will abort if there is not enough disk space.

اگر فضای کافی روی دیسک نباشد، برنامه‌ی نصب کار را رها می‌کند.

cancel (کَنسِل): لغو کردن

cancel یعنی لغو کردن: از کاری که قرار بود انجام شود یا دارد انجام می‌شود منصرف شوی. دکمه‌ی Cancel کنار OK در بیشتر پنجره‌ها هست. فرقش با abort: cancel را معمولاً آدم با خواست خودش انجام می‌دهد؛ abort را بیشتر برنامه، وقتی مشکلی می‌بیند. در ترمینال، Ctrl+C کارِ در حال اجرا را لغو می‌کند.

Press Ctrl+C to cancel the download.

برای لغو دانلود، Ctrl+C را بزن.

گیت می‌گوید: تداخل!

Auto-merging app.py
CONFLICT (content): Merge conflict in app.py
Automatic merge failed; fix conflicts and then commit the result.

Git could not solve this alone: two people changed the same line. You have two choices. To resolve the conflict, open app.py, choose the right lines, and commit. To cancel the merge, run git merge --abort; everything goes back.

Do not ignore the message, and do not skip the tests after the fix. If the push fails because of the network, just retry.

Auto-merging app.py
CONFLICT (content): Merge conflict in app.py
ادغام خودکار شکست خورد؛ تداخل‌ها را درست کن و بعد نتیجه را commit کن.

گیت نتوانست این را تنهایی حل کند: دو نفر یک خط را عوض کرده‌اند. دو راه داری. برای برطرف کردن تداخل، app.py را باز کن، خط‌های درست را انتخاب کن و commit کن. برای لغو ادغام، git merge --abort را اجرا کن؛ همه‌چیز به حالت قبل برمی‌گردد.

پیام را نادیده نگیر و بعد از درست کردن هم از تست‌ها رد نشو. اگر push به خاطر شبکه شکست خورد، فقط دوباره امتحان کن.