El intérprete y el ciclo de vida
Un archivo .py no se ejecuta: se compila a bytecode y ese bytecode se ejecuta en un bucle. Entender las cuatro fases —compilar, importar, ejecutar, cerrar— explica los errores que aparecen antes de la primera línea útil y los mensajes que llegan después de la última.
En una línea
Sección titulada «En una línea»Python compila el archivo entero antes de ejecutar la primera instrucción, y ejecuta de arriba abajo sin mirar el resto.
Las cuatro fases
Sección titulada «Las cuatro fases»1. Compilación. El archivo se convierte en bytecode. Un SyntaxError aparece aquí, antes de ejecutar nada: por eso un error en la línea 200 impide que la línea 1 haga efecto.
2. Importación. Se ejecutan los import del módulo principal. Cada módulo se importa una vez y se guarda en sys.modules; las siguientes importaciones devuelven lo mismo. Si un import falla, el módulo queda a medias y el error puede ser confuso.
3. Ejecución. El bytecode corre en el bucle de evaluación, con el GIL y el recolector. Los objetos se crean y se liberan por conteo de referencias.
4. Cierre. Se ejecutan los atexit, se vacían los buffers y se destruyen los objetos que quedan. El orden no está garantizado y por eso __del__ no sirve para guardar nada importante.
Lo que cuesta arrancar
Sección titulada «Lo que cuesta arrancar»| Módulo | Coste |
|---|---|
decimal |
5.9 ms |
json |
11.5 ms |
logging |
18.8 ms |
dataclasses |
22.1 ms |
python mediciones/07-01-05-produccion.py
En un script, 20 ms no se notan. En un servicio con cien workers, son dos segundos de arranque; en una CLI que se invoca en un bucle, se nota en cada llamada. python -X importtime -c "import mi_paquete" muestra el árbol completo y señala qué mover a un import diferido.
El REPL y el archivo no son lo mismo
Sección titulada «El REPL y el archivo no son lo mismo»En el REPL, cada línea se compila y ejecuta por separado. En un archivo, el módulo se compila entero. Consecuencias:
- Una expresión que ocupa varias líneas funciona en el REPL y falla en un archivo si no se agrupa.
- El REPL mantiene el estado entre líneas; el archivo no.
if __name__ == "__main__"es falso cuando el módulo se importa, verdadero cuando se ejecuta. Es la guardia que permite que un archivo sea script y biblioteca a la vez.
La trampa
Sección titulada «La trampa»El if __name__ en tres líneas
Sección titulada «El if __name__ en tres líneas»def main() -> int: ...
if __name__ == "__main__": raise SystemExit(main())main devuelve un entero y SystemExit lo convierte en código de salida. El archivo se puede importar sin ejecutar nada y se puede invocar como programa. Es el patrón que pyproject.toml espera en [project.scripts].
Ejercicio
Sección titulada «Ejercicio»Un módulo utils.py imprime «cargando utils» al principio y define una función limpiar(). Al importarlo desde el módulo principal, el mensaje aparece dos veces. ¿Por qué?
Solución
Porque el módulo se importa dos veces bajo nombres distintos: una vez como utils (desde el directorio del proyecto) y otra como mi_paquete.utils (desde el paquete instalado). Python los considera módulos diferentes y ejecuta ambos, con dos copias de las funciones y del estado global.
Es el síntoma del diseño sin src/ de la Parte VII: el directorio de trabajo está en sys.path y el paquete también está instalado, así que el mismo archivo existe dos veces en el espacio de nombres.
Arreglo: estructura con src/, e instalación en modo editable (pip install -e .) para que sólo haya un camino. La comprobación: python -c "import utils; print(utils.__file__)" y comparar con la ruta esperada.
Referencias
Sección titulada «Referencias»- Ramalho, L. Fluent Python, 2ª ed. Capítulo 1.
- CPython 3.13:
Python/ceval.c,Lib/importlib/. - Mediciones:
mediciones/07-01-05-produccion.py.
Capítulos relacionados
Sección titulada «Capítulos relacionados»- 01 · Paquetes y entornos (Parte VII): por qué un módulo puede existir dos veces.
- 03 · Herramientas mínimas: qué instalar antes de empezar.