Acerca de las versiones de FastAPI¶

FastAPI ya se está usando en producción en muchas aplicaciones y sistemas. Y la cobertura de pruebas se mantiene en 100%. Pero su desarrollo sigue avanzando rápidamente.

Se agregan nuevas características con frecuencia, los errores se corrigen regularmente, y el código sigue mejorando continuamente.

Por eso las versiones actuales siguen siendo 0.x.x, esto refleja que cada versión podría potencialmente tener cambios disruptivos. Esto sigue las convenciones de Versionado Semántico.

Puedes crear aplicaciones en producción con FastAPI ahora mismo (y probablemente lo has estado haciendo por algún tiempo), solo tienes que asegurarte de usar una versión que funcione correctamente con el resto de tu código.

Fija tu versión de fastapi¶

Lo primero que deberías hacer es "fijar" la versión de FastAPI que estás usando a la última versión específica que sabes que funciona correctamente para tu aplicación.

Por ejemplo, digamos que estás usando la versión 0.112.0 en tu aplicación.

Si usas un archivo requirements.txt podrías especificar la versión con:

fastapi[standard]==0.112.0

eso significaría que usarías exactamente la versión 0.112.0.

O también podrías fijarla con:

fastapi[standard]>=0.112.0,<0.113.0

eso significaría que usarías las versiones 0.112.0 o superiores, pero menores a 0.113.0, por ejemplo, una versión 0.112.2 todavía sería aceptada.

Si usas cualquier otra herramienta para gestionar tus instalaciones, como uv, Poetry, Pipenv, u otras, todas tienen una forma que puedes usar para definir versiones específicas para tus paquetes.

Versiones disponibles¶

Puedes ver las versiones disponibles (ej. para revisar cuál es la última actual) en las Notas de la Versión.

Acerca de las versiones¶

Siguiendo las convenciones de Versionado Semántico, cualquier versión inferior a 1.0.0 podría potencialmente agregar cambios disruptivos.

FastAPI también sigue la convención de que cualquier cambio de versión "PATCH" es para correcciones de errores y cambios no disruptivos.

Así que deberías poder fijar una versión como:

fastapi>=0.45.0,<0.46.0

Los cambios disruptivos y las nuevas características se agregan en versiones "MINOR".

Actualizar las versiones de FastAPI¶

Deberías agregar pruebas para tu aplicación.

Con FastAPI es muy fácil (gracias a Starlette), revisa la documentación: Pruebas

Después de tener pruebas, puedes actualizar la versión de FastAPI a una más reciente, y asegurarte de que todo tu código funciona correctamente ejecutando tus pruebas.

Si todo funciona, o después de hacer los cambios necesarios, y todas tus pruebas pasan, entonces puedes fijar tu fastapi a esa nueva versión reciente.

Acerca de Starlette¶

No deberías fijar la versión de starlette.

Diferentes versiones de FastAPI usarán una versión específica más reciente de Starlette.

Así que puedes simplemente dejar que FastAPI use la versión correcta de Starlette.

Acerca de Pydantic¶

Pydantic incluye las pruebas de FastAPI con sus propias pruebas, por lo que las nuevas versiones de Pydantic (superiores a 1.0.0) siempre son compatibles con FastAPI.

Puedes fijar Pydantic a cualquier versión superior a 1.0.0 que funcione para ti.

Por ejemplo:

pydantic>=2.7.0,<3.0.0