Što se promijenilo u Pydantic v2 i zašto je to važno za FastAPI?

Question

Accepted Answer

**Pydantic v2** (najveće prepisivanje sa jezgrom u **Rust**-u) donijelo je velike dobitke u performansama i API promjene. Budući da je Pydantic centralan za FastAPI (validacija, serijalizacija, modeli), razumijevanje v2 je važno za brzinu i pisanje ispravnog modernog koda.

## Glavna vijest: mnogo brže (Rust jezgra)

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

Ovo je najutjecajnija promjena — brža validacija znači brži FastAPI, bez promjena koda potrebnih osim nadogradnje.

## Ključne API promjene (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(...)
```

Obične metode i dekoratori validatora su preimenovani — važno pri čitanju ili pisanju koda, i pri migraciji v1 kodova.

## Stroža, jasnija ponašanja

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

## Zašto je ovo važno specifično za 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.
```

## Zašto je važno

Razumijevanje Pydantic v2 je važno za FastAPI programere jer je Pydantic temelj FastAPI-jevih temeljnih mogućnosti (validacija, serijalizacija, modeli, postavke, dokumentacija), pa njegova glavna verzija promjena izravno utječe na brzinu i na načini na koje pišete kod.

Glavna korist — **Rust-bazirana jezgra koja pruža 5–50x bržu validaciju/serijalizaciju** — izravno ubrzava FastAPI aplikacije (koje validiraju svaki zahtjev i serijaliziraju svaki odgovor kroz Pydantic), značajni dobitak u performansama postignut samo nadogradnjom na v2.

Jednako važne su **API promjene**: preimenovane metode (`model_dump`/`model_validate`) i dekoratori validatora (`field_validator`/`model_validator`) znače da morate koristiti modernu sintaksu za pisanje ispravnog koda, i prepoznavanje tih promjena je bitno pri čitanju trenutnog koda, pisanju novog koda ili migraciji starijih v1 kodova (česti stvarni zadatak).

Stroža, jasnija ponašanja validacije čine aplikacije predvidivijima.

Budući da su moderne FastAPI verzije izgrađene na Pydantic v2, znanje o tome što se promijenilo — dobitci u performansama, novi API, i razlike u ponašanju — je važno znanje razine seniora za efikasno rada sa trenutnim FastAPI, izbjegavanja zastarjelih v1 obrazaca, i razumijevanja zašto FastAPI funkcionira kako funkcionira.

Odražava svjesnost o evolucijskoj osnovi okvira i postaje sve relevantnija kako se ekosistem standardizira na v2.