Skip to content

Commit 433c215

Browse files
committed
Readme added
1 parent ff5c750 commit 433c215

File tree

10 files changed

+116
-1
lines changed

10 files changed

+116
-1
lines changed

.idea/.gitignore

Lines changed: 3 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.idea/FastAPI-Boilerplate.iml

Lines changed: 12 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.idea/inspectionProfiles/Project_Default.xml

Lines changed: 12 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.idea/inspectionProfiles/profiles_settings.xml

Lines changed: 6 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.idea/misc.xml

Lines changed: 4 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.idea/modules.xml

Lines changed: 8 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.idea/sonarlint/issuestore/index.pb

Whitespace-only changes.

.idea/vcs.xml

Lines changed: 6 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

README.md

Lines changed: 65 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,65 @@
1-
# FastAPI-Boilerplate-jwt-logging-rbac-migrations-
1+
2+
# FastAPI Boilerplate
3+
4+
A dockerized FastAPI Boilerplate with JWT, Loguru logging, Role based authorization, SQLAlchemy ORM with AsyncSession.
5+
6+
Some endpoints are added as demo purpose, like: auth, register and login.
7+
8+
9+
## Dependencies
10+
In this project [poetry](https://python-poetry.org/) is used as package dependency manager. Below python packages are used in this project.
11+
12+
- python = "^3.9"
13+
- uvicorn = {version = "0.17.6", extras = ["standard"]}
14+
- fastapi = {version = "0.80.0", extras = ["all"]}
15+
- json-log-formatter = "0.4.0"
16+
- SQLAlchemy = "^1.4.40"
17+
- alembic = "^1.8.1"
18+
- databases = {extras = ["aiomysql"], version = "^0.6.1"}
19+
- loguru = "^0.6.0"
20+
- cryptography = "^38.0.1"
21+
- bcrypt = "^4.0.0"
22+
- PyJWT = "^2.5.0"
23+
24+
## How To Run Locally
25+
26+
Clone the project
27+
28+
```bash
29+
git clone https://github.com/theshohidul/FastAPI-Boilerplate.git
30+
```
31+
32+
Go to the project directory
33+
34+
```bash
35+
cd FastAPI-Boilerplate
36+
```
37+
38+
To run this project locally, go to `/docker` folder and edit `.env` file if required.
39+
Then open a terminal inside the `/docker` folder and run the below command in the terminal.
40+
41+
```bash
42+
docker compose up
43+
```
44+
After docker containers are up, you can access the application in: http://localhost:8080
45+
46+
Then exec inside the app container, and go to /app/core/db/migrations - run below command:
47+
```bash
48+
alembic upgrade head
49+
```
50+
51+
This will create all required tables.
52+
53+
## Contributing
54+
55+
Contributions are always welcome!
56+
57+
58+
## Authors
59+
60+
- [@theshohidul](https://github.com/theshohidul)
61+
62+
63+
## 🚀 About Me
64+
I'm a full stack developer...
65+

docker/.DS_Store

0 Bytes
Binary file not shown.

0 commit comments

Comments
 (0)