pip install: usar herramientas de otros

La biblioteca estándar de Python es potente, pero el verdadero superpoder está en la comunidad. Hay más de 500,000 paquetes disponibles en PyPI (Python Package Index) — librerías que otros ingenieros han escrito, probado y publicado para que tú no tengas que reinventar la rueda. Pandas, requests, pytest, black, pyspark... todo se instala con pip.

Piensa en pip como la app store de Python. ¿Necesitas manipular tablas de datos? pip install pandas. ¿Necesitas llamar a una API? pip install requests. ¿Necesitas testear tu código? pip install pytest. En 10 segundos tienes herramientas que costaron miles de horas construir.

### Pero antes de instalar nada: ¿dónde van las librerías?

Antes de lanzarte a hacer pip install, necesitas entender un problema fundamental. Imagina que tienes dos proyectos en tu ordenador. El proyecto A necesita la librería "requests" versión 2.28. El proyecto B necesita "requests" versión 2.31. Si ambos usan la misma instalación de Python, están condenados a pelear por la versión. Alguien pierde.

Este es el equivalente a tener una cocina compartida donde dos chefs necesitan aceite de oliva — pero uno necesita virgen extra y el otro de girasol, y solo hay un hueco en la estantería. Si metes uno, el otro desaparece. La solución es que cada chef tenga SU propia despensa. En Python, esa despensa privada se llama entorno virtual (venv).

### Entornos virtuales: tu burbuja aislada

Un entorno virtual (venv) es una copia aislada de Python dentro de tu proyecto. Cada proyecto tiene su propio venv con sus propias librerías. Lo que instales en un venv no afecta a nada fuera de él. Es como tener un taller limpio para cada proyecto, sin que las herramientas de uno se mezclen con las del otro.

Ahora que ya sabes qué son los módulos (lección 6) y cómo funcionan los imports, esto te hará sentido completo: un venv es básicamente un directorio con una copia de Python y una carpeta vacía donde pip instalará las librerías. Cuando activas el venv, tu terminal "redirige" los comandos python y pip para que apunten a esa copia local en vez de a la instalación global del sistema.

### Crear y activar el venv — Windows vs Mac

Crear un venv es un comando. Activarlo es otro. El proceso es casi idéntico en ambos sistemas, con una diferencia clave: el comando de activación. A partir de ahora, ANTES de instalar cualquier librería con pip, siempre crearás y activarás un venv.

1# 🟦 Windows (PowerShell)
2
3# 1. Crea una carpeta para tu proyecto
4mkdir mi-proyecto-datos
5cd mi-proyecto-datos
6
7# 2. Crea el entorno virtual
8python -m venv .venv
9
10# 3. Actívalo
11.venv\Scripts\Activate.ps1
12
13# 4. Tu prompt cambia:
14# (.venv) PS C:\Users\tu_usuario\mi-proyecto-datos>
15
16# 5. Verifica que python apunta al venv
17python --version
18# Python 3.12.4

1# 🍎 Mac (Terminal)
2
3# 1. Crea una carpeta para tu proyecto
4mkdir mi-proyecto-datos
5cd mi-proyecto-datos
6
7# 2. Crea el entorno virtual
8python3 -m venv .venv
9
10# 3. Actívalo
11source .venv/bin/activate
12
13# 4. Tu prompt cambia:
14# (.venv) usuario@mac mi-proyecto-datos %
15
16# 5. Verifica que python apunta al venv
17python --version
18# Python 3.12.4

Una vez activado el venv, el comando es "python" y "pip" en AMBOS sistemas (no necesitas python3 ni pip3 en Mac). Esa es una gran ventaja: dentro del venv, todo es uniforme. Cuando termines de trabajar, escribe "deactivate" para salir del venv.

### Posibles problemas con el venv

• ▹Windows — "Execution Policy": Si PowerShell dice que no puede ejecutar scripts, ejecuta: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser y confirma con S.
• ▹Mac — "command not found: python3": Homebrew no está en tu PATH. Ejecuta: eval "$(/opt/homebrew/bin/brew shellenv)" y luego intenta de nuevo.
• ▹Ambos — "pip: command not found" dentro del venv: Asegúrate de que el venv está activado ((.venv) visible en el prompt).
• ▹Ambos — Si tu venv se corrompe: bórralo y crea uno nuevo. Remove-Item -Recurse .venv (Win) o rm -rf .venv (Mac), luego recrea con python -m venv .venv.

