تنظیمات جنگو خود را با نکات تایپ ساده کنید: یک آموزش پیدانتیک

پروژه های جنگو من را ناامید می کرد، زیرا فاقد روشی قوی و مقیاس پذیر برای افزودن محیط های جدید بودم. با گرد هم آوردن نکات Pydantic و Python، پایه قدرتمندی را که لازم داشتم ساختم.

همانطور که در PEP 484، نکات تایپ از تحلیل استاتیک پشتیبانی می کنند، اما همین حاشیه نویسی ها در زمان اجرا نیز در دسترس هستند. بسته های شخص ثالث مانند pydantic بررسی نوع زمان اجرا را ارائه می دهند که از این ابرداده اضافی استفاده می کند. Pydantic از نکات نوع Python برای کمک به مدیریت فراداده تنظیمات و انجام اعتبارسنجی داده های زمان اجرا استفاده می کند.

این آموزش pydantic اثرات مثبت و گسترده استفاده از مدیریت تنظیمات pydantic با جنگو را نشان می دهد.

پیکربندی ما به بهترین شیوه های شرح داده شده در آن پایبند است اپلیکیشن دوازده عاملی سایت اینترنتی:

1. تنظیمات غیر ثابت و مخفی را به صورت تعریف کنید متغیرهای محیطی.
2. در محیط های توسعه، متغیرهای محیطی را در a تعریف کنید .env فایل و اضافه کنید .env به .gitignore.
3. از مکانیسم های ارائه دهنده ابر برای تعریف متغیرهای محیطی (مخفی) برای محیط های QA، مرحله بندی و تولید استفاده کنید.
4. از یک تک استفاده کنید settings.py فایلی که خود را از روی متغیرهای محیطی پیکربندی می کند.
5. از pydantic برای خواندن، بررسی، اعتبارسنجی و تایپکست متغیرهای محیطی بر روی متغیرهای Python که پیکربندی های جنگو را تعریف می کنند، استفاده کنید.

از طرف دیگر، برخی از توسعه دهندگان چندین فایل تنظیمات ایجاد می کنند، مانند settings_dev.py و settings_prod.py. متأسفانه، این رویکرد مقیاس خوبی ندارد. این منجر به تکرار کد، سردرگمی، اشکالات سخت و تلاش برای تعمیر و نگهداری می شود.

با استفاده از بهترین روش های ذکر شده، افزودن هر تعداد محیط آسان، به خوبی تعریف شده و ضد خطا است. اگرچه می توانیم پیکربندی محیط پیچیده تری را بررسی کنیم، برای وضوح روی دو تمرکز می کنیم: توسعه و تولید.

این در عمل چگونه به نظر می رسد؟

مدیریت تنظیمات Pydantic و متغیرهای محیطی

ما اکنون روی یک مثال در توسعه و تولید تمرکز می کنیم. ما نشان می دهیم که چگونه هر محیط تنظیمات خود را به طور متفاوتی پیکربندی می کند و چگونه pydantic از هر یک پشتیبانی می کند.

برنامه مثال ما به a نیاز دارد پایگاه داده با پشتیبانی جنگو، بنابراین باید رشته اتصال پایگاه داده را ذخیره کنیم. ما اطلاعات پیکربندی اتصال پایگاه داده را به یک متغیر محیطی منتقل می کنیم، DATABASE_URL، با استفاده از بسته پایتون dj-base-url. لطفا توجه داشته باشید که این متغیر از نوع خود است str و به صورت زیر فرمت شده است:

postgres://{user}:{password}@{hostname}:{port}/{database-name}mysql://{user}:{password}@{hostname}:{port}/{database-name}oracle://{user}:{password}@{hostname}:{port}/{database-name}sqlite:///PATH

در محیط توسعه خود، ما می توانیم از یک نمونه PostgreSQL حاوی Docker برای سهولت استفاده استفاده کنیم، در حالی که در محیط تولید خود، به یک سرویس پایگاه داده ارائه شده اشاره خواهیم کرد.

