fastapi-template - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #typescript #golang #go #android #deep-learning #docker #nodejs #java #kubernetes #vue #awesome-list #open-source

fastapi-template

(★ 129)

A FastAPI and SQLAlchemy project template with Docker and GitHub Actions.

File Explorer

Download Latest Version (.zip)

- docker-compose.yml
- - code-integration.yml
- - __init__.py
  - env.py
  - script.py.mako
- __init__.py
- Dockerfile
- logging.conf
- main.py
- repository.py
- test_all.py
.dockerignore
.gitignore
.pre-commit-config.yaml
alembic.ini
docker-compose.yml
LICENSE
Makefile
poetry.lock
pyproject.toml
README.md

# Installation Guide

1. Get the code

git clone https://github.com/Donnype/fastapi-template

Downloads the entire project code from GitHub to your computer.

cd fastapi-template

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

docker compose -f .ci/docker-compose.yml up -d --build

Runs the command against the services defined in the compose file.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

3. Python

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

$ poetry run alembic upgrade head && poetry run uvicorn api.main:app --port 5000 --reload

Type this command into your terminal and run it.

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

4. Make

Medium

Prerequisites

Git Needed to download the project code from GitHub.
Make Usually pre-installed on Linux/macOS. On Windows, install separately (e.g. via MSYS2 or WSL).

make

Compiles the code based on the generated build configuration to produce an executable.

✅ If it finishes without errors, it worked. Try running the generated executable directly.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Fastapi Project Template

A FastAPI project template using Make, Docker Compose and Github Actions,
that includes **SQLAlchemy**, **Alembic** and an integration test setup.

[![Code Integration](https://github.com/bitestreams/fastapi-template/actions/workflows/code-integration.yml/badge.svg)](https://github.com/bitestreams/fastapi-template/actions/workflows/code-integration.yml)

##  Installation

The only requirements to develop are **Docker** and **Make**.
Docker makes it easy to get started and enables easier switching between projects, operating systems and machines.

To start up the project locally you first clone the project, and then run the following command in the cloned directory:
```sh
$ git clone https://github.com/Donnype/fastapi-template.git
$ cd fastapi-template
$ make up
```
Then to update the schema using alembic, in another shell:
```sh
$ make migrate
```
**That's it**. The app is set up and should be running at [localhost:5000/docs](localhost:5000/docs).
Code changes are automatically detected using a mounted docker volume.

### Makefile

---
The Makefile is the 'entrypoint' for the tools in this structure,
such that you can easily run different commands without remembering the exact arguments.
Run `make help` to get an overview of the available commands:
```sh
$ make help
up:
 Run the application
done: check test
 Prepare for a commit
test: utest itest
 Run unit and integration tests
utest: cleantest
 Run unit tests
itest: cleantest
 Run integration tests
check: cleantest
 Check the code base
cleantest:
 Clean up test containers
migrations:
 Generate a migration using alembic
migrate:
 Run migrations upgrade using alembic
downgrade:
 Run migrations downgrade using alembic
help:
 Display this help message
```

Make allows you to collect common scripts and commands for the project.
Other projects using different programming languages and frameworks get the same development interface by using Make.

---

### Installation without Docker
To install a local copy of the python environment (to get code-completion for example),
you must have **Poetry** installed.
Create a poetry environment by running `poetry install` at the root of the project.
To start up the server in the poetry environment and talk to a test sqlite database in `./test.db`, run
```bash
$ export DB_STRING=sqlite:///test.db/
$ poetry run alembic upgrade head && poetry run uvicorn api.main:app --port 5000 --reload
```
Again, the app should be all set up and running at [localhost:5000/docs](localhost:5000/docs).

### Tests

---

The tests are containerized and the Docker setup can be found in the `.ci/` folder.
They are written using Pytest.
You can run the tests using:
```bash
$ make test
```
This runs the integration & unit tests.
If you want to run them separately, use `make itest` to run the integration tests and `make utest` to run the unit tests.

## Further reading

To read about the benefits of using this template,
check out [my blog post](https://bitestreams.com/blog/fastapi_template/).