وب‌سرویس مجید

پروژه pydantic-settings

pydantic/pydantic-settings

مدیریت تنظیمات با استفاده از pydantic رو ساده و قدرتمند می‌کنه ️

این کتابخانه به تو اجازه می‌ده تنظیمات برنامه‌ات رو به صورت ساختاریافته، اعتبارسنجی‌شده و قابل خواندن تعریف کنی، بدون دردسر متغیرهای محیطی و فایل‌های کانفیگ

کاربرد:

این ابزار برای مدیریت settings یا configurations در پروژه‌های پایتونی طراحی شده. با استفاده از قابلیت‌های pydantic مثل اعتبارسنجی داده‌ها، نوع‌دهی قوی و پشتیبانی از متغیرهای محیطی (environment variables)، تنظیمات رو به یک کلاس پایتونی تبدیل می‌کنه که هم خواندنی‌تره، هم ایمن‌تر

در چه شرایطی بهتره استفاده شود؟

وقتی داری یک برنامه با چندین محیط (مثل development, production, testing) می‌نویسی و نیاز داری تنظیمات مثل آدرس دیتابیس، کلیدهای API یا تنظیمات لاگینگ رو به صورت مرکزی و قابل کنترل مدیریت کنی، این ابزار عالیه

همچنین اگر از فریم‌ورک‌هایی مثل FastAPI استفاده می‌کنی، ترکیب این دو می‌تونه بسیار قدرتمند باشه

چند مثال از موارد استفاده:

تعریف تنظیمات دیتابیس با اعتبارسنجی از نوع و اجباری بودن فیلدها

بارگذاری کلیدهای API از فایل .env با پشتیبانی از مقدار پیش‌فرض

تفکیک تنظیمات بر اساس محیط (مثلاً در حالت تست از دیتابیس حافظه استفاده کنه)

اعتبارسنجی ساختار JSON یا YAML قبل از استفاده در برنامه

  • ##settings
  • ##pydantic
  • ##python
  • ##env
  • ##fastapi
  • ##data
  • ##configuration
  • ##python
  • ##type
  • ##backend