How beanieodm/beanie works
Beanie is an asynchronous Python ODM for MongoDB using Pydantic models. Users initialize model classes against a database, then insert, find, update, and delete collection documents; the same API supports aggregation, links, views, union documents, bulk writes, lifecycle actions, and migrations. The graph separates model setup, query operations, persistence features, and model/field support. Relationships among unsampled modules are omitted unless the README or SOURCE INDEX supports them.
Main entry points: documents.py Documents · init.py Initialize models · find.py Find queries · update.py Update queries
Components 20
Model setup
- Initialize models
beanie/odm/utils/init.py - Model settings
beanie/odm/settings
Query operations
- Find interface
beanie/odm/interfaces/find.py - Find queries
beanie/odm/queries/find.py - Update queries
beanie/odm/queries/update.py - Aggregation queries
beanie/odm/queries/aggregation.py - Delete queries
beanie/odm/queries/delete.py - Query operators
beanie/odm/operators
Persistence features
- Lifecycle actions
beanie/odm/actions.py - Bulk writes
beanie/odm/bulk.py - Query cache
beanie/odm/cache.py - Data migrations
beanie/executors/migrate.py
Model support
- Documents
beanie/odm/documents.py - Fields and links
beanie/odm/fields.py - Database views
beanie/odm/views.py - Union documents
beanie/odm/union_doc.py - Document parsing
beanie/odm/utils/parsing.py - BSON encoding
beanie/odm/utils/encoder.py
Other components
- Application developer
- MongoDB
Connections 27
- Application developer → Initialize models: initializes
- Initialize models → MongoDB: inspects database
beanie/odm/utils/init.py - Initialize models → Documents: initializes classes
beanie/odm/utils/init.py - Initialize models → Database views: initializes views
beanie/odm/utils/init.py - Initialize models → Union documents: initializes unions
beanie/odm/utils/init.py - Initialize models → Model settings: configures models
beanie/odm/utils/init.py - Application developer → Documents: creates documents
- Documents → MongoDB: inserts and deletes
- Documents → Lifecycle actions: runs actions
beanie/odm/documents.py - Documents → Bulk writes: accepts bulk writer
beanie/odm/documents.py - Documents → Find interface: implements queries
beanie/odm/documents.py - Find interface → Find queries: creates find queries
beanie/odm/interfaces/find.py - Find queries → MongoDB: reads documents
- Find queries → Query cache: reads and writes cache
beanie/odm/queries/find.py - Find queries → Aggregation queries: creates aggregation
beanie/odm/queries/find.py - Find queries → Delete queries: creates delete query
beanie/odm/queries/find.py - Application developer → Update queries: requests updates
- Update queries → MongoDB: updates documents
beanie/odm/queries/update.py - Update queries → Bulk writes: queues operations
beanie/odm/queries/update.py - Update queries → Query operators: builds expressions
beanie/odm/queries/update.py - Fields and links → Documents: fetches linked documents
beanie/odm/fields.py - Find queries → Document parsing: parses results
beanie/odm/queries/find.py - Update queries → BSON encoding: encodes updates
beanie/odm/queries/update.py - Bulk writes → MongoDB: commits batch
beanie/odm/bulk.py - Database views → Aggregation queries: uses aggregation
- Union documents → Find interface: provides find interface
beanie/odm/union_doc.py - Application developer → Data migrations: runs migrations