/fastapi-motor-mongo-template

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

Primary LanguagePythonMIT LicenseMIT

Boilerplate for FastAPI, MongoDB, Motor Projects

Python3.11.2 MongoDB FastAPI Motor

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