MongoX
MongoX is an async python ODM (Object Document Mapper) for MongoDB which is built on top Motor and Pydantic.
The main features include:
- Fully type annotated
- Async support Python 3.7+ (since it's built on top of Motor)
- Elegant editor support (since it's built on top of Pydantic)
- Autocompletion everywhere, from object creation to query results
- Custom query builder which is more intuitive and pythonic
- 100% test coverage
MongoX models are at the same time Pydantic models and have the same functionalitties, so you can use them with your existing Pydantic models.
Documentation: https://aminalaee.github.io/mongox
Installation
$ pip install mongox
Quickstart
You can define mongox models the same way you define Pydantic models. The difference is they should inherit from mongox.Model now:
import asyncio
import mongox
client = mongox.Client(
"mongodb://localhost:27017", get_event_loop=asyncio.get_running_loop
)
db = client.get_database("test_db")
class Movie(mongox.Model):
name: str
year: int
class Meta:
collection = db.get_collection("movies")
Now you can create some instances and insert them into the database:
movie = await Movie(name="Forrest Gump", year=1994).insert()
The returned result will be a Movie instance, and mypy will understand that this is a Movie instance. So you will have type hints and validations everywhere:
Now you can fetch some data from the database.
You can use the same pattern as PyMongo/Motor:
movie = await Movie.query({"name": "Forrest Gump"}).get()
The returned result will be a Movie instance, and mypy will understand that this is a Movie instance.
This will have great IDE support, autocompletion and validation.
Or you can use Movie fields instead of dictionaries in the query (less room for bugs):
movie = await Movie.query({Movie.name: "Forrest Gump"}).get()
And finally you can use a more intuitive query (limited yet):
movie = await Movie.query(Movie.name == "Forrest Gump").get()
Notice how we omitted the dictionary and passed the Movie fields in comparison.
Please refer to the documentation here or the full examples here.
6 Oct 31, 2022
95 Jan 05, 2023
127 Oct 23, 2022
462 Dec 24, 2022
5 Dec 29, 2022
11k Jan 08, 2023
880 Jan 08, 2023
171 Dec 18, 2022
3 Nov 04, 2022
3.6k Jan 03, 2023
853 Dec 30, 2022
3.3k Dec 31, 2022
957 Dec 30, 2022
4 Jul 15, 2022
299 Nov 20, 2022
4.2k Jan 02, 2023
1.9k Jan 04, 2023
33 Dec 08, 2022
2 Jul 18, 2022