📋 Archivo requirements.txt para Python
El archivorequirements.txt es el estándar de la industria para especificar y gestionar dependencias en proyectos Python. Esta guía muestra cómo crear, configurar y usar requirements.txt para garantizar la consistencia entre los entornos de desarrollo y producción.
¿Qué es un archivo requirements.txt?
Un archivorequirements.txt lista todos los paquetes externos de Python que tu proyecto necesita, con sus versiones específicas. Esto permite:
- Que tú y tu equipo mantengan entornos idénticos
- Que los nuevos colaboradores reproduzcan el entorno exactamente
- Que el deploy en Square Cloud funcione con las dependencias correctas
1
Activa el entorno virtual
Trabajar dentro de un entorno virtual es esencial para mantener las dependencias de tu proyecto aisladas del sistema Python global. Esto evita conflictos de versiones y garantiza la reproducibilidad.Activa tu entorno virtual con uno de los comandos de abajo, según tu sistema:Windows:macOS/Linux:
2
Lista las dependencias del proyecto
Opción A: Crearlo manualmente (Recomendado)
Crea un archivorequirements.txt en la raíz de tu proyecto y lista todos los paquetes externos con sus versiones:requirements.txt
Opción B: Generarlo automáticamente con pip freeze
Después de instalar las dependencias en tu entorno virtual, puedes generar el archivo automáticamente. Hay dos formas principales:Opción B1: Usarpip freeze (incluye todo)pipdeptree o pip freeze con filtrado (Recomendado)Para capturar SOLO las dependencias de tu proyecto (sin los paquetes auxiliares del entorno), usa:pipdeptree:Si estás trabajando en un entorno virtual (recomendado),
pip freeze funcionará perfectamente ya que el entorno estará aislado y contendrá solo las dependencias de tu proyecto.3
Revisa y valida las dependencias
Abre el archivo
requirements.txt en tu editor de texto y:- Revisa la lista de paquetes
- Elimina las dependencias innecesarias
- Actualiza las versiones según sea necesario
- Asegúrate de usar versiones exactas (con
==)
4
Instala las dependencias
Para instalar todas las dependencias listadas:Este comando garantiza que todos los colaboradores y los entornos de producción usen exactamente las mismas versiones.
5
Versiona y comparte
Con
requirements.txt listo, puedes:- Compartirlo con tu equipo
- Ponerlo bajo control de versiones (git)
- Asegurar que todos trabajen con las mismas versiones
- Simplificar el deployment en Square Cloud
requirements.txt se detecta automáticamente y todas las dependencias se instalan durante el build.💡 Buenas prácticas y consejos:
- Mantenlo actualizado: Revisa y actualiza
requirements.txtcon regularidad a medida que añades nuevas dependencias - Usa versiones exactas: Usa siempre
==en lugar de>,>=o ninguna versión para evitar sorpresas en producción - Revisa pip freeze: Si usas
pip freeze, revisa el archivo antes de confirmarlo, ya que puede incluir paquetes auxiliares innecesarios - Control de versiones: Confirma
requirements.txten git para rastrear los cambios de dependencias - Entorno aislado: Mantén un entorno virtual por proyecto para evitar conflictos globales
- Prueba localmente: Antes de hacer el deploy, prueba el archivo con
pip install -r requirements.txten un entorno nuevo
🚀 Próximos pasos
Con tu archivorequirements.txt configurado:
- Confírmalo en tu repositorio Git.
- Aloja tu proyecto en Square Cloud.
- Configura el deploy automático mediante GitHub.
- ¡Bienvenido al hosting profesional de aplicaciones Python!
requirements.txt bien estructurado es la base de cualquier aplicación Python exitosa, garantizando que tu aplicación funcione perfectamente en Square Cloud.
