FAST-Docs

Appearance

Pydantic ​

Pydantic is the most widely used data validation library for Python.

In standard Python, you can be pretty loose with data types. Pydantic changes that by using Python type hints to perform data validation and settings management. If the data doesn't match your schema, Pydantic raises an error; if it does match, it converts it into the correct type.

Everything in Pydantic starts with a class that inherits from BaseModel. This defines the "shape" of your data. Pydantic doesn't just check types; it fixes them when it can. If you define a field as an int but pass the string "42", Pydantic will automatically convert it to the integer 42.

It provides:

  • Data Integrity: You can be 100% sure the data inside your functions is valid.
  • Editor Support: Since it uses type hints, VSCode can provide excellent autocompletion and error highlighting.
  • JSON Integration: It has built-in methods to parse JSON strings and export models back to JSON.
  • Performance: The core of Pydantic is written in Rust, making it incredibly fast.

Installation ​

sh
pip install pydantic
sh
uv add pydantic
sh
micromamba install pydantic

Usage Example ​

python
from pydantic import BaseModel, EmailStr, Field
from typing import List, Optional

class User(BaseModel):
    id: int
    username: str
    email: EmailStr  # Validates email format automatically
    is_active: bool = True  # Default value
    tags: List[str] = []    # List of strings
    age: Optional[int] = Field(None, ge=0, le=120) # Age must be between 0 and 120

# 1. Successful validation (with type coercion)
external_data = {
    "id": "123",  # Note: this is a string, but will become an int
    "username": "coder_zero",
    "email": "hello@example.com",
    "age": 25
}

user = User(**external_data)

print(user.id)        # Output: 123 (as an integer)
print(user.model_dump()) # Converts the model back to a dictionary

If you pass invalid data (e.g., a bad email or a negative age), Pydantic provides a clear, structured error message:

python
from pydantic import ValidationError

try:
    User(id=1, username="ace", email="not-an-email")
except ValidationError as e:
    print(e.json()) # Returns a detailed explanation of why it failed

See more suitable examples on the official docs: https://pydantic.dev/docs/validation/latest/examples/files/