pyodmongo

Documentation: https://pyodmongo.dev

Source Code: https://github.com/mauro-andre/pyodmongo

PyODMongo is a modern Python library that functions as a robust Object-Document Mapper (ODM) for MongoDB. Leveraging the power of Pydantic V2, it seamlessly bridges the gap between Python and MongoDB, offering an intuitive and efficient way to interact with MongoDB documents.

By using PyODMongo, you can effortlessly map your Python classes to MongoDB documents, allowing for a more Pythonic approach to handling data. This library simplifies the entire process of defining and working with MongoDB collections, documents, and queries.

PyODMongo is built on top of Pydantic V2, making the DbModel class an extension of Pydantic's BaseModel. This means that all the rich functionality of Pydantic's BaseModel, including Validators, Fields and Model Config, is readily available in DbModel.

Key Features

Integration with pydantic: Leverage the power of pydantic's data validation and modeling capabilities while working with MongoDB data.
Automatic Schema Generation: Define your MongoDB schema using pydantic models, and pyodmongo will automatically create the necessary MongoDB collections and ensure data consistency.
Query Builder: Easily construct complex MongoDB queries using Python code, reducing the need for writing raw query strings.
Document Serialization: Serialize and deserialize Python objects to and from MongoDB documents effortlessly.
Async Support: Take advantage of asynchronous programming with pyodmongo to enhance the performance of your MongoDB operations.
Active Development: pyodmongo is actively developed and maintained, with new features and improvements being regularly added.

Installation

You can install pyodmongo using pip:

pip install pyodmongo

Contributing

Contributions to pyodmongo are welcome! If you find any issues or have ideas for improvements, please open an issue or submit a pull request on the GitHub repository.

License

pyodmongo is licensed under the MIT License. See the LICENSE file for more information.

Async exemple

from pyodmongo import AsyncDbEngine, DbModel
from typing import ClassVar
import asyncio

engine = AsyncDbEngine(mongo_uri='mongodb://localhost:27017', db_name='my_db')


class Product(DbModel):
    name: str
    price: float
    is_available: bool
    _collection: ClassVar = 'products'


box = Product(name='Box', price='5.99', is_available=True)


async def main():
    result = await engine.save(box)

asyncio.run(main())

Sync exemple

from pyodmongo import DbEngine, DbModel
from typing import ClassVar

engine = DbEngine(mongo_uri='mongodb://localhost:27017', db_name='my_db')


class Product(DbModel):
    name: str
    price: float
    is_available: bool
    _collection: ClassVar = 'products'


box = Product(name='Box', price='5.99', is_available=True)

result = engine.save(box)

Metadata

Release files for pyodmongo 1.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyodmongo 1.7.0
File	Size	Uploaded
pyodmongo-1.7.0.tar.gz	759.4 kB	Aug 19, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for pyodmongo 1.7.0
File	Interpreter	ABI	Platform	Reset
pyodmongo-1.7.0-py3-none-any.whl 33.0 kB Aug 19, 2025	Python 3	none	any	Details

Total release size: 792.5 kB

Release files / pyodmongo-1.7.0.tar.gz

Download URL	pyodmongo-1.7.0.tar.gz
Size	759.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`6c36ef5f6ccf91ca9614fe16fcd2139eaa6f35633f6db3f59299e615ffa53060`
BLAKE2b-256 checksum How to use checksums	`5bcb11369e305a16091312cd8ff2932b374ad1444cd6c947e9004c81b6a99914`
Upload date	Aug 19, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.11.13`

Release files / pyodmongo-1.7.0-py3-none-any.whl

Download URL	pyodmongo-1.7.0-py3-none-any.whl
Size	33.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ef2ab67b07f31cf8e0e403b792601aa10cad3463cc59d266144783fdf22320a8`
BLAKE2b-256 checksum How to use checksums	`0c64ed0b54ccb43842214cc2a8acb1dd2d7843170b301ef304cc9335b3861737`
Upload date	Aug 19, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.11.13`