FastAPI एप्लिकेशन pydantic-settings (BaseSettings) के साथ कॉन्फ़िगरेशन प्रबंधित करते हैं — एक क्लास जो पर्यावरण चर (और .env फाइलें) से कॉन्फ़िगरेशन पढ़ता है के साथ, रहस्यों को कोड से बाहर रखता है और सुनिश्चित करता है कि स्टार्टअप पर कॉन्फ़िगरेशन सही है।
from pydantic_settings import BaseSettings
class Settings(BaseSettings):
app_name: str = "My API"
database_url: str # required — must be provided
secret_key: str # required (a secret)
debug: bool = False
max_connections: int = 10
class Config:
env_file = ".env" # also read from a .env file
settings = Settings() # reads & VALIDATES env vars at startup
BaseSettings स्वचालित रूप से एक मेल खाने वाले पर्यावरण चर से प्रत्येक फील्ड पढ़ता है (जैसे DATABASE_URL), प्रकारों को परिवर्तित करता है ("true" → bool, "10" → int), और सत्यापित करता है — एक अनुपस्थित आवश्यक मान या गलत प्रकार स्टार्टअप पर तुरंत एक स्पष्ट त्रुटि के साथ विफल हो जाता है (fail-fast)।
from functools import lru_cache
from fastapi import Depends
@lru_cache # create the Settings once (cached)
def get_settings():
return Settings()
@app.get("/info")
def info(settings: Settings = Depends(get_settings)):
return {"app": settings.app_name, "debug": settings.debug}
एक कैश्ड निर्भरता के माध्यम से सेटिंग्स को इंजेक्ट करना उन्हें परीक्षण योग्य बनाता है (परीक्षणों में ओवरराइड करें) और एक एकल उदाहरण सुनिश्चित करता है।
# .env — local config, GITIGNORED (never commit secrets)
DATABASE_URL=postgresql://localhost/mydb
SECRET_KEY=dev-secret
DEBUG=true
✓ Keep secrets in env vars / .env (gitignored); commit a .env.example documenting keys
✓ In production, inject config via the platform's environment / secret manager
✓ Validation at startup catches misconfiguration immediately (not deep in a request)
सही सेटिंग्स प्रबंधन एक संचालन आवश्यकता है (एप्लिकेशनों को dev/staging/production में विभिन्न कॉन्फ़िगरेशन की आवश्यकता होती है) और एक सुरक्षा आवश्यकता है (डेटाबेस URL और कुंजी जैसे रहस्यों को कभी भी स्रोत नियंत्रण में हार्डकोड नहीं किया जाना चाहिए — एक सामान्य, गंभीर उल्लंघन)।
Pydantic का BaseSettings FastAPI के लिए पारंपरिक समाधान प्रदान करता है, और इसे समझना महत्वपूर्ण रोजमर्रा ज्ञान है।
इसके मुख्य लाभ: पर्यावरण चर से कॉन्फ़िगरेशन पढ़ना (रहस्यों को कोड से बाहर रखना, बारह-कारक दृष्टिकोण) स्वचालित प्रकार रूपांतरण और सत्यापन के साथ — तो गलत कॉन्फ़िगरेशन स्टार्टअप पर एक स्पष्ट त्रुटि के साथ जल्दी विफल हो जाता है न कि रनटाइम पर भ्रामक विफलता।
निर्भरता इंजेक्शन (सेटिंग्स को परीक्षण योग्य और सिंगलटन बनाना) और स्थानीय विकास के लिए gitignored .env फाइलों की प्रथा के साथ मिलकर, यह आपको सुरक्षित, सत्यापित, पर्यावरण-उपयुक्त कॉन्फ़िगरेशन देता है।
सेटिंग्स को परिभाषित करने, उन्हें DI के माध्यम से उपयोग करने, और रहस्यों को सुरक्षित रूप से प्रबंधित करने का तरीका जानना उत्पादन-तैयार FastAPI एप्लिकेशन बनाने के लिए मौलिक है।