La necesidad de entornos virtuales y reproducibilidad

Los proyectos de Python a menudo dependen de numerosas bibliotecas y paquetes externos. A medida que los proyectos crecen y evolucionan, gestionar estas dependencias puede volverse complejo. Dos aspectos críticos del desarrollo de Python son:

1. Entornos virtuales: espacios aislados que mantienen las dependencias del proyecto separadas de las instalaciones de Python en todo el sistema.

2. Reproducibilidad: garantizar que un proyecto se pueda configurar fácilmente y ejecutar de manera consistente en diferentes máquinas o entornos.

Las herramientas tradicionales como venv y pip se han utilizado durante mucho tiempo para estos fines, pero a menudo requieren múltiples pasos e intervención manual. Aquí es donde entra en juego Poetry, que ofrece una solución más ágil y sólida.

¿Por qué elegir la poesía?

La poesía ofrece varias ventajas sobre las herramientas tradicionales:

1. Flujo de trabajo simplificado: combina gestión de dependencias, empaquetado y publicación en una sola herramienta.

2. Resolución de dependencias: resuelve automáticamente dependencias y posibles conflictos.

3. Compilaciones reproducibles: garantiza entornos consistentes en diferentes máquinas.

4. Archivo de bloqueo: genera un archivo de bloqueo para el control exacto de la versión de todas las dependencias.

5. Aislamiento de proyectos: crea y administra entornos virtuales automáticamente.

6. Comandos intuitivos: ofrece una CLI fácil de usar para tareas comunes.

Instalación y configuración de poesía

curl -sSL https://install.python-poetry.org | python3 -

Después de la instalación, agregue Poetry a su RUTA agregando la siguiente línea a su archivo de configuración de shell (por ejemplo, ~/.bashrc o ~/.zshrc):

export PATH="$HOME/.local/bin:$PATH"

Reinicie su terminal o ejecute source ~/.bashrc (o el archivo apropiado) para aplicar los cambios.

Verifique la instalación ejecutando:

poetry --version

Habilitar la finalización de pestañas para Bash, Fish o Zsh

poetry admite la generación de scripts de finalización para Bash, Fish y Zsh.

Intento

poetry completions bash >> ~/.bash_completion

Pez

poetry completions fish > ~/.config/fish/completions/poetry.fish

Zsh

poetry completions zsh > ~/.zfunc/_poetry

Usando poesía

Creando un nuevo proyecto

Para crear un nuevo proyecto de Python con Poetry:

poetry new my-project
cd my-project

Esto crea un nuevo directorio con una estructura básica del proyecto, incluido un archivo pyproject.toml.

Agregar dependencias

Para agregar una nueva dependencia:

poetry add requests

Esto agrega el paquete a su archivo pyproject.toml y lo instala en el entorno virtual.

Gestión de dependencias

Ver paquetes instalados:

poetry show

Actualizar todos los paquetes:

poetry update

Eliminar un paquete:

poetry remove requests

Ejecución de secuencias de comandos

Ejecutar scripts de Python dentro del entorno virtual del proyecto:

poetry run python your_script.py

Gestión del entorno virtual

Activar el entorno virtual:

poetry shell

Desactivarlo:

exit

Construcción y publicación

Construye tu proyecto:

poetry build

Publicar en PyPI:

poetry publish

Requisitos de exportación

Generar un archivo de requisitos.txt:

poetry export -f requirements.txt --output requirements.txt

Conclusión

Poetry simplifica la gestión de proyectos Python al proporcionar una herramienta unificada para la gestión de dependencias, entornos virtuales y empaquetado. Su interfaz intuitiva y sus potentes funciones lo convierten en una excelente opción para los desarrolladores de Python que buscan optimizar su flujo de trabajo y garantizar la reproducibilidad del proyecto.