Open Source · 2024

FlaskProject — Books REST API (reference)

Reference Flask + SQLAlchemy + Postgres + Alembic implementation of a Books CRUD API. Clean separation: routes / repository / models. OpenAPI docs, tests, Docker.

A teaching-grade Flask REST API: routes, repository, SQLAlchemy models, environment-based config (dev/test/prod), Alembic migrations, OpenAPI/Swagger UI, JSON error handling, unit + functional tests, ready-to-run docker-compose with Postgres.

Useful starting point for new Flask backends — the structural choices are deliberate and documented in the README.

Stack

Python, Flask, SQLAlchemy, PostgreSQL, Alembic, OpenAPI, Docker, pytest