Async MongoDB with vanilla Pydantic v2+ - made easy.
Project description
Source code: https://github.com/volfpeter/motorhead
Documentation and examples: https://volfpeter.github.io/motorhead
Motorhead
Async MongoDB with vanilla Pydantic v2+ - made easy.
Key features:
- Database model and API design with vanilla
Pydantic
v2+. - Relationship support and validation using async validators and delete rules with a declarative, decorator-based syntax.
- ODM-like query builder for convenient, typed, and Pythonic query construction.
- Declarative index specification.
- Typed utilities for convenient model and API creation.
- Ready to use, customizable async service layer with transaction support that integrates all the above to keep your API and business logic clean, flexible, and easy to understand.
- Simplicity: by not being a classic ODM, the codebase is very simple and easy to understand (even contribute to) even for relative beginners.
By providing a convenient, declarative middle layer between MongoDB and your API, motorhead
is halfway between an object document mapper (based on vanilla Pydantic
) and a database driver (by wrapping the official, async motor
driver). What's missing is the built-in ODM performance and memory overhead, whose benefits are rarely felt when working with document databases.
See the full documentation here.
Installation
The library is available on PyPI and can be installed with:
$ pip install motorhead
Examples
See the documentation for usage and application examples.
Requirements
The project depends on motor
(the official asyncio MongoDB driver, which is built on top of pymongo
and bson
) and pydantic
v2+.
Development
Use black
for code formatting, mypy
for static code analysis, ruff
for linting, and pytest
(with pytest-asyncio
and pytest-docker
) for testing.
The documentation is built with mkdocs-material
and mkdocstrings
.
Contributing
All contributions are welcome.
Notes
This project is the continuation of fastapi-motor-oil with support for Pydantic v2, among other improvements. Migration from fastapi-motor-oil
should be easy, but if you need help, just create an issue in the issue tracker.
License - MIT
The library is open-sourced under the conditions of the MIT license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for motorhead-0.2408.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e7c11745f20320c4e6fd11ff2d842f030adaf1ee4c8937407af0599ba297d33b |
|
MD5 | 961e40f9202144d471ae688ce900ce03 |
|
BLAKE2b-256 | 683d27978a4fe551c94c241da9f13fbcb4ccc132d77048fe17094bb928652b00 |