### ¿Qué es pip y cómo funciona?

pip es el gestor de paquetes de Python. Viene incluido con Python desde la versión 3.4. Su trabajo es: descargar paquetes de internet (de PyPI por defecto), instalarlos en tu entorno y gestionar las dependencias entre paquetes.

1# 🟦 Windows (PowerShell) — con venv activo
2pip install requests
3pip install pandas
4
5# 🍎 Mac (Terminal) — con venv activo
6pip install requests
7pip install pandas
8
9# (Dentro del venv, "pip" funciona igual en ambos sistemas)
10
11# Instalar una versión específica
12pip install requests==2.31.0
13
14# Instalar versión mínima
15pip install "requests>=2.28"
16
17# Ver qué tienes instalado
18pip list
19
20# Ver detalles de un paquete
21pip show requests

### requirements.txt: la receta de tu proyecto

Cuando compartes tu proyecto con alguien (o contigo mismo en otro ordenador), esa persona necesita instalar las mismas librerías. El archivo requirements.txt es la lista de ingredientes — le dice a pip exactamente qué instalar y en qué versión.

1# Generar requirements.txt con lo que tienes instalado
2pip freeze > requirements.txt
3
4# El archivo contiene algo como:
5# requests==2.31.0
6# pandas==2.1.4
7# numpy==1.26.2
8
9# Instalar todo desde requirements.txt (otro dev, otro PC)
10pip install -r requirements.txt

### Librerías esenciales para ingeniería de datos

No necesitas instalarlas todas hoy — las irás incorporando en las siguientes skills. Pero es bueno saber qué existe:

• ▹pandas — Manipulación de datos tabulares (DataFrames). La usarás MUCHO en Skill 9.
• ▹requests — Llamar APIs HTTP. Imprescindible para extraer datos de servicios web.
• ▹pytest — Framework de testing. Tus pipelines necesitan tests.
• ▹python-dotenv — Cargar variables de entorno desde .env. Para configuración sensible.
• ▹pyyaml — Leer/escribir archivos YAML (configuración de pipelines complejos).
• ▹black — Formateador automático de código. Mantiene tu código consistente.
• ▹mypy — Verificador de tipos estáticos. Atrapa errores antes de ejecutar.

### Tu primer script con librerías externas

Vamos a instalar python-dotenv (para manejar configuración) y a usarla en un script. Este patrón lo verás en TODOS los proyectos profesionales:

1# Instala python-dotenv (dentro de tu venv)
2pip install python-dotenv

1# Primero crea un archivo .env con configuración
2# (este archivo NO se sube a git — contiene secretos)
3import os
4
5# Simular un .env escribiéndolo
6with open(".env", "w") as f:
7    f.write("RUTA_DATOS=data/ventas.csv\n")
8    f.write("UMBRAL_VIP=500\n")
9    f.write("MODO=desarrollo\n")
10
11# Ahora usar dotenv para cargar esas variables
12from dotenv import load_dotenv
13
14load_dotenv()  # Carga las variables del .env al entorno
15
16# Leer las variables
17ruta = os.getenv("RUTA_DATOS")
18umbral = int(os.getenv("UMBRAL_VIP", "100"))  # 100 es el default
19modo = os.getenv("MODO")
20
21print(f"Ruta de datos: {ruta}")
22print(f"Umbral VIP: {umbral}€")
23print(f"Modo: {modo}")
24
25if modo == "desarrollo":
26    print("⚠️ Ejecutando en modo desarrollo")

### Resolver problemas de instalación

• ▹🟦 Windows — Si pip falla con permisos, asegúrate de que PowerShell NO es administrador cuando trabajas con venvs.
• ▹🍎 Mac — Si pip install falla con errores de compilación, instala Xcode Command Line Tools: xcode-select --install
• ▹Ambos — "Could not find a version that satisfies": el paquete no existe o escribiste mal el nombre. Búscalo en pypi.org.
• ▹Ambos — Si tu venv se corrompe: bórralo y crea uno nuevo. rm -rf .venv (Mac) o Remove-Item -Recurse .venv (Windows), luego recrea.
• ▹Ambos — Actualizar pip: python -m pip install --upgrade pip