متغیر دیگری که می خواهیم تعریف کنیم یک بولی است، DEBUG. را اشکال زدایی پرچم در جنگو هرگز نباید در استقرار تولید روشن شود. برای دریافت بازخورد اضافی در طول توسعه در نظر گرفته شده است. به عنوان مثال، در حالت اشکال زدایی، جنگو صفحات خطای دقیق را در صورت بروز یک استثنا نمایش می دهد.

مقادیر مختلف برای توسعه و تولید را می توان به صورت زیر تعریف کرد:

ما استفاده می کنیم مدیریت تنظیمات pydantic ماژول برای مدیریت این مجموعه های مختلف از مقادیر متغیر محیطی بسته به محیط.

مراحل مقدماتی

برای عملی کردن این موضوع، ما شروع به پیکربندی محیط توسعه خود با ایجاد تک آهنگ خود می کنیم .env فایل با این محتوا:

DATABASE_URL=postgres://postgres:mypw@localhost:5432/mydbDEBUG=True

بعد، ما اضافه می کنیم .env فایل به پروژه .gitignore فایل. را .gitignore فایل از ذخیره اطلاعات بالقوه حساس در کنترل منبع جلوگیری می کند.

در حالی که این رویکرد در محیط توسعه ما به خوبی کار می کند، مشخصات محیط تولید ما از مکانیزم متفاوتی استفاده می کند. بهترین شیوه های ما حکم می کند که متغیرهای محیط تولید از اسرار محیط استفاده کنند. به عنوان مثال، در Heroku، این رازها Config Vars نامیده می شوند و از طریق داشبورد Heroku پیکربندی می شوند. آنها به عنوان متغیرهای محیطی در دسترس برنامه مستقر هستند:

پس از آن، باید پیکربندی برنامه را طوری تنظیم کنیم که این مقادیر را از هر محیط به طور خودکار بخواند.

پیکربندی جنگو settings.py

بیایید با یک پروژه جنگو جدید شروع کنیم تا ساختار ضروری را برای مثال خود ارائه کنیم. ما یک پروژه جنگو جدید را با دستور ترمینال زیر داربست می کنیم:

$ django-admin startproject mysite

ما در حال حاضر یک ساختار پروژه اساسی برای mysite پروژه ساختار فایل پروژه به شرح زیر است:

mysite/    manage.py    mysite/        __init__.py        settings.py        urls.py        asgi.py        wsgi.py

را settings.py فایل حاوی کد دیگ بخار است که به ما امکان می دهد پیکربندی برنامه را مدیریت کنیم. تنظیمات پیش فرض از پیش تعریف شده زیادی دارد که باید آنها را با محیط مربوطه تنظیم کنیم.

برای مدیریت این تنظیمات برنامه با استفاده از متغیرهای محیطی و pydantic، این کد را به بالای صفحه اضافه کنید settings.py فایل:

import osfrom pathlib import Pathfrom pydantic import (    BaseSettings,    PostgresDsn,    EmailStr,    HttpUrl,)import dj_database_url# Build paths inside the project like this: BASE_DIR / \'subdir\'.BASE_DIR = Path(__file__).resolve().parent.parentclass SettingsFromEnvironment(BaseSettings):    """Defines environment variables with their types and optional defaults"""    DATABASE_URL: PostgresDsn    DEBUG: bool = False    class Config:        """Defines configuration for pydantic environment loading"""        env_file = str(BASE_DIR / ".env")        case_sensitive = Trueconfig = SettingsFromEnvironment()os.environ["DATABASE_URL"] = config.DATABASE_URLDATABASES = {    "default": dj_database_url.config(conn_max_age=600, ssl_require=True)}DEBUG = config.DEBUG

این کد کارهای زیر را انجام می دهد:

