REST API библиотеки на FastAPI: каталог книг и авторов, регистрация читателей и учёт выдачи.
- Сайт: https://libraryapi-main.layero.app
- Документация: https://libraryapi-main.layero.app/api/docs
Небольшое демо-приложение: главная страница показывает, сколько книг и авторов в каталоге, а Swagger даёт попробовать запросы прямо в браузере. Книги и авторов можно читать без входа. Создавать записи, выдавать книги и заводить администраторов может только администратор.
Проект показывает REST API с ролями, JWT, связью «книга — авторы» и миграциями базы. Пароли в базе хранятся только как хеши.
- Python 3.11 — язык проекта.
- FastAPI — веб-фреймворк: маршруты, проверка данных, страница документации.
- Uvicorn — ASGI-сервер для запуска приложения.
- SQLAlchemy 2 — модели и запросы к базе.
- PostgreSQL — основная база; SQLite — для локального запуска и тестов.
- Alembic — миграции схемы базы.
- Pydantic — схемы запросов и ответов.
- JWT (python-jose) — вход и проверка токена.
- passlib + bcrypt — хеширование паролей.
- pytest + httpx — тесты API.
- ruff — линтер и сортировка импортов.
- Docker — запуск вместе с PostgreSQL.
- GitHub Actions — линт и тесты на каждый push.
- Откройте живое демо.
- На главной видно размер каталога и ссылки на документацию, список книг и список авторов.
- Нажмите Открыть Swagger, чтобы посмотреть и вызвать запросы. Документация живёт по адресу
/api/docs. - Списки книг и авторов открываются без входа:
/booksи/authors. - Чтобы отправить запрос от своего имени, зарегистрируйтесь через
POST /registerи в Swagger нажмите Authorize. - Новые книги, авторы и выдача книг доступны администратору.
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
Copy-Item .env.example .env
alembic upgrade head
uvicorn app.main:app --reloadСайт откроется на http://127.0.0.1:8000, документация — на http://127.0.0.1:8000/api/docs.
Демо-каталог (книги, авторы, demo_admin и demo_user):
$env:DEMO_ADMIN_PASSWORD = "<пароль админа>"
$env:DEMO_USER_PASSWORD = "<пароль читателя>"
python -m scripts.seed_demodocker compose up --buildAPI: http://localhost:8000.
pip install -r requirements-dev.txt
ruff check .
pytestТесты ходят в API через SQLite в памяти, отдельная база не нужна. На GitHub при каждом push запускаются линтер и тесты.