Saltearse al contenido

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.

Python compila el archivo entero antes de ejecutar la primera instrucción, y ejecuta de arriba abajo sin mirar el resto.

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.

Importar módulos al arrancar (acumulado)
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.

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.
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].

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.

Comprobación: el mismo archivo cargado bajo dos nombres se ejecuta dos veces.

import importlib.util
import sys
import tempfile
from pathlib import Path
with tempfile.TemporaryDirectory() as d:
ruta = Path(d) / "utils.py"
ruta.write_text("print('cargando utils')", encoding="utf-8")
modulos = []
for nombre in ("utils", "mi_paquete.utils"):
spec = importlib.util.spec_from_file_location(nombre, ruta)
mod = importlib.util.module_from_spec(spec)
sys.modules[nombre] = mod
spec.loader.exec_module(mod)
modulos.append(mod)
print("mismo objeto:", modulos[0] is modulos[1])
print("ejecuciones:", len(modulos))
  • Ramalho, L. Fluent Python, 2ª ed. Capítulo 1.
  • CPython 3.13: Python/ceval.c, Lib/importlib/.
  • Mediciones: mediciones/07-01-05-produccion.py.
  • 01 · Paquetes y entornos (Parte VII): por qué un módulo puede existir dos veces.
  • 03 · Herramientas mínimas: qué instalar antes de empezar.