• کلاس را تعریف می کند SettingsFromEnvironment، از pydantic به ارث می برد BaseSettings کلاس
• تعریف می کند DATABASE_URL و DEBUG، تنظیم نوع و پیش فرض اختیاری آنها با استفاده از نکات نوع پایتون.
• کلاس را تعریف می کند Config به pydantic گفتن به دنبال متغیرهای a .env فایل در صورتی که در متغیرهای محیطی سیستم وجود نداشته باشد.
• را نمونه می کند Config کلاس به شی config; متغیرهای مورد نظر در دسترس قرار می گیرند config.DATABASE_URL و config.DEBUG.
• متغیرهای معمولی جنگو را تعریف می کند DATABASES و DEBUG از اینها config اعضا.

کد یکسان در همه محیط ها اجرا می شود و pydantic موارد زیر را انجام می دهد:

• به دنبال متغیرهای محیط می گردد DATABASE_URL و DEBUG.
  • اگر به عنوان متغیرهای محیطی تعریف شود، مانند تولید، از آنها استفاده خواهد کرد.
  • در غیر این صورت، آن مقادیر را از .env فایل.
  • اگر مقداری را پیدا نکرد، کارهای زیر را انجام می دهد:
    • برای DATABASE_URL، خطا می دهد.
    • برای DEBUG، یک مقدار پیش فرض را اختصاص می دهد False.
• اگر یک متغیر محیطی پیدا کند، بررسی می کند انواع میدان و اگر هر یک از آنها اشتباه است خطا بدهید:
  • برای DATABASE_URL، تأیید می کند که نوع فیلد آن a است PostgresDsnURL -style.
  • برای DEBUG، تأیید می کند که نوع میدان آن یک پیدانتیک معتبر و غیر دقیق است بولی.

لطفاً به تنظیم صریح متغیر محیطی سیستم عامل از مقدار پیکربندی برای توجه کنید DATABASE_URL. ممکن است تنظیم آن اضافی به نظر برسد os.environ["DATABASE_URL"] = config.DATABASE_URL زیرا DATABASE_URL قبلاً به عنوان یک متغیر محیط خارجی تعریف شده است. با این حال، این به pydantic اجازه می دهد تا این متغیر را تجزیه، بررسی و اعتبار سنجی کند. اگر متغیر محیطی DATABASE_URL گم شده یا به اشتباه فرمت شده است، pydantic یک پیغام خطای واضح می دهد. وقتی برنامه از توسعه به محیط های بعدی می رود، این بررسی های خطا بسیار ارزشمند هستند.

اگر متغیری تعریف نشده باشد، یا یک پیش فرض تعیین می شود یا یک خطا از تعریف آن درخواست می کند. هر درخواست ایجاد شده نیز نوع متغیر مورد نظر را به تفصیل شرح می دهد. یک مزیت جانبی این بررسی ها این است که اعضای تیم جدید و مهندسان DevOps راحت تر متوجه می شوند که کدام متغیرها باید تعریف شوند. با این کار از مشکلاتی که به سختی پیدا می شوند، زمانی که برنامه بدون همه متغیرهای تعریف شده اجرا می شود، ایجاد می شود.

خودشه. این برنامه اکنون دارای یک پیاده سازی قابل نگهداری و مدیریت تنظیمات با استفاده از یک نسخه واحد است settings.py. زیبایی این رویکرد این است که به ما امکان می دهد متغیرهای محیطی صحیح را در a مشخص کنیم .env فایل یا هر وسیله دلخواه دیگری که از طریق محیط میزبانی ما در دسترس است.

مسیر مقیاس پذیر

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

مقاله بعدی این مجموعه آموزش گام به گام ساخت اپلیکیشن جنگو از ابتدا با مدیریت تنظیمات pydantic و استقرار آن در Heroku است.

وبلاگ مهندسی Toptal از استفان دیویدسون برای بررسی نمونه کدهای ارائه شده در این مقاله تشکر می کند.

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