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

قدیمی و ناسازگار

نرم‌افزارها مدام عوض می‌شوند: چیزهایی قدیمی می‌شوند، نسخه‌ها با هم نمی‌سازند، چیزی دو بار می‌آید. این هشت صفت را بیشتر در هشدارها و موقع نصب و به‌روزرسانی می‌بینی.

الگوی «X is deprecated. Use Y instead.»

هشدارهای قدیمی‌شدن تقریباً همیشه دو جمله دارند. اولی می‌گوید چه چیزی کنار رفته: X is deprecated. دومی یک جمله‌ی امری است و جایگزین را می‌گوید: Use Y instead. کلمه‌ی instead یعنی «به‌جایش» و معمولاً آخر جمله می‌آید. پس هر جا instead دیدی، راه‌حل درست قبل از آن نوشته شده است.

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

deprecated (دِپرِکِیتِد): منسوخ؛ هنوز کار می‌کند ولی به‌زودی برداشته می‌شود

deprecated یعنی سازنده‌های یک زبان یا کتابخانه گفته‌اند: «این تابع یا روش قدیمی شده؛ دیگر از آن استفاده نکنید، چون در نسخه‌های بعد برش می‌داریم.» فعلاً کار می‌کند و فقط هشدار می‌دهد. مثل مغازه‌ای که تابلو زده «تا آخر ماه تعطیل می‌شویم». پیام معمولاً جایگزین را هم می‌گوید: use … instead.

This function is deprecated; use the new one instead.

این تابع منسوخ شده است؛ به‌جایش از تابع تازه استفاده کن.

obsolete (آبسولیت): ازرده‌خارج؛ دیگر به کار نمی‌رود

obsolete یعنی چیزی که دوره‌اش تمام شده و چیز بهتری جایش را گرفته، مثل نوار کاست یا فلاپی‌دیسک. یک قدم جلوتر از deprecated است: deprecated یعنی «دارد کنار می‌رود»، obsolete یعنی «کنار رفته است». تگ یا تابع obsolete شاید هنوز این‌جا و آن‌جا کار کند، ولی نباید رویش حساب کنی.

The center tag is obsolete; use CSS to center the text.

تگ center از رده خارج شده؛ برای وسط‌چین کردن متن از CSS استفاده کن.

unsupported (آن‌ساپورتِد): پشتیبانی‌نشده

support یعنی پشتیبانی کردن. وقتی می‌گویند برنامه‌ای چیزی را support می‌کند، یعنی بلد است با آن کار کند. unsupported یعنی «این را بلد نیستم»: قالب فایلی که برنامه نمی‌شناسد، نسخه‌ای از پایتون که کتابخانه برایش ساخته نشده، یا عملگری که برای این نوع داده معنی ندارد.

This file format is unsupported; please upload a PNG or JPG image.

این قالب فایل پشتیبانی نمی‌شود؛ لطفاً یک عکس PNG یا JPG بفرست.

incompatible (این‌کامپَتِبِل): ناسازگار؛ با هم جور نیستند

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

This plugin is incompatible with the latest version of the editor.

این افزونه با تازه‌ترین نسخه‌ی ادیتور ناسازگار است.

mismatch (میس‌مَچ): ناهمخوانی؛ دو چیز که باید یکی باشند و نیستند

match یعنی جور بودن و mis- یعنی «غلط»: mismatch یعنی ناهمخوانی. کامپیوتر دو چیز را کنار هم گذاشته که باید برابر یا هم‌اندازه باشند و نیستند: type mismatch (نوع‌ها یکی نیستند)، length mismatch (طول‌ها یکی نیستند)، password mismatch (رمز و تکرارش فرق دارند). پیام معمولاً هر دو طرف را نشان می‌دهد.

There is a mismatch between the two passwords you entered.

دو رمزی که وارد کرده‌ای با هم نمی‌خوانند.

duplicate (دوپلیکِت): تکراری؛ نسخه‌ی دوم از همان چیز

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

Remove the duplicate items from the list before you sort it.

قبل از مرتب کردن فهرست، عضوهای تکراری را از آن بردار.

ambiguous (اَمبیگیواِس): مبهم؛ دوپهلو

ambiguous یعنی چیزی که دو جور می‌شود فهمیدش. آدم‌ها در این حالت حدس می‌زنند، ولی کامپیوتر حدس نمی‌زند: می‌ایستد و می‌پرسد «منظورت کدام بود؟» مثلاً اسم ستونی را نوشته‌ای که در دو جدول هست، یا اسمی به گیت داده‌ای که هم می‌تواند شاخه باشد و هم فایل. راهش این است که دقیق‌تر بگویی.

The name is ambiguous because two files have the same name.

این اسم مبهم است، چون دو فایل یک اسم دارند.

redundant (ریداندِنت): زائد؛ اضافه و بی‌فایده

redundant یعنی چیزی که بودن و نبودنش فرقی نمی‌کند، چون همان کار جای دیگری انجام شده است: پرانتز اضافه، شرطی که همیشه درست است، خطی که دو بار نوشته شده. این خطا نیست؛ ابزارهای بررسی کد (linter) آن را گوشزد می‌کنند تا کدت تمیزتر شود. در سرورها معنی خوبی هم دارد: نسخه‌ی یدکی، برای روز خرابی.

This check is redundant because the value is never empty.

این بررسی زائد است، چون مقدار هیچ‌وقت خالی نیست.

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

Upgrade notes for version 3.0

- The function get_user() is deprecated. Use fetch_user() instead. The old name still works, but it shows a warning.
- The old XML format is obsolete and was removed.
- Python 3.7 is unsupported now. You need 3.9 or newer.
- Plugins made for version 2 are incompatible with this version.
- We removed a duplicate setting: timeout and time_limit did the same job, so one of them was redundant.
- If you see "version mismatch", update both the app and the plugin.

یادداشت‌های به‌روزرسانی به نسخه‌ی 3.0

- تابع get_user()‎ منسوخ شده است. به‌جایش از fetch_user()‎ استفاده کن. اسم قدیمی هنوز کار می‌کند، ولی هشدار می‌دهد.
- قالب قدیمی XML از رده خارج است و برداشته شد.
- پایتون 3.7 دیگر پشتیبانی نمی‌شود. نسخه‌ی 3.9 یا تازه‌تر لازم است.
- افزونه‌هایی که برای نسخه‌ی ۲ ساخته شده‌اند با این نسخه ناسازگارند.
- یک تنظیم تکراری را برداشتیم: timeout و time_limit یک کار می‌کردند، پس یکی‌شان زائد بود.
- اگر پیام «version mismatch» را دیدی، هم برنامه و هم افزونه را به‌روز کن.