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

پایتون ۲

وقتی پروژه‌های پایتون بزرگ‌تر می‌شوند، این کلمه‌ها همه‌جا هستند: در README، در مستندات کتابخانه‌ها و در اولین دستورهایی که برای راه انداختن یک پروژه می‌زنی.

which و that: توضیح پشت اسم

در مستندات زیاد می‌بینی که بعد از یک اسم، which یا that می‌آید و درباره‌اش توضیح می‌دهد: a generator that yields one line at a time یعنی «generatorی که هر بار یک خط می‌دهد». اگر قبل از which ویرگول باشد، فقط یک توضیح اضافه است: It uses a context manager, which closes the file.

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

decorator (دِکِرِیتِر): تابعی که دور تابع دیگر می‌پیچد و کاری به آن اضافه می‌کند

decorator در انگلیسی یعنی کسی که خانه را تزئین می‌کند: دیوار همان دیوار است، فقط چیزی به آن اضافه می‌شود. در پایتون decorator تابعی است که یک تابع دیگر را می‌گیرد، دورش یک لایه‌ی تازه می‌کشد و نتیجه را برمی‌گرداند، بی‌آن‌که کد خود تابع را عوض کنی. با @ بالای def می‌نشیند، مثل ‎@property یا ‎@app.route در Flask.

The @login_required decorator blocks users who are not logged in.

دکوریتور ‎@login_required جلوی کاربرهایی را که وارد نشده‌اند می‌گیرد.

generator (جِنِرِیتِر): تابعی که مقدارها را یکی‌یکی و وقت نیاز می‌سازد

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

This generator yields one line at a time, so the file never fills memory.

این generator هر بار یک خط می‌دهد، پس فایل هیچ‌وقت حافظه را پر نمی‌کند.

iterator (ایتِرِیتِر): چیزی که عضوها را یکی‌یکی با next می‌دهد

iterate یعنی «تکرار کردن» یا «یکی‌یکی جلو رفتن». iterator در پایتون شیئی است که می‌داند عضو بعدی کدام است: هر بار next را صدا بزنی یک عضو می‌دهد، و وقتی چیزی نماند خطای StopIteration می‌دهد. حلقه‌ی for پشت صحنه همین کار را می‌کند. iterator فقط رو به جلو می‌رود و برنمی‌گردد.

An iterator remembers where it stopped and gives the next item.

iterator یادش می‌ماند کجا ایستاده و عضو بعدی را می‌دهد.

iterable (ایتِرِبِل): هر چیزی که بشود رویش حلقه زد

پسوند ‎-able در انگلیسی یعنی «قابلِ…»، پس iterable یعنی «قابل پیمایش». به هر چیزی می‌گویند که بشود با for عضوهایش را یکی‌یکی دید: لیست، رشته، تاپل، دیکشنری، فایل و range. تابع‌هایی مثل sum، sorted، list و zip هم هر iterable را قبول می‌کنند. به‌عنوان اسم هم به کار می‌رود: an iterable.

TypeError: 'int' object is not iterable

خطای نوع: شیء int قابل پیمایش نیست.

context manager (کانتِکست مَنِجِر): چیزی که با with، آماده‌سازی و جمع کردن را خودش انجام می‌دهد

context یعنی «زمینه» یا «موقعیت» و manager یعنی «مدیر». context manager در پایتون شیئی است که با دستور with کار می‌کند: موقع ورود چیزی را آماده می‌کند و موقع خروج، حتی اگر وسط کار خطا رخ دهد، آن را جمع و تمیز می‌کند. رایج‌ترین مثالش open است که فایل را خودش می‌بندد.

Use open() as a context manager so the file is always closed.

از open به‌شکل context manager استفاده کن تا فایل همیشه بسته شود.

virtual environment (وِرچوئِل اِنوایرِنمِنت): محیط جدای پایتون برای هر پروژه

virtual یعنی «مجازی» و environment یعنی «محیط». virtual environment پوشه‌ای است که یک پایتون و کتابخانه‌های خودش را جدا از بقیه‌ی سیستم نگه می‌دارد. این‌طوری اگر یک پروژه نسخه‌ی ۲ یک کتابخانه را بخواهد و پروژه‌ی دیگر نسخه‌ی ۳ را، با هم دعوا نمی‌کنند. کوتاهش venv است.

Activate the virtual environment before you install the packages.

قبل از نصب بسته‌ها، محیط مجازی را فعال کن.

pip (پیپ): ابزار نصب کتابخانه‌های پایتون

pip مدیر بسته‌ی پایتون است: با یک دستور کتابخانه‌ای را که دیگران نوشته‌اند از سایت PyPI دانلود و نصب می‌کند، و می‌تواند آن را به‌روز یا حذف هم بکند. pip در انگلیسی معمولی یعنی «هسته‌ی کوچک میوه»، ولی این‌جا یک اسم است که برنامه‌نویس‌ها به شوخی می‌گویند یعنی pip installs packages.

Run pip install requests to add the library to your project.

دستور pip install requests را بزن تا این کتابخانه به پروژه‌ات اضافه شود.

standard library (اِستَندِرد لایبرِری): کتابخانه‌هایی که همراه خود زبان نصب می‌شوند

standard یعنی «استاندارد، همیشگی، معمولی». standard library مجموعه‌ی ماژول‌هایی است که با خود پایتون می‌آید و برای استفاده‌شان لازم نیست چیزی نصب کنی: math، random، json، datetime، os و ده‌ها تای دیگر. قبل از نصب یک کتابخانه‌ی بیرونی، ببین جوابت در standard library هست یا نه.

The json module is part of the standard library, so you do not need pip.

ماژول json بخشی از کتابخانه‌ی استاندارد است، پس pip لازم نداری.

بخش «شروع کار» در یک README

Getting started

First, create a virtual environment and activate it:

python -m venv .venv

Then install the packages with pip:

pip install -r requirements.txt

The app reads large log files with a generator, so it uses little memory. Every file is opened with a context manager, which closes it for you. We only use the standard library and two small packages. The main loop accepts any iterable of lines, so you can also pass a list in your tests.

شروع کار

اول یک محیط مجازی بساز و فعالش کن:

python -m venv .venv

بعد بسته‌ها را با pip نصب کن:

pip install -r requirements.txt

این اپ فایل‌های لاگ بزرگ را با یک generator می‌خواند، برای همین حافظه‌ی کمی مصرف می‌کند. هر فایل با یک context manager باز می‌شود که خودش آن را برایت می‌بندد. ما فقط از کتابخانه‌ی استاندارد و دو بسته‌ی کوچک استفاده می‌کنیم. حلقه‌ی اصلی هر iterableی از خط‌ها را قبول می‌کند، پس در تست‌هایت می‌توانی یک لیست هم بدهی.