GuíaAvanzado

Guía de Empaquetado y Herramientas CLI

Un script que "funciona en mi máquina" y un paquete instalable que otra persona puede usar son dos cosas muy distintas, y esta guía te lleva de uno al otro paso a paso. Trabajas empaquetando un solo caso realista —`reservo`, un sistema de reservas de salas de coworking cuyo modelo de objetos ya existe— y lo conviertes en una librería instalable con una herramienta de línea de comandos propia. Aprendes qué es un módulo y un paquete, cómo funciona `import` y el `sys.path`, el estándar moderno `pyproject.toml` (PEP 621) y cómo construir un wheel y un sdist reales con `uv build`, a aislar el proyecto en entornos virtuales y manejar dependencias con `pip` y `uv`, a construir una CLI completa con `argparse` (sin dependencias externas), a exponerla como comando instalado con un entry point en `[project.scripts]`, a estructurar un paquete real con submódulos, imports relativos y una API pública deliberada, y a configurar el toolchain de calidad (`ruff`, `mypy`, `pytest`, `pre-commit`). Todo lo ejecutable se corre de verdad —el comando `reservo price --tier basic --hours 3` imprime `7500` desde tu terminal—; lo único que se enseña como contenido sin ejecutar es la publicación en PyPI, porque es una acción pública e irreversible. El proyecto final integra las siete piezas en un paquete completo, construido, instalado y corriendo de punta a punta.