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

وضعیت یک قابلیت

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

صفت‌هایی با able، al و ed

بیشتر صفت‌های این درس با یک پسوند ساخته شده‌اند. able و ible یعنی «شدنی»: available (در دسترس)، compatible (سازگار)، readable (خوانا). al از اسم صفت می‌سازد: experiment ← experimental. ed شکل سوم فعل را صفت می‌کند: supported یعنی «پشتیبانی‌شده». این صفت‌ها بعد از is می‌آیند: «It is supported».

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

available (اَوِیلِبِل): در دسترس؛ موجود

available یعنی چیزی که هست و می‌توانی از آن استفاده کنی. در مستندات می‌گوید یک قابلیت کجا و از کِی وجود دارد: «available in version 3.10 and later» یعنی از نسخه‌ی ۳٫۱۰ به بعد هست، «available on Windows only» یعنی فقط روی ویندوز. اگر چیزی available نباشد، یا هنوز نیامده یا روی سیستم تو نیست.

This feature is available in version 3.10 and later.

این قابلیت در نسخه‌ی ۳٫۱۰ و بعد از آن در دسترس است.

compatible (کِمپَتِبِل): سازگار

compatible یعنی دو چیز بدون دردسر با هم کار می‌کنند، مثل شارژری که به گوشی‌ات می‌خورد. الگوی جمله: «X is compatible with Y» یعنی «X با Y سازگار است». قبل از نصب هر کتابخانه خوب است ببینی با نسخه‌ی پایتون یا مرورگر تو compatible هست یا نه.

This plugin is compatible with all modern browsers.

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

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

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

Python 3.7 is no longer supported by this library.

این کتابخانه دیگر از پایتون ۳٫۷ پشتیبانی نمی‌کند.

experimental (ایکسپِریمِنتال): آزمایشی

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

This API is experimental and may change in the future.

این API آزمایشی است و ممکن است در آینده عوض شود.

legacy (لِگِسی): قدیمی و به‌ارث‌رسیده

legacy در انگلیسی یعنی «میراث»، چیزی که از گذشته به ما رسیده است. در برنامه‌نویسی به روش، کد یا سیستمی می‌گویند که قدیمی است و راه تازه‌تری جایش آمده، ولی هنوز نگهش داشته‌اند چون خیلی‌ها به آن وابسته‌اند. وقتی مستندات کنار چیزی نوشته Legacy، یعنی هنوز کار می‌کند ولی برای کار تازه سراغش نرو.

This is a legacy API; use the new client for new projects.

این یک API قدیمی است؛ برای پروژه‌های تازه از کلاینت جدید استفاده کن.

read-only (رید اُنلی): فقط‌خواندنی

only یعنی «فقط». read-only یعنی چیزی که فقط می‌توانی بخوانی‌اش و اجازه‌ی عوض کردنش را نداری. یک فایل، یک ویژگیِ شیء یا یک پایگاه داده می‌تواند read-only باشد. مثل تابلوی اعلانات پشت شیشه: می‌خوانی، ولی نمی‌توانی رویش بنویسی. اگر بخواهی چیزی را در آن بنویسی خطا می‌گیری.

The id property is read-only and cannot be changed.

ویژگی id فقط‌خواندنی است و نمی‌شود عوضش کرد.

case-sensitive (کِیس سِنسِتیو): حساس به حروف بزرگ و کوچک

case این‌جا یعنی «بزرگ یا کوچک بودن حرف» (uppercase و lowercase) و sensitive یعنی «حساس». وقتی چیزی case-sensitive است، Name و name و NAME برایش سه چیز جدا هستند. اسم متغیرها در پایتون و JavaScript، رمزهای عبور و اسم فایل‌ها در لینوکس همین‌طورند. برعکسش case-insensitive است.

Passwords are case-sensitive, so check your Caps Lock key.

رمزهای عبور به حروف بزرگ و کوچک حساس‌اند، پس کلید Caps Lock را نگاه کن.

backward compatible (بَک‌وِرد کِمپَتِبِل): سازگار با نسخه‌های قبلی

backward یعنی «رو به عقب». نسخه‌ی تازه وقتی backward compatible است که کدهای نوشته‌شده برای نسخه‌ی قبلی، بدون هیچ تغییری با آن هم کار کنند. یعنی می‌توانی با خیال راحت upgrade کنی. اگر نسخه‌ای این‌طور نباشد، در changelog می‌نویسند breaking change دارد.

Version 2.1 is fully backward compatible with version 2.0.

نسخه‌ی ۲٫۱ کاملاً با نسخه‌ی ۲٫۰ سازگار است.

جدول وضعیت قابلیت‌ها

Feature status

Sync: available in version 2.0 and later. Supported on Windows, macOS and Linux.

Voice input: experimental. It may change or be removed at any time.

XML export: legacy. It still works, but new projects should use JSON export.

History: read-only. You can view old versions, but you cannot edit them.

Note: file names are case-sensitive, so "Notes.txt" and "notes.txt" are two different files.

Version 2.4 is backward compatible with all 2.x versions and compatible with Python 3.9+.

وضعیت قابلیت‌ها

همگام‌سازی: در نسخه‌ی ۲٫۰ و بعد از آن در دسترس است. روی ویندوز، macOS و لینوکس پشتیبانی می‌شود.

ورودی صوتی: آزمایشی. ممکن است هر لحظه عوض یا حذف شود.

خروجی XML: قدیمی. هنوز کار می‌کند، ولی پروژه‌های تازه بهتر است از خروجی JSON استفاده کنند.

تاریخچه: فقط‌خواندنی. می‌توانی نسخه‌های قدیمی را ببینی، ولی نمی‌توانی ویرایششان کنی.

نکته: اسم فایل‌ها به حروف بزرگ و کوچک حساس است، پس «Notes.txt» و «notes.txt» دو فایل جدا هستند.

نسخه‌ی ۲٫۴ با همه‌ی نسخه‌های ‎2.x سازگار است و با پایتون ۳٫۹ به بالا هم کار می‌کند.