Skip to content

Concepts

Ormdantic has a small number of concepts:

  • an Ormdantic database instance owns a connection URL and registered schema metadata;
  • Pydantic models become tables through @db.table(...);
  • Table handles perform CRUD, query, count, select, and bulk update operations;
  • relationships are explicit metadata derived from model fields and foreign keys;
  • loaders decide how related models are fetched;
  • sessions group writes in a unit of work;
  • migrations compare snapshots and live database reflection;
  • events let application code observe lifecycle points.

Read these pages when you need to understand how the pieces fit together before jumping into API reference.

  1. Database And Tables
  2. Field Types And Metadata
  3. Relationships
  4. Querying
  5. Loading Strategies
  6. Transactions And Sessions
  7. Migrations And Reflection
  8. Drivers