Skip to content

yezz123/FRDP

Repository files navigation

FRDP

Boilerplate code for quick docker implementation of REST API with JWT Authentication using FastAPI, PostgreSQL and PgAdmin.

Project setup

# clone the repo
$ git clone https://github.com/yezz123/FRDP

# move to the project folder
$ cd FRDP

Getting Started

Features

Auth Description
Login Access Token OAuth2 compatible token login, get an access token for future requests
Check Session Test if a user is logged in by checking if a valid access token is in the header
Recover Password Password Recovery
Reset Password Reset your password
User Description
Create New User Create a new user
Get Current User By Id Get current user
Update Current User Update own user
Update Other User (SuperUser) Update a user
Create User (Without Authentication) Create new user without the need to be logged in.

Environment variables

  • Using PostgreSQL as database server.

  • Using PgAdmin as database client.

  • Dockerized the Boilerplate code.

  • Drop your own Configuration at the docker-compose.env file.

# Backend API Configuration
PROJECT_NAME=
DOMAIN=

# Security Configuration
SECRET_KEY=
USERS_OPEN_REGISTRATION=
EMAIL_RESET_TOKEN_EXPIRE_HOURS=

# Server Settings
SERVER_NAME=
SERVER_HOST=

# Postgres default username and password
POSTGRES_USER=
POSTGRES_PASSWORD=
POSTGRES_DB=
POSTGRES_PORT=
POSTGRES_SERVER=

# PGADMIN_LISTEN_PORT=
PGADMIN_DEFAULT_EMAIL=
PGADMIN_DEFAULT_PASSWORD=

Development 🚧

Features

  • use hatch to manage dependencies.
  • use pytest to run tests.
  • GitHub Actions to run tests, lints.
  • Use Dependabot to keep dependencies up to date.
  • use pre-commit to manage formatting and linting.
    • use black to format code.
    • use ruff to lint code.
    • use isort to sort imports.

Setup environment 📦

You should create a virtual environment and activate it:

python -m venv venv/
source venv/bin/activate

And then install the development dependencies:

# Install dependencies
pip install -e .[test,lint]

Run tests 🌝

You can run all the tests with:

bash scripts/test.sh

Format the code 🍂

Execute the following command to apply pre-commit formatting:

bash scripts/format.sh

License

This project is licensed under the terms of the MIT license.