Sobre las versiones de FastAPI¶
FastAPI ya se est谩 utilizando en producci贸n en muchas aplicaciones y sistemas. Y la cobertura de tests se mantiene al 100%. Pero su desarrollo sigue avanzando r谩pidamente.
Se a帽aden nuevas funcionalidades con frecuencia, se corrigen bugs 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 tener potencialmente cambios incompatibles. Esto sigue las convenciones de Semantic Versioning.
Puedes crear aplicaciones de producci贸n con FastAPI ahora mismo (y probablemente ya lo has estado haciendo desde hace alg煤n tiempo), solo debes asegurarte de que utilizas una versi贸n que funciona correctamente con el resto de tu c贸digo.
Fija tu versi贸n de fastapi¶
Lo primero que debes hacer es "fijar" la versi贸n de FastAPI que est谩s usando a la versi贸n espec铆fica m谩s reciente que sabes que funciona correctamente para tu aplicaci贸n.
Por ejemplo, digamos que est谩s utilizando 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 que 0.113.0, por ejemplo, una versi贸n 0.112.2 todav铆a ser铆a aceptada.
Si utilizas 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 (por ejemplo, para revisar cu谩l es la m谩s reciente) en las Release Notes.
Sobre las versiones¶
Siguiendo las convenciones del Semantic Versioning, cualquier versi贸n por debajo de 1.0.0 podr铆a potencialmente a帽adir cambios incompatibles.
FastAPI tambi茅n sigue la convenci贸n de que cualquier cambio de versi贸n "PATCH" es para correcci贸n de bugs y cambios no incompatibles.
Consejo
El "PATCH" es el 煤ltimo n煤mero, por ejemplo, en 0.2.3, la versi贸n PATCH es 3.
As铆 que deber铆as poder fijar a una versi贸n como:
fastapi>=0.45.0,<0.46.0
Los cambios incompatibles y nuevas funcionalidades se a帽aden en versiones "MINOR".
Consejo
El "MINOR" es el n煤mero en el medio, por ejemplo, en 0.2.3, la versi贸n MINOR es 2.
Actualizando las versiones de FastAPI¶
Deber铆as a帽adir tests para tu aplicaci贸n.
Con FastAPI es muy f谩cil (gracias a Starlette), revisa la documentaci贸n: Testing
Despu茅s de tener tests, puedes actualizar la versi贸n de FastAPI a una m谩s reciente, y asegurarte de que todo tu c贸digo est谩 funcionando correctamente ejecutando tus tests.
Si todo est谩 funcionando, o despu茅s de hacer los cambios necesarios, y todos tus tests pasan, entonces puedes fijar tu fastapi a esa nueva versi贸n m谩s reciente.
Sobre Starlette¶
No deber铆as fijar la versi贸n de starlette.
Diferentes versiones de FastAPI utilizar谩n una versi贸n m谩s reciente espec铆fica de Starlette.
As铆 que, puedes simplemente dejar que FastAPI use la versi贸n correcta de Starlette.
Sobre Pydantic¶
Pydantic incluye los tests para FastAPI con sus propios tests, as铆 que nuevas versiones de Pydantic (por encima de 1.0.0) siempre son compatibles con FastAPI.
Puedes fijar Pydantic a cualquier versi贸n por encima de 1.0.0 que funcione para ti.
Por ejemplo:
pydantic>=2.7.0,<3.0.0