Entornos virtuales y pip

Un proyecto, un conjunto de bibliotecas

Los proyectos necesitan bibliotecas de terceros como numpy o pandas, y proyectos distintos necesitan versiones distintas. Instalarlo todo en un solo Python compartido hace chocar las versiones: actualizar para un proyecto rompe otro. Un entorno virtual es una carpeta privada con su propia copia del intérprete de Python y sus propias bibliotecas instaladas, de modo que cada proyecto tiene exactamente lo que necesita. pip es la herramienta que descarga e instala bibliotecas del Python Package Index (PyPI) en el entorno activo.

# Create an environment in the project folder (once)
python -m venv .venv

# Activate it (every new terminal)
source .venv/bin/activate        # macOS and Linux
.venv\Scripts\activate           # Windows

# The prompt now shows (.venv); python and pip belong to it
python -c "import sys; print(sys.prefix)"

# Leave it
deactivate

Instalar con pip

Con el entorno activo, pip install numpy añade una biblioteca, pip install numpy==1.26.4 fija una versión exacta, pip install -U numpy la actualiza y pip uninstall numpy la quita. pip list muestra lo instalado. Ante la duda, llámalo como python -m pip, que garantiza que pertenece al mismo Python que ejecutarás. Nunca uses sudo pip ni instales en el Python del sistema.

# Install, pin and inspect (environment active)
python -m pip install numpy pandas
python -m pip install "scipy>=1.11,<2"
python -m pip list

# Show one library
python -m pip show numpy

requirements.txt y reglas de versión

Un archivo de requisitos lista las bibliotecas que necesita un proyecto, una por línea, para que cualquiera pueda reconstruir el entorno con pip install -r requirements.txt; pip freeze > requirements.txt escribe las versiones exactas instaladas. Cada línea es un nombre más un especificador de versión opcional: ==1.26.4 (exactamente), >=2.0 (al menos), <3 (por debajo), !=2.1 (cualquiera menos) y ~=1.4.2 (compatible: al menos 1.4.2 pero aún 1.4.x). Las líneas que empiezan por # son comentarios. Las versiones se comparan como números, parte por parte, así que 1.10 es más nueva que 1.9, no más antigua.

# A version is a tuple of numbers, not a string
print("1.10" > "1.9")               # False  (text order is wrong!)

def version_tuple(text):
    return tuple(int(part) for part in text.split("."))

print(version_tuple("1.10") > version_tuple("1.9"))   # True
print(version_tuple("2.0.1"))                         # (2, 0, 1)

# Reading one requirements line
line = "numpy>=1.26  # for arrays"
name_and_spec = line.split("#", 1)[0].strip()
print(name_and_spec)                                  # numpy>=1.26

Hábitos que mantienen reproducibles los proyectos

Crea un entorno por proyecto y guárdalo dentro del proyecto como .venv, pero no lo subas al control de versiones: es grande y específico de tu máquina. Sube en su lugar requirements.txt (o pyproject.toml). Escribe reglas flexibles (>=) para lo que necesitas y fija versiones exactas (==) cuando debas reproducir resultados. Si algo falla, siempre puedes borrar .venv y reconstruirlo en un minuto desde el archivo de requisitos.

# requirements.txt
numpy==1.26.4          # pinned: reproduce results exactly
pandas>=2.0            # at least 2.0
scipy~=1.11.0          # 1.11.x, but not 1.12
# plotting waits until we need it

# Rebuild the environment anywhere
python -m venv .venv
python -m pip install -r requirements.txt

# Record what is installed right now
python -m pip freeze > requirements.txt

• python -m venv .venv y actívalo: un entorno por proyecto.
• python -m pip install name==version, pip install -r requirements.txt, pip freeze.
• Especificadores: ==, >=, <, !=, ~=; compara versiones como tuplas de números; sube los requisitos, no .venv.

A continuación: conceptos básicos de Git, para seguir cada cambio en tu código y volver atrás cuando algo se rompe.

Lab: qué se califica

• Leer una línea de requisitos con parse_requirement25 pts
• Leer un archivo de requisitos completo con parse_requirements25 pts
• Hacer comparables las versiones con version_tuple25 pts
• Comprobar una versión frente a una regla con satisfies25 pts