Saltar al contenido principal
Intermedio⏱ 30 minutos
Prerequisitos: Funciones · Módulos y Paquetes
Módulo 08: Herramientas ProfesionalesLección 2 de 5
40% completado

Entornos Virtuales en Python

🗺️ Mapa de la Lección

⏱ 30 minutos🟡 Intermedio

🎯 Qué aprenderás

  • Crear y activar entornos virtuales
  • Instalar paquetes en entornos aislados
  • Usar requirements.txt para dependencias
  • Gestionar múltiples proyectos sin conflictos
  • Aplicar buenas prácticas de entornos virtuales

🌍 Para qué te sirve

  • Aislar dependencias entre proyectos
  • Evitar conflictos de versiones
  • Reproducibilidad: compartir versiones exactas
  • Desarrollo limpio: no contaminar Python del sistema
  • CI/CD: crear entornos limpios para builds
  • Colaboración: todos usan las mismas versiones

🎯 ¿Por qué aprender entornos virtuales?​

Imagina este escenario: Tienes dos proyectos:

  • Proyecto A necesita pandas==1.2.0
  • Proyecto B necesita pandas==2.0.0

Si instalas pandas globalmente, solo puedes tener una versión. ¿Qué haces?

Los entornos virtuales son esenciales porque:

  • Aíslan dependencias: cada proyecto tiene sus propios paquetes
  • Evitan conflictos: diferentes versiones en diferentes proyectos
  • Reproducibilidad: compartes versiones exactas con tu equipo
  • Limpieza: no contaminas Python del sistema
  • Profesionalismo: estándar en todos los proyectos Python

Sin entornos virtuales, los conflictos de versiones y la contaminación del sistema Python causarían problemas constantes.

🌍 Casos reales donde se usa​

Los entornos virtuales están en todos los proyectos Python profesionales:

  • Aislar dependencias: Cada proyecto con sus propios paquetes
  • Evitar conflictos: Diferentes versiones en diferentes proyectos
  • Reproducibilidad: Compartir versiones exactas con el equipo
  • Desarrollo limpio: No contaminar Python del sistema
  • CI/CD: Crear entornos limpios para builds
  • Colaboración: Todos usan las mismas versiones

Ejemplo real: Un proyecto web usa Django 3.2 y otro usa Django 4.0. Con entornos virtuales, ambos pueden coexistir sin conflictos.

💡 Concepto base​

Los entornos virtuales crean un "mundo" aislado de Python para cada proyecto. Cada entorno tiene sus propios paquetes instalados, independientes del sistema y de otros proyectos.

Lo genial de Python: El módulo venv está incluido en Python 3.3+ y es muy fácil de usar.

# Crear entorno virtual
python -m venv mi_entorno

# Activar (Linux/Mac)
source mi_entorno/bin/activate

# Activar (Windows)
mi_entorno\Scripts\activate

# Instalar paquetes (solo en este entorno)
pip install pandas

# Desactivar
deactivate
Resultado esperado:
# Después de activar, verás el nombre del entorno en tu prompt
(mi_entorno) usuario@maquina:~/proyecto$
🌮 Analogía culinaria

Los entornos virtuales son como tener diferentes cocinas para diferentes tipos de comida. En la cocina mexicana tienes especias y herramientas para chilaquiles al pastor, en la cocina italiana tienes ingredientes para pasta. Cada cocina (entorno virtual) tiene sus propios ingredientes (paquetes) sin mezclarse. No usas salsa de tomate italiana en los chilaquiles, ni chiles en la pasta. Cada proyecto tiene su propio "menú de ingredientes" aislado.

Para principiantes

Importante: Aprende esto temprano. Es fundamental y te ahorrará muchos dolores de cabeza. Cada proyecto debe tener su propio entorno virtual. Es la primera cosa que haces al empezar un proyecto nuevo.

Conceptos Básicos​

Crear y Activar Entornos​

Paso 1: Crear el entorno virtual

# Crear entorno virtual (crea una carpeta con Python y pip aislados)
python -m venv mi_entorno

Esto crea una carpeta mi_entorno/ con:

  • Una copia de Python
  • Una copia de pip
  • Espacio para instalar paquetes (aislado del sistema)

Paso 2: Activar el entorno

Una vez creado, debes "activarlo" para usarlo:

# En Windows (PowerShell o CMD)
mi_entorno\Scripts\activate

# En Unix/MacOS (Linux, macOS)
source mi_entorno/bin/activate

¿Cómo sabes que está activado? Verás el nombre del entorno al inicio de tu prompt:

(mi_entorno) usuario@computadora:~/proyecto$
#      ↑ Esto indica que el entorno está activo

Paso 3: Trabajar normalmente

Una vez activado, python y pip apuntan al entorno virtual, no al sistema:

