ترجمه مستندات فلاسک(Flask)

سلام از چند روز پیش پروژه ترجمه گروهی مستندات فلاسک رو شروع کردیم و تا الان بخشی از مستندات ترجمه شده. هر چند به خاطر تعداد کم مترجمان فعال این کار خیلی کند پیش میره ولی داریم سعی میکنیم که متوقف نشه. این پروژه روی گیتهاب گذاشته شده و اگر مایل بودید میتونید یک بخش از مستندات رو ترجمه کنید.(صفحه گیت هاب). این متن مستقیما از گیت هاب کپی شده و اگر مشکلی داشت، لطفا اون رو تو گیت هاب اصلاح کنید.

اگر از این پست راضی بودید لایک کنید تا افراد بیشتری جذب این پروژه بشن.

ترجمه بخش نصب فلاسک:

نسخه پایتون

ما پیشنهاد میکنیم که از آخرین نسخه پایتون استفاده کنید. فلاسک از پایتون نسخه ۳.۶ و جدیدتر پشتیبانی میکند.

‌async در فلاسک به پایتون ۳.۹ یا بالاتر برای contextvars.ContextVar. نیاز دارد.

وابستگی ها

این توزیع ها به صورت خودکار هنگام نصب فلاسک، نصب میشوند.

• Werkzeug . رابط استاندارد پایتون بین برنامه‌ها و سرورها را پیاده‌سازی می‌کند.
• Jinja یک زبان قالب است که صفحاتی را که برنامه شما رندر میکند را ارائه میدهد.
• MarkupSafe با Jinja همراه است. هنگام رندر قالب ها برای جلوگیری از حملات XSS، از ورودی نامعتبرجلوگیری میکند.
• ItsDangerous داده ها را به صورت ایمن امضا می کند تا از یکپارچگی آن اطمینان حاصل کند. این برای محافظت از کوکی جلسه Flask استفاده می شود.
• Click چارچوبی برای نوشتن برنامه های خط فرمان است. این دستور «flask» را ارائه می دهد و اجازه می دهد تا دستورات مدیریت سفارشی را اضافه کنید.

وابستگی های اختیاری

این توزیع ها به صورت خودکار نصب نمی شوند. در صورت نصب فلاسک آنها را شناسایی و استفاده می کند.

• Blinker از Signals پشتیبانی می کند.
• python-dotenv پشتیبانی از Environment Variables From dotenv را هنگام اجرای دستورات flask فعال می کند.
• Watchdog یک بارگیری مجدد سریعتر و کارآمدتر برای سرور توسعه ارائه می دهد.

محیط های مجازی

از یک محیط مجازی برای مدیریت وابستگی های پروژه خود چه در توسعه و چه در تولید استفاده کنید.

محیط مجازی چه مشکلی را حل می کند؟ هر چه تعداد پروژه های پایتون بیشتر باشد، احتمال اینکه نیاز باشد با نسخه های مختلف کتابخانه های پایتون یا حتی خود پایتون کار کنید، بیشتر می شود. نسخه های جدیدتر کتابخانه ها برای یک پروژه می توانند سازگاری در پروژه دیگر را از بین ببرند.

محیط های مجازی گروه های مستقلی از کتابخانه های پایتون هستند که برای هر پروژه یکی هستند. بسته های نصب شده برای یک پروژه روی پروژه های دیگر یا بسته های سیستم عامل تأثیری نخواهد داشت.

پایتون همراه با ماژول venv برای ایجاد محیط های مجازی ارائه می شود.

ساخت یک محیط

یک پوشه پروژه و یک پوشه venv با دستور زیر ایجاد کنید:

Linux/macos

$ mkdir myproject
$ cd myproject
$ python3 -m venv venv

windowd

> mkdir myproject
> cd myproject
> py -3 -m venv venv

فعال سازی یک محیط

قبل از اینکه روی پروژه خود کار کنید، محیط مربوطه را فعال کنید:

Linux/macos

$ . venv/bin/activate

windowds

> venv\Scripts\activate

پوسته شما برای نشان دادن نام محیط فعال تغییر میکند.

نصب فلاسک

در محیط فعال شده، از دستور زیر برای نصب فلاسک استفاده کنید:

$ pip install Flask

فلاسک اکنون نصب شده است. شروع سریع را بررسی کنید یا به بررسی کلی مستندات بروید.