Example of FastAPI integration supported by almighty Pydantic with SQLAlchemy ORM and PostgreSQL connected via fastest Database Client Library for python/asyncio asyncpg.
Beside of using latest and greatest version of SQLAlchemy with it robustness, powerfulness and speed of asyncpg there is FastAPI (modern, fast (high-performance), web framework for building APIs with Python 3.8+ based on standard Python type hints.) already reviewed on thoughtworks and noted in Python Developers Survey 2021 Results as the fifth official annual Python Developers Survey, conducted as a collaborative effort between the Python Software Foundation and JetBrains.
To build , run and test and more ... use magic of make help to play with this project.
make helpand you receive below list:
build Build project with compose
clean Clean Reset project containers and volumes with compose
feed_db create database objects and insert data
format Format project code.
help Show this help
lint Lint project code.
migrate-apply apply alembic migrations to database/schema
migrate-create create new alembic migration
py-upgrade Upgrade project py files with pyupgrade library for python version 3.10
requirements Refresh requirements.txt from pipfile.lock
safety Check project and dependencies with safety https://github.com/pyupio/safety
slim-build with power of docker-slim build smaller and safer images
test Run project tests
up Run project with compose
It took me a while to find nice data set. Hope works of Shakespeare as example will be able to cover first part with read only declarative base configuration and all type of funny selects :) Data set is coming form https://github.com/catherinedevlin/opensourceshakespeare Next models were generated with https://github.com/agronholm/sqlacodegen And after some tweaking I got desired result
To deliver better user(developer) experience when watching logs with tons of information from few emitters (which are really needy on development stage) project is using rich library. Event with rich superpowers reading logs is not easy. Found rich really nice - but it took time to learn how to integrate it as logger object properly and keep it as singleton.
To address below needs:
- it is hard to find what I am looking for even with glasses on.
- don’t want to hire ELK to be able to use logs.
- want to move fast enough with debugging.
Below steps were done to integrate rich into project.
- Configure emitters with config.ini
- Eliminate duplicates i.e. sqlalchemy echo by separate handlers
- Keep logger as singleton pattern to avoid multiple instances
- add uvicorn parameter --log-config config.ini
Hope you enjoy it.
- 4 JUN 2022 alembic migrations added to project
- 6 JUN 2022 added initial dataset for shakespeare models
- 3 OCT 2022 poetry added to project
- 12 NOV 2022 ruff implemented to project as linting tool
- 14 FEB 2023 bump project to Python 3.11
- 10 APR 2023 implement logging with rich
- 28 APR 2023 Rainbow logs with rich 🌈
pyenv install 3.11 && pyenv local 3.11poetry install