Conas a bhainistíonn tú socruithe le Pydantic?

Question

Accepted Answer

Bainistíonn feidhmchlár FastAPI cumrasc le **`pydantic-settings`** (`BaseSettings`) — rang a léann cumrasc ó **athróga timpeallachta** (agus comhaid `.env`) le **bailíochtú agus tiontú cineál**, ag coimeád rúnda as an gcód agus ag bainfeoil go bhfuil an cumrasc ceart ag tosú.

## Socruithe a shainiú

```python
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
```

Léann `BaseSettings` go foluain gach réimse ó **athróg timpeallachta** dhíreach (m.sh. `DATABASE_URL`), tiontaíonn sé cineálacha (`"true"` → `bool`, `"10"` → `int`), agus **bailíochtaíonn** — theipeann ar luach riachtanach ar iarraidh nó ar chineál mícheart láithreach ag tosú le earráid shoiléir (fail-fast).

## Socruithe a úsáid (trí ionchur spleáchais)

```python
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}
```

Ag instealladh socruithe trí spleáchais cuimhnithe déanann siad **inbhreithnithe** (sáraigh i dtrialacha) agus cinntíonn gur ní ann ach aon chás amháin.

## An comhad .env agus rúnda

```bash
# .env — local config, GITIGNORED (never commit secrets)
DATABASE_URL=postgresql://localhost/mydb
SECRET_KEY=dev-secret
DEBUG=true
```

```text
✓ 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)
```

## Cén fáth a bhfuil sé tábhachtach

Is **riachtanas oibríochtúil** an bhainistiú socruithe cheart (bíonn gá do dhifir-chumrasc ag feidhmchlár ar fud forbartha/stáisiúnú/táirgheadh) agus **riachtanas slándála** (ní mór dúnta cosúil le URLs bunachar agus eochracha a bheith i gcód foinse riamh — sárú coitianta agus tromchúiseach).

Soláthraíonn `BaseSettings` de Pydantic an réiteach idiomatic FastAPI, agus tá sé tábhachtach a thuiscint gach lá.

A phríomhbhuntáistí: cumrasc a léamh ó **athróga timpeallachta** (ag coimeád rúnda as an gcód, an cur chuige dhá dhosaen-fachtóir) le **tiontú cineál agus bailíochtú** uathoibríoch — mar sin theipeann ar dhrochumrasc go tapa ag tosú le earráid shoiléir seachas faillí mearbhall ag am iomlán.

In éineacht le ionchur spleáchais (socruithe inbhreithnithe agus singleton a dhéanamh) agus cleachtas comhad `.env` ar leathadh ag forbartha áitiúil, tugann sé duit cumrasc sábháilte, bailíochtaithe, agus timpeallacht-oiriúnach.

Bheith ar eolas conas a shainiú socruithe, agus iad a úsáid trí DI, agus rúnda a bhainistiú go slán tábhachtach ar bhunú feidhmchlár FastAPI réidh don táirgheadh.