FastAPI uygulamaları konfigürasyonu pydantic-settings (BaseSettings) ile yönetir — ortam değişkenlerinden (ve .env dosyalarından) okuyan, doğrulama ve tür dönüşümü yapan ve sırları kodun dışında tutarak başlangıçta konfigürasyonun doğru olmasını sağlayan bir sınıf.
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 her alanı otomatik olarak eşleşen bir ortam değişkeninden okur (örn. DATABASE_URL), türleri dönüştürür ("true" → bool, "10" → int) ve doğrular — eksik bir gerekli değer veya yanlış tür başlangıçta anında açık bir hata mesajıyla başarısız olur (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}
Ayarları önbelleğe alınmış bir bağımlılık yoluyla enjekte etmek onları test edilebilir (testlerde geçersiz kıl) yapar ve tek bir örneği sağlar.
# .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)
Doğru ayar yönetimi hem bir operasyonel gereklilik (uygulamaların dev/staging/production arasında farklı konfigürasyona ihtiyacı vardır) hem de bir güvenlik gereksinimi (veritabanı URL'leri ve anahtarlar gibi sırlar kaynak kontrolde asla kodlanmış olmamalıdır — yaygın, ciddi bir ihlaldir).
Pydantic'in BaseSettings idiyomatik FastAPI çözümünü sağlar ve bunu anlamak önemli günlük bilgidir.
Temel avantajları: ortam değişkenlerinden konfigürasyon okuma (sırları kodun dışında tutma, twelve-factor yaklaşımı) otomatik tür dönüşümü ve doğrulama ile — yani yanlış konfigürasyon başlangıçta açık bir hata mesajıyla anında başarısız olur, karışık bir çalışma zamanı hatasına dönüşmek yerine.
Bağımlılık enjeksiyonu (ayarları test edilebilir ve singleton yapan) ve yerel geliştirme için gitignored .env dosyaları uygulaması ile birleştirildiğinde, bu size güvenli, doğrulanmış, ortama uygun konfigürasyon sağlar.
Ayarları tanımlamayı, DI yoluyla kullanmayı ve sırları güvenli bir şekilde yönetmeyi bilmek, production-ready FastAPI uygulamaları oluşturmak için temeldir.