+
+بعد نوبت تو می‌شه، سفارش دو تا برگر خیلی شیک برای خودت و عشقت می‌دی. 🍔🍔
+
+
+
+صندوقدار یه چیزی به آشپز توی آشپزخونه می‌گه تا بدونن باید برگرهای تو رو آماده کنن (گرچه الان دارن برگرهای مشتریای قبلی رو درست می‌کنن).
+
+
+
+پول رو می‌دی. 💸
+
+صندوقدار شماره نوبتت رو بهت می‌ده.
+
+
+
+وقتی منتظری، با عشقت می‌ری یه میز انتخاب می‌کنی، می‌شینی و کلی با عشقت حرف می‌زنی (چون برگرهات خیلی شیکن و آماده کردنشون یه کم طول می‌کشه).
+
+وقتی پشت میز با عشقت نشستی، در حالی که منتظر برگرهایی، می‌تونی اون زمان رو صرف تحسین این کنی که عشقت چقدر باحال، ناز و باهوشه ✨😍✨.
+
+
+
+وقتی منتظری و با عشقت حرف می‌زنی، هر از گاهی شماره‌ای که رو پیشخون نشون داده می‌شه رو چک می‌کنی که ببینی نوبتت شده یا نه.
+
+بعد یه جایی بالاخره نوبتت می‌شه. می‌ری پیشخون، برگرهات رو می‌گیری و برمی‌گردی سر میز.
+
+
+
+تو و عشقت برگرها رو می‌خورین و یه وقت خوب باهم دارین. ✨
+
+
+
+/// info
+
+تصاویر قشنگ از 
+
+بالاخره نوبت تو می‌شه، سفارش دو تا برگر خیلی شیک برای خودت و عشقت می‌دی.
+
+پول رو می‌دی 💸.
+
+
+
+صندوقدار می‌ره آشپزخونه.
+
+منتظر می‌مونی، جلوی پیشخون وایستادی 🕙، که کسی قبل از تو برگرهات رو نگیره، چون شماره نوبت نیست.
+
+
+
+چون تو و عشقت مشغول این هستین که نذارین کسی جلوتون بیاد و هر وقت برگرها رسیدن اونا رو بگیره، نمی‌تونی به عشقت توجه کنی. 😞
+
+این کار "همزمان" هست، تو با صندوقدار/آشپز 👨🍳 "همزمان" هستی. باید منتظر بمونی 🕙 و درست همون لحظه که صندوقدار/آشپز 👨🍳 برگرها رو تموم می‌کنه و بهت می‌ده اونجا باشی، وگرنه ممکنه یکی دیگه اونا رو بگیره.
+
+
+
+بعد صندوقدار/آشپزت 👨🍳 بالاخره بعد از یه مدت طولانی انتظار 🕙 جلوی پیشخون با برگرهات برمی‌گرده.
+
+
+
+برگرهات رو می‌گیری و با عشقت می‌ری سر میز.
+
+فقط می‌خورینشون، و تمومه. ⏹
+
+
+
+حرف زدن یا لاس زدن زیاد نبود چون بیشتر وقت صرف انتظار 🕙 جلوی پیشخون شد. 😞
+
+/// info
+
+تصاویر قشنگ از 
+
+### نوع اضافه کن
+
+بیا فقط یه خط از نسخه قبلی رو تغییر بدیم.
+
+دقیقاً این بخش، پارامترهای تابع رو، از:
+
+```Python
+ first_name, last_name
+```
+
+به:
+
+```Python
+ first_name: str, last_name: str
+```
+
+عوض می‌کنیم.
+
+همینه.
+
+اینا همون "نوع‌نماها" هستن:
+
+{* ../../docs_src/python_types/tutorial002.py hl[1] *}
+
+این با تعریف مقدار پیش‌فرض فرق داره، مثل:
+
+```Python
+ first_name="john", last_name="doe"
+```
+
+یه چیز متفاوته.
+
+ما از دونقطه (`:`) استفاده می‌کنیم، نه علامت مساوی (`=`).
+
+و اضافه کردن نوع‌نماها معمولاً چیزی که اتفاق می‌افته رو از چیزی که بدون اونا می‌افتاد تغییر نمی‌ده.
+
+ولی حالا، دوباره تصور کن وسط ساختن اون تابع هستی، ولی این بار با نوع‌نماها.
+
+توی همون نقطه، سعی می‌کنی تکمیل خودکار رو با `Ctrl+Space` فعال کنی و اینو می‌بینی:
+
+
+
+با این، می‌تونی اسکرول کنی، گزینه‌ها رو ببینی، تا وقتی که اون چیزی که "به نظرت آشنا میاد" رو پیدا کنی:
+
+
+
+## انگیزه بیشتر
+
+این تابع رو چک کن، الان نوع‌نما داره:
+
+{* ../../docs_src/python_types/tutorial003.py hl[1] *}
+
+چون ویرایشگر نوع متغیرها رو می‌دونه، فقط تکمیل خودکار نمی‌گیری، بلکه چک خطاها هم داری:
+
+
+
+حالا می‌دونی که باید درستش کنی، `age` رو با `str(age)` به یه رشته تبدیل کنی:
+
+{* ../../docs_src/python_types/tutorial004.py hl[2] *}
+
+## تعریف نوع‌ها
+
+تازه اصلی‌ترین جا برای تعریف نوع‌نماها رو دیدی. به‌عنوان پارامترهای تابع.
+
+این هم اصلی‌ترین جاییه که با **FastAPI** ازشون استفاده می‌کنی.
+
+### نوع‌های ساده
+
+می‌تونی همه نوع‌های استاندارد پایتون رو تعریف کنی، نه فقط `str`.
+
+مثلاً می‌تونی از اینا استفاده کنی:
+
+* `int`
+* `float`
+* `bool`
+* `bytes`
+
+{* ../../docs_src/python_types/tutorial005.py hl[1] *}
+
+### نوع‌های عمومی با پارامترهای نوع
+
+یه سری ساختار داده هستن که می‌تونن مقدارهای دیگه رو نگه دارن، مثل `dict`، `list`، `set` و `tuple`. و مقدارهای داخلیشون هم می‌تونن نوع خودشون رو داشته باشن.
+
+به این نوع‌ها که نوع‌های داخلی دارن می‌گن "**عمومی**" یا "generic". و می‌شه اونا رو تعریف کرد، حتی با نوع‌های داخلیشون.
+
+برای تعریف این نوع‌ها و نوع‌های داخلیشون، می‌تونی از ماژول استاندارد پایتون `typing` استفاده کنی. این ماژول مخصوص پشتیبانی از نوع‌نماهاست.
+
+#### نسخه‌های جدیدتر پایتون
+
+سینتکس با استفاده از `typing` با همه نسخه‌ها، از پایتون 3.6 تا جدیدترین‌ها، از جمله پایتون 3.9، 3.10 و غیره **سازگاره**.
+
+با پیشرفت پایتون، **نسخه‌های جدیدتر** پشتیبانی بهتری برای این نوع‌نماها دارن و توی خیلی موارد حتی لازم نیست ماژول `typing` رو وارد کنی و ازش برای تعریف نوع‌نماها استفاده کنی.
+
+اگه بتونی برای پروژه‌ات از یه نسخه جدیدتر پایتون استفاده کنی، می‌تونی از این سادگی اضافه بهره ببری.
+
+توی همه مستندات، مثال‌هایی هستن که با هر نسخه پایتون سازگارن (وقتی تفاوتی هست).
+
+مثلاً "**Python 3.6+**" یعنی با پایتون 3.6 یا بالاتر (مثل 3.7، 3.8، 3.9، 3.10 و غیره) سازگاره. و "**Python 3.9+**" یعنی با پایتون 3.9 یا بالاتر (مثل 3.10 و غیره) سازگاره.
+
+اگه بتونی از **جدیدترین نسخه‌های پایتون** استفاده کنی، از مثال‌های نسخه آخر استفاده کن، چون اونا **بهترین و ساده‌ترین سینتکس** رو دارن، مثلاً "**Python 3.10+**".
+
+#### لیست
+
+مثلاً، بیایم یه متغیر تعریف کنیم که یه `list` از `str` باشه.
+
+//// tab | Python 3.9+
+
+متغیر رو با همون سینتکس دونقطه (`:`) تعریف کن.
+
+به‌عنوان نوع، `list` رو بذار.
+
+چون لیست یه نوعه که نوع‌های داخلی داره، اونا رو توی کروشه‌ها می‌ذاری:
+
+```Python hl_lines="1"
+{!> ../../docs_src/python_types/tutorial006_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+از `typing`، `List` رو (با `L` بزرگ) وارد کن:
+
+```Python hl_lines="1"
+{!> ../../docs_src/python_types/tutorial006.py!}
+```
+
+متغیر رو با همون سینتکس دونقطه (`:`) تعریف کن.
+
+به‌عنوان نوع، `List` رو که از `typing` وارد کردی بذار.
+
+چون لیست یه نوعه که نوع‌های داخلی داره، اونا رو توی کروشه‌ها می‌ذاری:
+
+```Python hl_lines="4"
+{!> ../../docs_src/python_types/tutorial006.py!}
+```
+
+////
+
+/// info
+
+اون نوع‌های داخلی توی کروشه‌ها بهشون "پارامترهای نوع" می‌گن.
+
+توی این مورد، `str` پارامتر نوعیه که به `List` (یا `list` توی پایتون 3.9 و بالاتر) پاس داده شده.
+
+///
+
+یعنی: "متغیر `items` یه `list` هست، و هر کدوم از آیتم‌های این لیست یه `str` هستن".
+
+/// tip
+
+اگه از پایتون 3.9 یا بالاتر استفاده می‌کنی، لازم نیست `List` رو از `typing` وارد کنی، می‌تونی همون نوع معمولی `list` رو به جاش استفاده کنی.
+
+///
+
+با این کار، ویرایشگرت حتی وقتی داری آیتم‌های لیست رو پردازش می‌کنی بهت کمک می‌کنه:
+
+
+
+بدون نوع‌ها، رسیدن به این تقریباً غیرممکنه.
+
+توجه کن که متغیر `item` یکی از عناصر توی لیست `items` هست.
+
+و با این حال، ویرایشگر می‌دونه که یه `str` هست و براش پشتیبانی می‌ده.
+
+#### تاپل و ست
+
+برای تعریف `tuple`ها و `set`ها هم همین کار رو می‌کنی:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="1"
+{!> ../../docs_src/python_types/tutorial007_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial007.py!}
+```
+
+////
+
+یعنی:
+
+* متغیر `items_t` یه `tuple` با 3 تا آیتمه، یه `int`، یه `int` دیگه، و یه `str`.
+* متغیر `items_s` یه `set` هست، و هر کدوم از آیتم‌هاش از نوع `bytes` هستن.
+
+#### دیکشنری
+
+برای تعریف یه `dict`، 2 تا پارامتر نوع می‌دی، که با کاما از هم جدا شدن.
+
+پارامتر نوع اول برای کلیدهای `dict` هست.
+
+پارامتر نوع دوم برای مقدارهای `dict` هست:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="1"
+{!> ../../docs_src/python_types/tutorial008_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial008.py!}
+```
+
+////
+
+یعنی:
+
+* متغیر `prices` یه `dict` هست:
+ * کلیدهای این `dict` از نوع `str` هستن (مثلاً اسم هر آیتم).
+ * مقدارهای این `dict` از نوع `float` هستن (مثلاً قیمت هر آیتم).
+
+#### اتحادیه
+
+می‌تونی تعریف کنی که یه متغیر می‌تونه هر کدوم از **چند تا نوع** باشه، مثلاً یه `int` یا یه `str`.
+
+توی پایتون 3.6 و بالاتر (از جمله پایتون 3.10) می‌تونی از نوع `Union` توی `typing` استفاده کنی و نوع‌های ممکن رو توی کروشه‌ها بذاری.
+
+توی پایتون 3.10 یه **سینتکس جدید** هم هست که می‌تونی نوع‌های ممکن رو با یه خط عمودی (`|`) جدا کنی.
+
+//// tab | Python 3.10+
+
+```Python hl_lines="1"
+{!> ../../docs_src/python_types/tutorial008b_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial008b.py!}
+```
+
+////
+
+توی هر دو حالت یعنی `item` می‌تونه یه `int` یا یه `str` باشه.
+
+#### شاید `None`
+
+می‌تونی تعریف کنی که یه مقدار می‌تونه یه نوع باشه، مثلاً `str`، ولی می‌تونه `None` هم باشه.
+
+توی پایتون 3.6 و بالاتر (از جمله پایتون 3.10) می‌تونی با وارد کردن و استفاده از `Optional` از ماژول `typing` اینو تعریف کنی.
+
+```Python hl_lines="1 4"
+{!../../docs_src/python_types/tutorial009.py!}
+```
+
+استفاده از `Optional[str]` به جای فقط `str` به ویرایشگر کمک می‌کنه خطاهایی که ممکنه فکر کنی یه مقدار همیشه `str` هست رو پیدا کنه، در حالی که می‌تونه `None` هم باشه.
+
+`Optional[Something]` در واقع میان‌بر برای `Union[Something, None]` هست، این دو تا معادلن.
+
+یعنی توی پایتون 3.10، می‌تونی از `Something | None` استفاده کنی:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="1"
+{!> ../../docs_src/python_types/tutorial009_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial009.py!}
+```
+
+////
+
+//// tab | Python 3.8+ جایگزین
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial009b.py!}
+```
+
+////
+
+#### استفاده از `Union` یا `Optional`
+
+اگه از نسخه پایتون زیر 3.10 استفاده می‌کنی، یه نکته از دید خیلی **شخصی** خودم:
+
+* 🚨 از `Optional[SomeType]` استفاده نکن
+* به جاش ✨ **از `Union[SomeType, None]` استفاده کن** ✨.
+
+هر دو معادلن و زیر پوسته یکی‌ان، ولی من `Union` رو به `Optional` ترجیح می‌دم چون کلمه "**اختیاری**" انگار暗示 می‌کنه که مقدار اختیاریه، در حالی که در واقع یعنی "می‌تونه `None` باشه"، حتی اگه اختیاری نباشه و هنوز لازم باشه.
+
+فکر می‌کنم `Union[SomeType, None]` واضح‌تر نشون می‌ده چی معنی می‌ده.
+
+فقط بحث کلمات و اسم‌هاست. ولی این کلمات می‌تونن رو طرز فکر تو و تیمت نسبت به کد تأثیر بذارن.
+
+به‌عنوان مثال، این تابع رو ببین:
+
+{* ../../docs_src/python_types/tutorial009c.py hl[1,4] *}
+
+پارامتر `name` به‌عنوان `Optional[str]` تعریف شده، ولی **اختیاری نیست**، نمی‌تونی تابع رو بدون پارامتر صدا کنی:
+
+```Python
+say_hi() # اوه نه، این خطا می‌ده! 😱
+```
+
+پارامتر `name` **هنوز لازمه** (نه *اختیاری*) چون مقدار پیش‌فرض نداره. با این حال، `name` مقدار `None` رو قبول می‌کنه:
+
+```Python
+say_hi(name=None) # این کار می‌کنه، None معتبره 🎉
+```
+
+خبر خوب اینه که وقتی رو پایتون 3.10 باشی، لازم نیست نگران این باشی، چون می‌تونی به‌سادگی از `|` برای تعریف اتحادیه نوع‌ها استفاده کنی:
+
+{* ../../docs_src/python_types/tutorial009c_py310.py hl[1,4] *}
+
+اون موقع دیگه لازم نیست نگران اسم‌هایی مثل `Optional` و `Union` باشی. 😎
+
+#### نوع‌های عمومی
+
+این نوع‌هایی که پارامترهای نوع رو توی کروشه‌ها می‌گیرن بهشون **نوع‌های عمومی** یا **Generics** می‌گن، مثلاً:
+
+//// tab | Python 3.10+
+
+می‌تونی از همون نوع‌های داخلی به‌عنوان نوع‌های عمومی استفاده کنی (با کروشه‌ها و نوع‌ها داخلشون):
+
+* `list`
+* `tuple`
+* `set`
+* `dict`
+
+و همون‌طور که توی پایتون 3.8 بود، از ماژول `typing`:
+
+* `Union`
+* `Optional` (همون‌طور که توی پایتون 3.8 بود)
+* ...و بقیه.
+
+توی پایتون 3.10، به‌عنوان جایگزین برای استفاده از نوع‌های عمومی `Union` و `Optional`، می‌تونی از خط عمودی (`|`) برای تعریف اتحادیه نوع‌ها استفاده کنی، که خیلی بهتر و ساده‌تره.
+
+////
+
+//// tab | Python 3.9+
+
+می‌تونی از همون نوع‌های داخلی به‌عنوان نوع‌های عمومی استفاده کنی (با کروشه‌ها و نوع‌ها داخلشون):
+
+* `list`
+* `tuple`
+* `set`
+* `dict`
+
+و همون‌طور که توی پایتون 3.8 بود، از ماژول `typing`:
+
+* `Union`
+* `Optional`
+* ...و بقیه.
+
+////
+
+//// tab | Python 3.8+
+
+* `List`
+* `Tuple`
+* `Set`
+* `Dict`
+* `Union`
+* `Optional`
+* ...و بقیه.
+
+////
+
+### کلاس‌ها به‌عنوان نوع
+
+می‌تونی یه کلاس رو هم به‌عنوان نوع یه متغیر تعریف کنی.
+
+فرض کن یه کلاس `Person` داری، با یه نام:
+
+{* ../../docs_src/python_types/tutorial010.py hl[1:3] *}
+
+بعد می‌تونی یه متغیر رو از نوع `Person` تعریف کنی:
+
+{* ../../docs_src/python_types/tutorial010.py hl[6] *}
+
+و بعد، دوباره، همه پشتیبانی ویرایشگر رو داری:
+
+
+
+توجه کن که این یعنی "`one_person` یه **نمونه** از کلاس `Person` هست".
+
+یعنی "`one_person` خود **کلاس** به اسم `Person` نیست".
+
+## مدل‌های Pydantic
+
+Pydantic یه کتابخونه پایتونه برای اعتبارسنجی داده‌ها.
+
+"شکل" داده‌ها رو به‌عنوان کلاس‌هایی با ویژگی‌ها تعریف می‌کنی.
+
+و هر ویژگی یه نوع داره.
+
+بعد یه نمونه از اون کلاس رو با یه سری مقدار می‌سازی و اون مقدارها رو اعتبارسنجی می‌کنه، به نوع مناسب تبدیلشون می‌کنه (اگه لازم باشه) و یه شیء با همه داده‌ها بهت می‌ده.
+
+و با اون شیء نهایی همه پشتیبانی ویرایشگر رو می‌گیری.
+
+یه مثال از مستندات رسمی Pydantic:
+
+//// tab | Python 3.10+
+
+```Python
+{!> ../../docs_src/python_types/tutorial011_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!> ../../docs_src/python_types/tutorial011_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python
+{!> ../../docs_src/python_types/tutorial011.py!}
+```
+
+////
+
+/// info
+
+برای اطلاعات بیشتر در مورد Pydantic، مستنداتش رو چک کن.
+
+///
+
+**FastAPI** کاملاً بر پایه Pydantic هست.
+
+توی [آموزش - راهنمای کاربر](tutorial/index.md){.internal-link target=_blank} خیلی بیشتر از اینا رو توی عمل می‌بینی.
+
+/// tip
+
+Pydantic یه رفتار خاص داره وقتی از `Optional` یا `Union[Something, None]` بدون مقدار پیش‌فرض استفاده می‌کنی، می‌تونی توی مستندات Pydantic در مورد فیلدهای اختیاری لازم بیشتر بخونی.
+
+///
+
+## نوع‌نماها با Annotationهای متادیتا
+
+پایتون یه قابلیت هم داره که بهت اجازه می‌ده **متادیتا اضافی** رو توی این نوع‌نماها بذاری با استفاده از `Annotated`.
+
+//// tab | Python 3.9+
+
+توی پایتون 3.9، `Annotated` بخشی از کتابخونه استاندارده، پس می‌تونی از `typing` واردش کنی.
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial013_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+توی نسخه‌های زیر پایتون 3.9، `Annotated` رو از `typing_extensions` وارد می‌کنی.
+
+با **FastAPI** از قبل نصب شده.
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial013.py!}
+```
+
+////
+
+خود پایتون با این `Annotated` کاری نمی‌کنه. و برای ویرایشگرها و ابزارهای دیگه، نوع هنوز `str` هست.
+
+ولی می‌تونی از این فضا توی `Annotated` استفاده کنی تا به **FastAPI** متادیتای اضافی در مورد اینکه چطور می‌خوای برنامه‌ات رفتار کنه بدی.
+
+نکته مهم اینه که **اولین *پارامتر نوع*** که به `Annotated` می‌دی، **نوع واقعی** هست. بقیش فقط متادیتا برای ابزارهای دیگه‌ست.
+
+الان فقط باید بدونی که `Annotated` وجود داره، و اینکه پایتون استاندارده. 😎
+
+بعداً می‌بینی که چقدر **قوی** می‌تونه باشه.
+
+/// tip
+
+اینکه این **پایتون استاندارده** یعنی هنوز **بهترین تجربه توسعه‌دهنده** رو توی ویرایشگرت، با ابزارهایی که برای تحلیل و بازسازی کدت استفاده می‌کنی و غیره می‌گیری. ✨
+
+و همین‌طور کدت با خیلی از ابزارها و کتابخونه‌های دیگه پایتون خیلی سازگار می‌مونه. 🚀
+
+///
+
+## نوع‌نماها توی **FastAPI**
+
+**FastAPI** از این نوع‌نماها استفاده می‌کنه تا چند تا کار بکنه.
+
+با **FastAPI** پارامترها رو با نوع‌نماها تعریف می‌کنی و اینا رو می‌گیری:
+
+* **پشتیبانی ویرایشگر**.
+* **چک نوع‌ها**.
+
+...و **FastAPI** از همون تعریف‌ها برای اینا استفاده می‌کنه:
+
+* **تعریف نیازها**: از پارامترهای مسیر درخواست، پارامترهای کوئری، هدرها، بدنه‌ها، وابستگی‌ها و غیره.
+* **تبدیل داده**: از درخواست به نوع مورد نیاز.
+* **اعتبارسنجی داده**: که از هر درخواست میاد:
+ * تولید **خطاهای خودکار** که به کلاینت برمی‌گرده وقتی داده نامعتبره.
+* **مستندسازی** API با استفاده از OpenAPI:
+ * که بعدش توسط رابط‌های کاربری مستندات تعاملی خودکار استفاده می‌شه.
+
+اینا شاید همه‌ش انتزاعی به نظر بیاد. نگران نباش. همه اینا رو توی عمل توی [آموزش - راهنمای کاربر](tutorial/index.md){.internal-link target=_blank} می‌بینی.
+
+نکته مهم اینه که با استفاده از نوع‌های استاندارد پایتون، توی یه جا (به جای اضافه کردن کلاس‌های بیشتر، دکوراتورها و غیره)، **FastAPI** کلی از کار رو برات انجام می‌ده.
+
+/// info
+
+اگه همه آموزش رو گذروندی و برگشتی که بیشتر در مورد نوع‌ها ببینی، یه منبع خوب "تقلب‌نامه" از `mypy` هست.
+
+///
From 6bc29cc5ba2662cff6662a0642784530f78103f9 Mon Sep 17 00:00:00 2001
From: github-actions 
+
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index f712b6179..784fd6692 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -26,6 +26,9 @@ gold:
- url: https://subtotal.com/?utm_source=fastapi&utm_medium=sponsorship&utm_campaign=open-source
title: The Gold Standard in Retail Account Linking
img: https://fastapi.tiangolo.com/img/sponsors/subtotal.svg
+ - url: https://vibe.mobb.ai/?utm_source=Fast+APi&utm_medium=Image&utm_campaign=MVS
+ title: Secure Your AI-Generated Code to Unlock Dev Productivity
+ img: https://fastapi.tiangolo.com/img/sponsors/mobbai.png
silver:
- url: https://databento.com/
title: Pay as you go for market data
diff --git a/docs/en/data/sponsors_badge.yml b/docs/en/data/sponsors_badge.yml
index d145e7372..a8895c8ed 100644
--- a/docs/en/data/sponsors_badge.yml
+++ b/docs/en/data/sponsors_badge.yml
@@ -43,3 +43,4 @@ logins:
- permitio
- LambdaTest-Inc
- dribia
+ - madisonredtfeldt
diff --git a/docs/en/docs/img/sponsors/mobbai-banner.png b/docs/en/docs/img/sponsors/mobbai-banner.png
new file mode 100644
index 0000000000000000000000000000000000000000..1f59294abe86bc44f3b7535b50886191343bf4ac
GIT binary patch
literal 3704
zcmV-;4u|oHP)
+
+ sponsor
+ 
+
+
{% endblock %}
From ed48cc457f36ea1f999bdf68668966935cd9e47f Mon Sep 17 00:00:00 2001
From: github-actions
+
+
+
+```console
+// می‌تونی یه متغیر محیطی به اسم MY_NAME بسازی با
+$ export MY_NAME="Wade Wilson"
+
+// بعد می‌تونی با برنامه‌های دیگه ازش استفاده کنی، مثل
+$ echo "Hello $MY_NAME"
+
+Hello Wade Wilson
+```
+
+
+
+////
+
+//// tab | ویندوز پاورشل
+
+
+
+```console
+// یه متغیر محیطی به اسم MY_NAME بساز
+$ $Env:MY_NAME = "Wade Wilson"
+
+// با برنامه‌های دیگه ازش استفاده کن، مثل
+$ echo "Hello $Env:MY_NAME"
+
+Hello Wade Wilson
+```
+
+
+
+////
+
+## خوندن متغیرهای محیطی توی پایتون
+
+می‌تونی متغیرهای محیطی رو **خارج** از پایتون، توی ترمینال (یا با هر روش دیگه) بسازی، و بعد توی **پایتون** اونا رو بخونی.
+
+مثلاً می‌تونی یه فایل `main.py` داشته باشی با:
+
+```Python hl_lines="3"
+import os
+
+name = os.getenv("MY_NAME", "World")
+print(f"Hello {name} from Python")
+```
+
+/// tip
+
+آرگومان دوم `os.getenv()` مقدار پیش‌فرضیه که برمی‌گردونه.
+
+اگه ندی، به‌صورت پیش‌فرض `None` هست، اینجا ما `"World"` رو به‌عنوان مقدار پیش‌فرض گذاشتیم.
+
+///
+
+بعد می‌تونی اون برنامه پایتون رو صدا کنی:
+
+//// tab | لینوکس، مک‌اواس، ویندوز بش
+
+
+
+```console
+// اینجا هنوز متغیر محیطی رو تنظیم نکردیم
+$ python main.py
+
+// چون متغیر محیطی رو تنظیم نکردیم، مقدار پیش‌فرض رو می‌گیریم
+
+Hello World from Python
+
+// ولی اگه اول یه متغیر محیطی بسازیم
+$ export MY_NAME="Wade Wilson"
+
+// و بعد دوباره برنامه رو صدا کنیم
+$ python main.py
+
+// حالا می‌تونه متغیر محیطی رو بخونه
+
+Hello Wade Wilson from Python
+```
+
+
+
+////
+
+//// tab | ویندوز پاورشل
+
+
+
+```console
+// اینجا هنوز متغیر محیطی رو تنظیم نکردیم
+$ python main.py
+
+// چون متغیر محیطی رو تنظیم نکردیم، مقدار پیش‌فرض رو می‌گیریم
+
+Hello World from Python
+
+// ولی اگه اول یه متغیر محیطی بسازیم
+$ $Env:MY_NAME = "Wade Wilson"
+
+// و بعد دوباره برنامه رو صدا کنیم
+$ python main.py
+
+// حالا می‌تونه متغیر محیطی رو بخونه
+
+Hello Wade Wilson from Python
+```
+
+
+
+////
+
+چون متغیرهای محیطی می‌تونن خارج از کد تنظیم بشن، ولی کد می‌تونه اونا رو بخونه، و لازم نیست با بقیه فایل‌ها ذخیره (کمیتی به `git`) بشن، معمولاً برای پیکربندی یا **تنظیمات** استفاده می‌شن.
+
+همچنین می‌تونی یه متغیر محیطی رو فقط برای **یه اجرای خاص برنامه** بسازی، که فقط برای اون برنامه و فقط برای مدت زمان اجراش در دسترسه.
+
+برای این کار، درست قبل از خود برنامه، توی همون خط بسازش:
+
+
+
+```console
+// یه متغیر محیطی MY_NAME رو توی خط برای این اجرای برنامه بساز
+$ MY_NAME="Wade Wilson" python main.py
+
+// حالا می‌تونه متغیر محیطی رو بخونه
+
+Hello Wade Wilson from Python
+
+// متغیر محیطی بعدش دیگه وجود نداره
+$ python main.py
+
+Hello World from Python
+```
+
+
+
+/// tip
+
+می‌تونی بیشتر در موردش توی برنامه دوازده‌فاکتوری: پیکربندی بخونی.
+
+///
+
+## نوع‌ها و اعتبارسنجی
+
+این متغیرهای محیطی فقط می‌تونن **رشته‌های متنی** رو نگه دارن، چون خارج از پایتون هستن و باید با برنامه‌های دیگه و بقیه سیستم (و حتی سیستم‌عامل‌های مختلف مثل لینوکس، ویندوز، مک‌اواس) سازگار باشن.
+
+یعنی **هر مقداری** که توی پایتون از یه متغیر محیطی خونده می‌شه یه `str` هست، و هر تبدیل به نوع دیگه یا هر اعتبارسنجی باید توی کد انجام بشه.
+
+توی [راهنمای کاربر پیشرفته - تنظیمات و متغیرهای محیطی](./advanced/settings.md){.internal-link target=_blank} بیشتر در مورد استفاده از متغیرهای محیطی برای مدیریت **تنظیمات برنامه** یاد می‌گیری.
+
+## متغیر محیطی `PATH`
+
+یه متغیر محیطی **خاص** به اسم **`PATH`** وجود داره که سیستم‌عامل‌ها (لینوکس، مک‌اواس، ویندوز) ازش برای پیدا کردن برنامه‌هایی که قراره اجرا بشن استفاده می‌کنن.
+
+مقدار متغیر `PATH` یه رشته طولانی از پوشه‌هاست که توی لینوکس و مک‌اواس با دونقطه `:` و توی ویندوز با نقطه‌ویرگول `;` از هم جدا شدن.
+
+مثلاً، متغیر محیطی `PATH` می‌تونه اینجوری باشه:
+
+//// tab | لینوکس، مک‌اواس
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+یعنی سیستم باید دنبال برنامه‌ها توی این پوشه‌ها بگرده:
+
+* `/usr/local/bin`
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | ویندوز
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32
+```
+
+یعنی سیستم باید دنبال برنامه‌ها توی این پوشه‌ها بگرده:
+
+* `C:\Program Files\Python312\Scripts`
+* `C:\Program Files\Python312`
+* `C:\Windows\System32`
+
+////
+
+وقتی یه **دستور** توی ترمینال تایپ می‌کنی، سیستم‌عامل **دنبال** برنامه توی **هر کدوم از این پوشه‌ها** که توی متغیر محیطی `PATH` لیست شدن می‌گرده.
+
+مثلاً، وقتی توی ترمینال `python` تایپ می‌کنی، سیستم‌عامل دنبال یه برنامه به اسم `python` توی **اولین پوشه** توی اون لیست می‌گرده.
+
+اگه پیداش کنه، **استفاده‌ش می‌کنه**. وگرنه توی **پوشه‌های بعدی** دنبالش می‌گرده.
+
+### نصب پایتون و به‌روزرسانی `PATH`
+
+وقتی پایتون رو نصب می‌کنی، ممکنه ازت بپرسن آیا می‌خوای متغیر محیطی `PATH` رو به‌روزرسانی کنی.
+
+//// tab | لینوکس، مک‌اواس
+
+فرض کن پایتون رو نصب کردی و توی یه پوشه `/opt/custompython/bin` قرار گرفته.
+
+اگه بگی بله برای به‌روزرسانی متغیر محیطی `PATH`، نصاب `/opt/custompython/bin` رو به متغیر محیطی `PATH` اضافه می‌کنه.
+
+ممکنه اینجوری بشه:
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin
+```
+
+اینجوری، وقتی توی ترمینال `python` تایپ می‌کنی، سیستم برنامه پایتون رو توی `/opt/custompython/bin` (آخرین پوشه) پیدا می‌کنه و از اون استفاده می‌کنه.
+
+////
+
+//// tab | ویندوز
+
+فرض کن پایتون رو نصب کردی و توی یه پوشه `C:\opt\custompython\bin` قرار گرفته.
+
+اگه بگی بله برای به‌روزرسانی متغیر محیطی `PATH`، نصاب `C:\opt\custompython\bin` رو به متغیر محیطی `PATH` اضافه می‌کنه.
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin
+```
+
+اینجوری، وقتی توی ترمینال `python` تایپ می‌کنی، سیستم برنامه پایتون رو توی `C:\opt\custompython\bin` (آخرین پوشه) پیدا می‌کنه و از اون استفاده می‌کنه.
+
+////
+
+پس، اگه تایپ کنی:
+
+
+
+```console
+$ python
+```
+
+
+
+//// tab | لینوکس، مک‌اواس
+
+سیستم برنامه `python` رو توی `/opt/custompython/bin` **پیدا** می‌کنه و اجراش می‌کنه.
+
+تقریباً معادل اینه که تایپ کنی:
+
+
+
+```console
+$ /opt/custompython/bin/python
+```
+
+
+
+////
+
+//// tab | ویندوز
+
+سیستم برنامه `python` رو توی `C:\opt\custompython\bin\python` **پیدا** می‌کنه و اجراش می‌کنه.
+
+تقریباً معادل اینه که تایپ کنی:
+
+
+
+```console
+$ C:\opt\custompython\bin\python
+```
+
+
+
+////
+
+این اطلاعات وقتی در مورد [محیط‌های مجازی](virtual-environments.md){.internal-link target=_blank} یاد می‌گیری به‌دردت می‌خوره.
+
+## نتیجه‌گیری
+
+با این باید یه درک پایه‌ای از **متغیرهای محیطی** و نحوه استفاده‌شون توی پایتون داشته باشی.
+
+می‌تونی بیشتر در موردشون توی ویکی‌پدیا برای متغیر محیطی بخونی.
+
+توی خیلی موارد مشخص نیست که متغیرهای محیطی چطور می‌تونن فوری مفید و کاربردی باشن. ولی توی موقعیت‌های مختلف توسعه مدام پیداشون می‌شه، پس خوبه که در موردشون بدونی.
+
+مثلاً، توی بخش بعدی در مورد [محیط‌های مجازی](virtual-environments.md) به این اطلاعات نیاز داری.
From 4ca93aea04bf289cedb4dc0d922c97f2e99399d9 Mon Sep 17 00:00:00 2001
From: github-actions