Откройте страницу, чтобы выполнить полный CRUD и проверить согласованность входной и выходной модели. Учебные товары хранятся в памяти одного процесса.
| Задача | Приём | Пример |
|---|---|---|
| Повторить CRUD | Path/query/body, модели, управляемые ошибки | Полный main.py |
| Понять изменение PATCH | Объединить поля и повторно проверить модель | Короткая карточка |
| Проверить ошибки и пароль | TestClient и независимые ожидаемые значения |
Полные тесты |
Карточки HTTP · Справочник FastAPI · Проверки
Уровень: базовый → средний. Для запуска нужны Python 3.14, FastAPI 0.162.0 и Pydantic 2.14.3.
Предпосылки: функции, типы, HTTP-методы.
В отдельном окружении выполните python -m pip install 'fastapi==0.162.0' 'uvicorn[standard]' 'pydantic[email]==2.14.3'.
Создайте полный файл main.py:
Запуск и запросы в другом терминале:
uvicorn main:app --reloadcurl -i -X POST http://127.0.0.1:8000/items -H 'Content-Type: application/json' -d '{"name":"Book","price":25,"tags":["python"]}'
curl 'http://127.0.0.1:8000/items?q=Book&tags=python&limit=5'
curl -i -X PATCH http://127.0.0.1:8000/items/1 -H 'Content-Type: application/json' -d '{"price":30}'
curl -i http://127.0.0.1:8000/items/999Чтобы прочитать статус, заголовки и JSON из ответа, используйте пример с curl и jq.
Результат создания — 201 с id=1.
Выборка возвращает список из одного товара.
PATCH меняет цену на 30.
Запрос отсутствующего товара даёт 404.
Отрицательная цена и premium дешевле 100 дают 422.
DELETE возвращает 204 без тела.
Маршрут /user-preview демонстрирует фильтрацию пароля выходной моделью.
Маршрут не сохраняет пользователя и не является регистрацией.
Ограничения: данные живут до перезапуска в одном процессе.
Это хранилище не обеспечивает постоянство данных и конкурентный доступ.
Здесь float выбран для простоты.
Для точных денежных расчётов нужна отдельно выбранная модель чисел.
PATCH сначала объединяет поля.
Затем PATCH повторно проверяет всю модель.
Сам по себе model_copy(update=...) не выполняет такую валидацию.
Явный null допускается только у полей итоговой модели, допускающих None.
Цена и налог должны быть конечными числами.
allow_inf_nan=False отклоняет бесконечность и NaN.
Число 1e999 может стать inf уже при разборе JSON.
Поэтому обработчик ошибки возвращает только loc, msg, type.
Обработчик исключает исходный input и ctx.
Эти значения сами могут не сериализоваться в JSON.
Тот же формат используется при повторной валидации PATCH.
Источники: ограничения параметров, Pydantic v2 validators, ограничения Field, обновление body, выходная модель, обработка ошибок.