Tutorial-Codebase-Knowledge/docs/Pydantic Core/index.md

Tutorial: Pydantic Core

Pydantic Core provides the fundamental machinery for data validation, parsing, and serialization in Pydantic. It takes Python type hints and uses them to define how data should be structured and processed. Users typically interact with it by defining classes that inherit from BaseModel, which automatically gets validation and serialization capabilities based on its annotated fields. Pydantic Core ensures data conforms to the defined types and allows converting between Python objects and formats like JSON efficiently, leveraging Rust for performance.

Source Repository: https://github.com/pydantic/pydantic/tree/6c38dc93f40a47f4d1350adca9ec0d72502e223f/pydantic

flowchart TD
    A0["BaseModel"]
    A1["Fields (FieldInfo / Field function)"]
    A2["Core Schema & Validation/Serialization"]
    A3["Configuration (ConfigDict / ConfigWrapper)"]
    A4["Custom Logic (Decorators & Annotated Helpers)"]
    A5["TypeAdapter"]
    A0 -- "Contains and defines" --> A1
    A0 -- "Is configured by" --> A3
    A0 -- "Applies custom logic via" --> A4
    A1 -- "Is converted into" --> A2
    A3 -- "Configures core engine for" --> A2
    A4 -- "Modifies validation/seriali..." --> A2
    A5 -- "Uses core engine for" --> A2
    A5 -- "Can be configured by" --> A3

Chapters

1. BaseModel
2. Fields (FieldInfo / Field function)
3. Configuration (ConfigDict / ConfigWrapper)
4. Custom Logic (Decorators & Annotated Helpers)
5. Core Schema & Validation/Serialization
6. TypeAdapter

---

Generated by AI Codebase Knowledge Builder