fastapi-crudrouter-mongodb
⚡ Create CRUD routes with lighting speed ⚡</br> A dynamic FastAPI router that automatically creates CRUD routes for your Mongodb models
Documentation: https://pierrod.github.io/fastapi-crudrouter-mongodb-doc/
Source Code: https://github.com/pierrod/fastapi-crudrouter-mongodb
Credits :
-
Base projet and idea : awtkns
-
Convert _id to id (for previous versions of Pydantic) : mclate github guide
-
For Pydantic v2 : Stackoverflow
Are you exhausted from constantly rewriting basic CRUD routes? Do you find yourself needing to swiftly prototype features for presentations or hackathons? Well, rejoice! Introducing fastapi-crudrouter-mongodb, your ultimate solution.
As a complement to FastAPI’s APIRouter, the FastAPI CRUDRouter for MongoDB 🌱 takes care of the heavy lifting for you. It automatically generates and documents your CRUD routes with minimal effort. Simply provide your model and your database connection, and you’re good to go!
Installation
pip install fastapi-crudrouter-mongodb
Basic Usage
I will provide more examples in the future, but for now, here is a basic example of how to use the FastAPI CRUDRouter for Mongodb :seedling:.
```py linenums=”1” from typing import Annotated from fastapi import FastAPI from fastapi_crudrouter_mongodb import ( ObjectId, MongoObjectId, MongoModel, CRUDRouter, ) import motor.motor_asyncio
Database connection using motor
client = motor.motor_asyncio.AsyncIOMotorClient(“mongodb://localhost:27017/local”)
store the database in a global variable
db = client.local
Database Model
class UserModel(MongoModel): id: Annotated[ObjectId, MongoObjectId] | None = None name: str email: str password: str
Instantiating the CRUDRouter, and a lookup for the messages
a User is a model that contains a list of embedded addresses and related to multiple messages
users_router = CRUDRouter( model=UserModel, db=db, collection_name=”users”, prefix=”/users”, tags=[“users”], )
Instantiating the FastAPI app
app = FastAPI() app.include_router(users_router) ```
Advanced Usage
fastapi-crudrouter-mongodb offers several functionalities designed to maximize the benefits of your auto-generated CRUD routes. Here are some key highlights:
- Automatic Lookups
- Automatic Embeds
- Ability to provide Custom out schema
- Ability to Disable specific routes
- Ability to Add custom dependencies to specific routes
OpenAPI Support
“Automatic OpenAPI Documentation”
By default, the CRUDRouter automatically documents all generated routes in accordance with the OpenAPI specification.
The default routes generated by the CRUDRouter are displayed in the OpenAPI documentation generated by the system.
The CRUDRouter can dynamically generate comprehensive documentation based on the provided models.
