Skip to content

Commit 56f91fb

Browse files
Update README.md
1 parent e7926ec commit 56f91fb

File tree

1 file changed

+33
-4
lines changed

1 file changed

+33
-4
lines changed

README.md

Lines changed: 33 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,32 @@
11
<h1 align=center><strong>FastAPI Backend Application Template</strong></h1>
22

3+
<div align=center>
4+
<a href="https://github.com/Aeternalis-Ingenium/FastAPI-Backend-Template/actions/workflows/ci-backend.yaml">
5+
<img src="https://github.com/Aeternalis-Ingenium/FastAPI-Backend-Template/actions/workflows/ci-backend.yaml/badge.svg"/>
6+
</a>
7+
8+
<a href="https://codecov.io/gh/Aeternalis-Ingenium/FastAPI-Backend-Template">
9+
<img src="https://codecov.io/gh/Aeternalis-Ingenium/FastAPI-Backend-Template/branch/trunk/graph/badge.svg?token=1hiVayuLRl"/>
10+
</a>
11+
12+
<a href="https://github.com/pre-commit/pre-commit">
13+
<img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit" alt="pre-commit" style="max-width:100%;">
14+
</a>
15+
16+
<a href="https://github.com/psf/black">
17+
<img src="https://img.shields.io/badge/code%20style-black-000000.svg">
18+
</a>
19+
20+
<a href="https://pycqa.github.io/isort/">
21+
<img src="https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336">
22+
</a>
23+
24+
<a href="http://www.mypy-lang.org/static/mypy_badge.svg">
25+
<img src="https://camo.githubusercontent.com/59eab954a267c6e9ff1d80e8055de43a0ad771f5e1f3779aef99d111f20bee40/687474703a2f2f7777772e6d7970792d6c616e672e6f72672f7374617469632f6d7970795f62616467652e737667" alt="check with mypy" style="max-width:100%;">
26+
</a>
27+
</div>
28+
29+
<br>
330

431
This is a template repository aimed to kick start your project with a setup from a real-world application! This template utilizes the following tech-stack:
532

@@ -63,7 +90,7 @@ For the backend application:
6390
* API endpoints for `Account` signup and signin in `backend/src/api/routes/authentication.py`.
6491
* API endpoints for `Account` get all, get 1, update, and delete in `backend/src/api/routes/account.py`.
6592
* API endpoints registration file in `backend/src/api/endpoints`.
66-
* Password hashing, JWT for authorization, and simple verification functions in `backend/src/securities/**`.
93+
* Hashing and JWT generators and simple verification functions in `backend/src/securities/**`.
6794
* Helper functions, string messages, and error handling in `backend/src/utilities/**`.
6895
* A comprehensive FastAPI application initialization in `backend/src/main.py`.
6996

@@ -76,16 +103,18 @@ For the DevOps:
76103
* A simple linting job called `code-style` with black, isort, flake8, and mypy in `.github/workflows/ci-backend.yaml`.
77104
* An automated testing with `PyTest` and an automated test reporting with `Codecov` in in `.github/workflows/ci-backend.yaml`.
78105
* A source code responsibility distribution file in `.github/CODEOWNERS` (Please change the username into your own).
79-
* A `YAML` file for an automated semantic commit message.
106+
* A `YAML` file for an automated semantic commit message in `.github/workflows/ci-backend.yaml`.
107+
* An automated test report monitoring via `Codecov` in `codecov.yaml`
108+
* A CI for automatically updating all linter version in the pre-commit `YAML` file in `.pre-commit-config.YAML`.
80109

81110
For containerization:
82111
* A `Docker` configuration that utilizes the latest Python image in `backend/Dockerfile`.
83112
* A script that ensure the backend application will restart when postgres image hasn't started yet in `backend/entrypoint.sh`.
84113
* Setting up `Postgres` image for our database server, `Adminer` for our database editor, and `backend_app` for our backend application's container in `docker-compose.yaml`.
85114

86115
For the team development environment:
87-
* A pre-commit hooks for `Black`, `Isort`, and `MyPy` to ensure the conventional commit message before pushing an updated code into the remote repository.
88-
* All secret variables are listed in `.env.example`.
116+
* A pre-commit hooks for `Black`, `Isort`, and `MyPy` to ensure the conventional commit message before pushing an updated code into the remote repository in `.pre-commit-config.YAML`.
117+
* All secret variables are listed in `.env.example`. You need to copy these variables and set the values respectively to yoour need and save them in a new `.env` in the the root directory.
89118

90119
## Setup Guide
91120

0 commit comments

Comments
 (0)