fastapi-tdd-docker

Learn how to build, test, and deploy a text summarization microservice with Python, FastAPI, and Docker

Table of Contents

• fastapi-tdd-docker
  • Table of Contents
  • About
    • Built With
  • Installation
    • Prerequisites:
    • 1. Clone the repository:
    • 2. Use Docker and Docker Compose
    • 3. Apply Migrations
  • Usage
  • Tests
  • Contributing

About

fastapi-tdd-docker is a code-along (with minor differences) to the course Test-Driven Development with FastAPI and Docker by Michael Herman.

Built With

• Docker & Docker Compose
• FastAPI

Installation

Prerequisites:

• Python 3.8+
• Docker
• Docker Compose

1. Clone the repository:

$ git clone https://github.com/imtanmoy/fastapi-tdd-docker.git && cd fastapi-tdd-docker

2. Use Docker and Docker Compose

$ docker-compose up -d --build

3. Apply Migrations

$ docker-compose exec web python app/db.py

Usage

$ docker-compose up -d

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

Tests

$ docker-compose exec web python -m pytest

Unit Tests with Monkey-patching:

$ docker-compose exec web pytest -k "unit" -n auto

Contributing

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

Please see the original repo for details.