Учебник
Учебник ведёт от пустого каталога до сервиса со справочником, поиском, проверкой данных и правами доступа. Главы идут по порядку: каждая опирается на предыдущие, но её пример самостоятелен.
Каждая глава — работающий код. Файлы примеров лежат в каталоге examples/<глава>/ репозитория документации, рядом — тест, который поднимает пример на свободном порту и проверяет его по HTTP. Код на страницах совпадает с этими файлами символ в символ: это проверяет тест сайта. Данные в примерах хранятся в памяти процесса, чтобы примеры запускались без базы; где в настоящем приложении стоит ORM, глава это говорит.
| Глава | О чём |
|---|---|
| Первый сервис | сервер, роутер, корень модуля, документ OpenAPI |
| Структура приложения | каталоги модулей и ресурсов, где жить схемам и общему коду, циклические импорты |
| Ответы и ошибки | типовые ответы и ошибки, их схемы в OpenAPI |
| Ресурс из схемы данных | список, карточка, создание, правка и удаление записи |
| Вложенные маршруты | /items/{id}/…: значение из пути, общий контекст шагов, журнал запросов |
| Проверка входящих данных | тело запроса по схеме: обязательные поля, частичная правка, составные тела |
| Поиск и фильтры | строка запроса по схеме, фильтры и постраничный список |
| Авторизация и права | токен, текущий пользователь, проверка роли до обработчика |
| Веб-сокеты и события | WebSocket-точка и поток событий SSE |
Справочник по каждому декоратору — на страницах пакетов; рецепты рядом с учебником разбирают отдельные механизмы глубже.