Módulos: La Caja de Herramientas Compartida

Fig. 11.4: import trae herramientas de la biblioteca estándar.

En el primer capítulo dijimos que Python viene con “baterías incluidas”. Ya las has estado usando: cada vez que escribiste from pathlib import Path, abriste una de esas cajas de herramientas. Toca explicar qué pasaba ahí.

Un módulo es un archivo de herramientas ya hechas que alguien más escribió y probó por ti. No están todas cargadas desde el arranque (sería como dejar todas las máquinas del almacén encendidas a la vez); las traes a tu programa con import solo cuando las necesitas.

import: traer una herramienta al taller

Hay dos formas de pedir herramientas:

# 1. Traer el módulo entero y usar su nombre como prefijo
import math
print(math.sqrt(144))   # 12.0

# 2. Traer solo la herramienta que quieres
from pathlib import Path
ruta = Path("inventario.txt")

La primera deja claro de dónde viene cada cosa (math.sqrt). La segunda es más corta cuando usas una herramienta concreta muchas veces. Las dos son correctas; eliges según lo que se lea mejor.

La Biblioteca Estándar (lo que ya tienes gratis)

Python trae cientos de módulos instalados de fábrica. A ese conjunto se le llama la biblioteca estándar (standard library, el gabinete de la Fig. 11.4), y cubre una cantidad sorprendente de trabajo real sin instalar nada:

• pathlib: rutas y archivos (ya lo usaste).
• csv y json: leer y escribir datos estructurados (los ves en la próxima sección).
• datetime: fechas y horas.
• random: números al azar, barajar, elegir.
• math: raíces, redondeos, constantes.

Este libro se queda casi siempre dentro de la biblioteca estándar a propósito: es lo que tienes garantizado en cualquier máquina, sin sorpresas y sin dependencias que mantener.

Herramientas de Fuera: PyPI y pip

Cuando la biblioteca estándar no alcanza, existe un almacén gigante de módulos hechos por la comunidad: el Python Package Index (PyPI). Para traer algo de ahí usas pip, el instalador que viene con Python (la grúa que conociste en el Capítulo 2):

python -m pip install nombre_del_paquete

Cuidado: hazlo siempre dentro de un entorno virtual. Instalar paquetes en el Python del sistema es justo lo que dispara el error externally-managed-environment (los usuarios de macOS ya lo conocieron en su guía de instalación). Con tu venv activado, pip install guarda el paquete en ese entorno aislado, sin tocar nada más:

python3 -m venv .venv
source .venv/bin/activate        # en Windows: .venv\Scripts\activate
python -m pip install rich

Si tu proyecto usa paquetes externos, se acostumbra anotarlos en un archivo requirements.txt (uno por línea) para que cualquiera reconstruya el mismo entorno con un solo comando:

python -m pip install -r requirements.txt

Por ahora no necesitas instalar nada: todo lo que construyas en este libro corre con la biblioteca estándar. Pero ya sabes dónde está la ferretería el día que la necesites.