douglaschalegre/fastapi-template

🔨 This is a template that serves as a kickstarter for a back-end API application. Implemented with FastAPI, Pydantic, SQLAlchemy with a layered architecture structure.

About 🧑🏻‍💻

This repository contains a simple API that serves as a kickstart for new projects using FastAPI, SQLAlchemy and PostgreSQL. It's built with a simple layered architecture, containing domain, service, repository and controller layers. With this layered architecture approach, it's possible to separate concerns and make the codebase more maintainable and scalable.

It's also possible to add more layers if responsibilities grow within a specific layer. That being said, it's important to keep in mind that layers should be as independent as possible, and the dependencies should always point inwards, otherwise, could lead to ciclic dependencies mainly because of Pydantic schemas.

• Main frameworks and packages:
  • FastAPI
  • SQLAlchemy (PostgreSQL database).

How to run 🏃🏻‍♂️‍➡️

Install Python

Install Python (version 3.10).

Set and activate virtual environment ⚙

In project folder, execute the following commands:

pip install pipenv
export PIPENV_VENV_IN_PROJECT="enabled"
mkdir .venv
pipenv shell
source .venv/Scripts/activate

Set environment variables ⚙

Create a .env file with the required environment variables see [.env.example]

Install required dependencies

Run the following installation command:

pipenv install --dev

Run server 🚀

On virtual environment, execute

pipenv run start

Documentation 📚

While running the server, one can access the API documentation.