რა არის Pydantic მოდელები FastAPI-ში?

Question

Accepted Answer

**Pydantic მოდელები** არის კლასები (რომლებიც ქვე-კლასიანებ `BaseModel`-ს), რომლებიც განსაზღვრავენ მონაცემების **სტრუქტურას, ტიპებსა და ვალიდაციის წესებს**. FastAPI იყენებს მათ ყველგან — მოთხოვნის სხეულებისთვის, პასუხის ფორმებისთვის და პარამეტრებისთვის — რაც მათ აქცევს მის ტიპ-ორიენტირებული დიზაინის გულად.

## მოდელის განსაზღვრა

```python
from pydantic import BaseModel, EmailStr, Field

class User(BaseModel):
    name: str
    email: EmailStr                          # validates email format
    age: int = Field(ge=0, le=120)            # constraint: 0 <= age <= 120
    is_active: bool = True                    # default value
    tags: list[str] = []                      # typed list with a default
```

თითოეული ველი აცხადებს ტიპს და ოპციონალურ შეზღუდვებს/სტანდარტებს. Pydantic ვალიდირებს მონაცემებს ამ განსაზღვრების წინააპირ და გარდაქმნის ტიპებს სადაც აზრი აქვს.

## ავტომატური ვალიდაცია და პარსირება

```python
@app.post("/users")
def create_user(user: User):                  # FastAPI builds & validates a User from the body
    return user                               # already validated here
# valid JSON → a typed User object; invalid → automatic 422 with field-level errors
```

როდესაც გამოიყენება როგორც პარამეტრის ტიპი, FastAPI აანალიზებს JSON მოთხოვნის სხეულს მოდელში, **ვალიდირებს** ყველა ველს და დაბრუნებს სტრუქტურირებულ 422 შეცდომას, რომელიც ზუსტად ჩამოთვლის რა არის არასწორი — ყველა ავტომატურად.

## რა აძლევს Pydantic-ი დამწერს

```text
✓ Validation — type checks + constraints (lengths, ranges, formats), clear errors
✓ Parsing/coercion — "5" → 5, ISO string → datetime, etc.
✓ Serialization — model.model_dump() / model_dump_json() → dict/JSON
✓ Editor support — full autocomplete & type checking on model attributes
✓ Self-documenting — the model defines the schema used in the auto-generated docs
```

## ერთიანი ჭეშმარიტების წყარო

```text
One Pydantic model drives: request validation, the response schema, the OpenAPI docs,
and typed access in your code → define the data shape ONCE.
```

## რატომ მნიშვნელოვანია ეს

Pydantic მოდელები FastAPI-ს ქვაკუთხედია — ეს არის ის, თუ როგორ განსაზღვრავთ და ვალიდირებთ მონაცემებს, რომელსაც თქვენი API იღებს და აბრუნებს, და თითქმის ყველა FastAPI ფუნქცია მათში გადის.

მათი გაგება აუცილებელია, რადგან ისინი უზრუნველყოფენ ავტომატური **ვალიდაცია** (კრიტიკული უსაფრთხოების და სიმტკიცისთვის — არასოდეს დაუწერლი შეყვანის ნდობა), პარსირება/იძულება, სერიალიზაცია და რედაქტორის მხარდაჭერა, ყველა ერთიანი დეკლარაციული კლასიდან.

ისინი ემსახურებიან როგორც **ერთიანი ჭეშმარიტების წყარო**: ერთი მოდელი იღებს მოთხოვნის ვალიდაციას, პასუხის ფორმას და ავტომატურად გენერირებულ დოკუმენტაციას.

ეს ტიპ-ორიენტირებული, ვალიდაციით-ნაგულისხმევი მიდგომა — მტკიცე შეყვანის ვალიდაციისა და ნათელი შეცდომის შეტყობინებების მიღება არსებითად უფასოდ — არის მნიშვნელოვანი მიზეზი იმისა, რომ FastAPI იმდენად პროდუქტიული და უსაფრთხო, რაც აქცევს Pydantic მოდელებს ფუნდამენტურ, აუცილებელ-ათვისებული ცოდნად.