pip install requests  # Se instala solo en este entorno
python mi_script.py   # Usa el Python del entorno

Paso 4: Desactivar cuando termines

deactivate  # Vuelves al Python del sistema

Flujo típico:

  1. python -m venv venv (crear)
  2. source venv/bin/activate (activar)
  3. Trabajar en tu proyecto
  4. deactivate (desactivar cuando termines)

Verificar Entorno​

# Ver Python actual
which python  # Unix/MacOS
where python  # Windows

# Ver paquetes instalados
pip list

# Ver ruta del entorno
echo $VIRTUAL_ENV

Gestión de Dependencias​

requirements.txt​

# requirements.txt
# Versiones exactas
requests==2.25.1
pandas==1.2.0

# Versiones mínimas
numpy>=1.19.0
scipy>=1.6.0

# Rangos de versiones
matplotlib>=3.3.0,<3.4.0

Instalar Dependencias​

# Instalar desde requirements.txt
pip install -r requirements.txt

# Instalar paquete específico
pip install nombre_paquete

# Instalar con versión específica
pip install nombre_paquete==1.2.3

# Actualizar paquete
pip install --upgrade nombre_paquete

Herramientas de Gestión​

pip-tools​

# Instalar pip-tools
pip install pip-tools

# Generar requirements.txt
pip-compile requirements.in

# Sincronizar entorno
pip-sync requirements.txt

poetry​

# pyproject.toml
[tool.poetry]
name = "mi_proyecto"
version = "0.1.0"
description = ""
authors = ["Tu Nombre <tu@email.com>"]

[tool.poetry.dependencies]
python = "^3.8"
requests = "^2.25.1"
pandas = "^1.2.0"

[tool.poetry.dev-dependencies]
pytest = "^6.0.0"
black = "^21.0.0"

Buenas Prácticas​

  1. Estructura de Proyecto
mi_proyecto/
├── .gitignore
├── README.md
├── requirements.txt
├── requirements-dev.txt
├── src/
│   └── mi_proyecto/
│       ├── __init__.py
│       └── main.py
└── tests/
    └── test_main.py
  1. Separación de Dependencias
# requirements.txt (producción)
requests==2.25.1
pandas==1.2.0

# requirements-dev.txt (desarrollo)
-r requirements.txt
pytest==6.0.0
black==21.0.0
flake8==3.9.0
  1. Versionado de Python
# Verificar versión de Python
python --version

# Crear entorno con versión específica
python3.8 -m venv mi_entorno

Ejemplos Avanzados​

Entorno para Desarrollo​

# Crear entorno
python -m venv dev_env

# Activar
source dev_env/bin/activate  # Unix/MacOS
dev_env\Scripts\activate     # Windows

# Instalar dependencias de desarrollo
pip install -r requirements-dev.txt

Entorno para Producción​

# Crear entorno
python -m venv prod_env

# Activar
source prod_env/bin/activate  # Unix/MacOS
prod_env\Scripts\activate     # Windows

# Instalar solo dependencias de producción
pip install -r requirements.txt

Script de Automatización​

#!/bin/bash
# setup_env.sh

# Crear entorno
python -m venv venv

# Activar entorno
source venv/bin/activate

# Actualizar pip
pip install --upgrade pip

# Instalar dependencias
pip install -r requirements.txt

# Instalar dependencias de desarrollo si es necesario
if [ "$1" == "dev" ]; then
    pip install -r requirements-dev.txt
fi

Herramientas de Desarrollo​

black​

# pyproject.toml
[tool.black]
line-length = 88
target-version = ['py38']
include = '\.pyi?$'

flake8​

# setup.cfg
[flake8]
max-line-length = 88
extend-ignore = E203
exclude = .git,__pycache__,build,dist

pytest​

# pytest.ini
[pytest]
testpaths = tests
python_files = test_*.py
python_functions = test_*

Consejos​

  1. Usa un entorno virtual por proyecto
  2. Mantén requirements.txt actualizado
  3. Especifica versiones exactas en producción
  4. Separa dependencias de desarrollo
  5. Documenta la configuración del entorno

Recursos Adicionales​

Documentación Oficial​

Bibliografía Recomendada​

  • Effective Python (Brett Slatkin) - Item 83: Know Where to Find Community-Built Modules
  • Python Tricks (Dan Bader) - Capítulo sobre entornos virtuales
  • The Hitchhiker's Guide to Python (Kenneth Reitz) - Sección sobre entornos virtuales
  • **Python Packaging User Guide](https://packaging.python.org/) - Guía oficial de empaquetado

Conceptos Relacionados​

Siguiente paso​

Ahora que sabes usar entornos virtuales, aprende a empaquetar y distribuir tu código. Continúa con: Empaquetado