Co se změnilo v Pydanticu v2 a proč na tom záleží pro FastAPI?

Question

Accepted Answer

**Pydantic v2** (velké přepsání s jádrem v **Rustu**) přineslo velké zlepšení výkonu a změny API. Protože je Pydantic ústředním prvkem FastAPI (validace, serializace, modely), pochopení v2 je důležité jak pro rychlost, tak pro psaní správného moderního kódu.

## Hlavní zpráva: mnohem rychleji (jádro v Rustu)

```text
Pydantic v2's validation core (pydantic-core) is written in RUST → typically
5–50x faster validation/serialization than v1.
→ Since FastAPI validates every request and serializes every response with Pydantic,
  this directly speeds up FastAPI apps.
```

Jde o nejdůležitější změnu — rychlejší validace znamená rychlejší FastAPI, bez nutnosti změn kódu mimo aktualizaci.

## Klíčové změny API (v1 → v2)

```python
# method renames
model.dict()        → model.model_dump()          # to a dict
model.json()        → model.model_dump_json()      # to JSON
Model.parse_obj()   → Model.model_validate()        # from a dict

# validator decorators renamed
@validator("field")      → @field_validator("field")    # + must be a @classmethod
@root_validator         → @model_validator(mode="after")  # cross-field

# config: a class Config → model_config dict
class Config: ...        → model_config = ConfigDict(...)
```

Běžné metody a dekorátory validátorů byly přejmenovány — důležité při čtení nebo psaní kódu, a při migraci kódů z v1.

## Přísnější, jasnější chování

```text
✓ Stricter type coercion by default (fewer surprising silent conversions)
✓ Clearer, more detailed validation errors
✓ Better support for strict vs lax modes, computed fields, serialization control
✓ pydantic-settings split into its own package (BaseSettings moved there)
```

## Proč to záleží speciálně na FastAPI

```text
FastAPI uses Pydantic for: request body validation, response_model serialization,
query/path validation, settings, and the OpenAPI schema. So Pydantic v2's:
  ✓ speed → faster request handling across the board
  ✓ API changes → you must use the v2 syntax (model_dump, field_validator, etc.)
  ✓ behavior → stricter, more predictable validation
Modern FastAPI versions require/use Pydantic v2.
```

## Proč to záleží

Rozmívání Pydanticu v2 je důležité pro vývojáře FastAPI, protože Pydantic je základem hlavních funkcí FastAPI (validace, serializace, modely, nastavení, dokumentace), takže jeho update na majorní verzi přímo ovlivňuje jak výkon, tak způsob psaní kódu.

Hlavní přínos — **jádro založené na Rustu poskytující 5–50× rychlejší validaci/serializaci** — přímo zrychluje aplikace FastAPI (které ověřují každý požadavek a serializují každou odpověď přes Pydantic), významný nárůst výkonu dosažený pouhým přechodem na v2.

Rovně tak důležité jsou **změny API**: přejmenované metody (`model_dump`/`model_validate`) a dekorátory validátorů (`field_validator`/`model_validator`) znamenají, že musíte použít moderní syntaxi pro psaní správného kódu, a rozpoznání těchto změn je nezbytné při čtení aktuálního kódu, psaní nového kódu nebo migraci starších kódů z v1 (běžná reálná úloha).

Přísnější a jasnější chování validace činí aplikace předvídatelnějšími.

Protože moderní verze FastAPI jsou postaveny na Pydanticu v2, znalost toho, co se změnilo — zlepšení výkonu, nové API a rozdíly v chování — je důležitá znalost na seniorské úrovni pro efektivní práci s aktuálním FastAPI, vyhýbání se zastaralým vzorům z v1 a pochopení, proč FastAPI funguje tak, jak funguje.

Odráží vědomí vyvíjející se základny frameworku a stává se stále relevantnější, jak se ekosystém standardizuje na v2.