jerrychir / fastapi-motor-mongo-template

High-performance FastAPI backend boilerplate for real-world production, with mongo and pytest. Suitable for microservices.

Boilerplate for FastAPI, MongoDB, Motor Projects

Features

A new backend project created with this boilerplate provides:

• Asynchronous high-performance RESTful APIs built upon FastAPI framework.
• Asynchronous CRUD operations for a sample resource built upon Motor driver for MongoDB, providing high performance and efficiency.
• API documentation with Swagger UI.
• API testing with pytest and pytest-asyncio.
• Dockerfile for containerization and docker-compose support.
• Easy creation of new backend services with cookiecutter.
• Easy package menagement with Poetry.
• Health API for service health checking.
• Easy configuration with environment variables.
• Easy testing, develop running, docker build, docker-compose up and down with Makefile.
• Proper logging with ID masking.

Prerequisites

• Python 3.11+
• Poetry installed
• Docker installed
• GNU Make

Getting Started

Edit Environment Variables

Edit the .env file within the project folder.

Run Tests

make test

(This may not work at this time. Please use docker-compose instead.)

Build Docker Image

make docker-build

Docker-compose

make docker-compose-up
make docker-compose-down

Run Service Locally

make dev

This will create a MongoDB container as well. (This may not work at this time. Please use docker-compose instead.)

Check Swagger API Document

Go to http://localhost:8888/docs.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you.

Credit:

Forked from https://github.com/klee1611/cookiecutter-fastapi-mongo