FastAPI-app - GitLite

KO | EN

gitlite — search

#react #ai #llm #golang #go #android #rust #deep-learning #linux #docker #java #ios #mcp #openai

FastAPI-app

(★ 107)

Example app using FastAPI, asyncio, SQLModel, Celery, Alembic and Supertokens

파일 탐색기

최종 버전 다운로드 (.zip)

- - __init__.py
  - calculate_event_documentation.py
- - __init__.py
  - account.py
  - base.py
  - domain.py
  - event.py
  - event_documentation.py
  - event_documentation_example.py
  - event_schema.py
  - screenshot.py
  - user.py
- - env.py
  - README
  - script.py.mako
- - __init__.py
  - account.py
  - base.py
  - base_file.py
  - domain.py
  - event.py
  - event_documentation.py
  - event_documentation_example.py
  - event_schema.py
  - screenshot.py
  - user.py
- - __init__.py
- - __init__.py
  - account.py
  - base.py
  - domain.py
  - event.py
  - event_documentation.py
  - user.py
- - __init__.py
  - client.py
  - internal.py
  - web_app.py
- - __init__.py
  - init_supertokens.py
  - logger.py
  - route_handler.py
  - s3_client.py
  - singleton.py
- __init__.py
- celery.py
- config.py
- database.py
- dependencies.py
- main.py
.gitignore
.pre-commit-config.yaml
alembic.ini
LICENSE
Makefile
mypy.ini
poetry.lock
pyproject.toml
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/petrgazarov/FastAPI-app

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd FastAPI-app

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Python

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

pip install .

PyPI에 배포된 패키지를 바로 설치합니다. 소스 클론이 필요 없습니다.

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

파이썬 스크립트(또는 모듈)를 실행합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

3. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FastAPI App

This is a small app that I built while learning Python and FastApi. It allows to create documentations (shared schemas + screenshots) from tracking events. It also serves as a backend for an interface that lets a user register, sign in, set some settings and view documentations.

While building this app, I spent the most time learning the best practices of accomplishing common tasks in the FastAPI ecosystem. I tried out various libraries and arrived at the following list that I think work well together:

- FastAPI + Asyncio
- SQLModel for data models and validation
- Celery for background tasks
- Alembic for migrations
- Supertokens for user authentication
- Mypy for type checking
- Make for running commands

Additionally, the codebase showcases the following things:

- Multiple FastAPI apps in one project
- Alembic auto-generating migrations from model files
- Celery tasks communicating through an SQS FIFO queue
- AWS S3 integration for storing images
- Loggers that print SQL queries and other useful information
- Error handler middlewares
- CORS middleware
- Two separate types of authentication (static auth token for an internal endpoint + Supertokens for user authentication)
- Dependencies management using Poetry
- And more.

## Inspiration

I took a ton of inspiration from the following articles and projects:

[Abstracting FastAPI Services](https://camillovisini.com/article/abstracting-fastapi-services/)

[grillazz/fastapi-sqlalchemy-asyncpg](https://github.com/grillazz/fastapi-sqlalchemy-asyncpg)

[The ultimate async setup: FastAPI, SQLModel, Alembic, Pytest](https://medium.com/@estretyakov/the-ultimate-async-setup-fastapi-sqlmodel-alembic-pytest-ae5cdcfed3d4)

## Project structure

The project is organized into the following directories and files:

| Directory/File Name | Description                                                                          |
| ------------------- | ------------------------------------------------------------------------------------ |
| background_tasks/   | Celery tasks                                                                         |
| crud/               | CRUD operations                                                                      |
| db/                 | Alembic migrations                                                                   |
| models/             | model files that combine data models and Pydantic schemas                            |
| schemas/            | Pydantic schemas for things other than data models (e.g. api requests and responses) |
| services/           | business logic                                                                       |
| subapps/            | FastAPI apps with each file containing a separate app                                |
| utils/              | utility functions                                                                    |
| celery.py           | Celery app                                                                           |
| config.py           | Pydantic settings                                                                    |
| database.py         | SQLAlchemy database engine and session                                               |
| dependencies.py     | FastAPI dependencies                                                                 |
| main.py             | main project file                                                                    |

## Running the project

### Prerequisites

- Python 3.10
- Supertokens account
- GitHub OAuth app (SuperTokens uses GitHub OAuth but that can easily be changed for another OAuth provider)
- AWS Account, an S3 bucket and an SQS queue
- PostgreSQL database

### Steps

1. Clone the repo
2. Change `sqlalchemy.url` in `alembic.ini` to point to your database
3. Use commands in Makefile to install dependencies and run migrations
4. Rename `.env.example` to `.env` and fill in the values
5. Run `make server` and `make worker` to start the web server and the Celery worker

## Pre-Commit Setup

If you are using this project then pre-commit setup would be very helpful for checking your codebase. In short, pre-commit is a tool that allows developers to define and apply automated checks to their code before they commit it to a version control system. You can find more info [here](https://pre-commit.com).

```commandline
pre-commit install

# for the first time, run on all files
pre-commit run --all-files
```

## License

MIT License