О версиях FastAPI

FastAPI уже используется в производстве во многих приложениях и системах. И покрытие тестами поддерживается на 100%. Но его разработка всё ещё идёт быстро.

Новые функции добавляются часто, ошибки исправляются регулярно, и код постоянно улучшается.

Поэтому текущие версии всё ещё 0.x.x, это отражает, что каждая версия потенциально может содержать несовместимые изменения. Это соответствует соглашениям Семантического Верифицирования Версий.

Вы можете создавать приложения для производства с FastAPI прямо сейчас (и, вероятно, уже делаете это некоторое время), вам просто нужно убедиться, что вы используете версию, которая корректно работает с остальной частью вашего кода.

Зафиксируйте вашу fastapi версию

Первое, что вам следует сделать, это «зафиксировать» версию FastAPI, которую вы используете, на конкретной последней версии, которая, как вы знаете, правильно работает для вашего приложения.

Например, предположим, что вы используете версию 0.112.0 в своём приложении.

Если вы используете файл requirements.txt, вы можете указать версию следующим образом:

fastapi[standard]==0.112.0

это означало бы, что вы будете использовать именно версию 0.112.0.

Или вы также можете зафиксировать её так:

fastapi[standard]>=0.112.0,<0.113.0

это означало бы, что вы будете использовать версии 0.112.0 или выше, но меньше 0.113.0, например, версия 0.112.2 всё ещё будет принята.

Если вы используете любой другой инструмент для управления вашими установками, например uv, Poetry, Pipenv или другие, они все имеют способ определения конкретных версий для ваших пакетов.

Доступные версии

Вы можете увидеть доступные версии (например, чтобы проверить, какая последняя) в Записях о выпуске.

О версиях

В соответствии с соглашениями Семантического Верифицирования Версий любая версия ниже 1.0.0 потенциально может содержать несовместимые изменения.

FastAPI также следует соглашению, что любое изменение версии «PATCH» предназначено для исправления ошибок и неразрушающих изменений.

Поэтому вы должны иметь возможность зафиксировать версию, например:

fastapi>=0.45.0,<0.46.0

Несовместимые изменения и новые функции добавляются в версиях «MINOR».

Обновление версий FastAPI

Вы должны добавить тесты для своего приложения.

С FastAPI это очень легко (благодаря Starlette), смотрите документацию: Тестирование

После того, как у вас есть тесты, вы можете обновить версию FastAPI на более новую и убедиться, что весь ваш код работает правильно, запустив свои тесты.

Если всё работает или после внесения необходимых изменений и все ваши тесты проходят, вы можете зафиксировать вашу fastapi на эту новую последнюю версию.

О Starlette

Не нужно фиксировать версию starlette.

Разные версии FastAPI будут использовать конкретно более новую версию Starlette.

Поэтому вы можете просто позволить FastAPI использовать правильную версию Starlette.

О Pydantic

Pydantic включает тесты для FastAPI со своими собственными тестами, поэтому новые версии Pydantic (выше 1.0.0) всегда совместимы с FastAPI.

Вы можете зафиксировать Pydantic на любую версию выше 1.0.0, которая вам подходит.

Например:

pydantic>=2.7.0,<3.0.0