DEV Community: Alexis Román

Cómo encontrar bugs de importación en Tor usando Grafos AST

Alexis Román — Tue, 27 Oct 2026 22:41:33 +0000

Cómo encontrar bugs de importación en Tor usando Grafos AST

Hay una clase de bug que las pruebas no atrapan y los linters no ven: el módulo funciona, pero el orden en que lo importas decide si arranca. El código no está roto; el grafo de dependencias sí.

Este es el registro de uno real, encontrado en torproject/stem —la librería de Python para controlar un daemon de Tor— y reportado en torproject/stem#160.

Paso 1 — Clonar el sujeto y declarar el universo

git clone --depth 50 https://github.com/torproject/stem.git stem_art
cd stem_art && git rev-parse HEAD
# d5012a1039f05c69ebe832723ce96ecbe8f79fe1

El universo es solo archivos .py. Cualquier cifra que se publique después tiene que declarar ese universo: un árbol sin Python no produce grafo, y un grafo vacío no es un grafo limpio.

Paso 2 — Construir el grafo de imports desde el AST

La herramienta no ejecuta el código: parsea cada .py con ast, extrae las sentencias import/from ... import, las resuelve a módulos del corpus y separa dos subgrafos:

eager: la sentencia corre cuando se importa el módulo (cuerpo del módulo, incluido el cuerpo de una class).
diferida: vive dentro de una función; no corre al importar.

Esa separación es todo el método. Un ciclo diferido no puede cerrarse al importar. Un ciclo eager sí.

python3 tools/grafo_ciclos_tt_metal_20261026.py --root /tmp/stem_art --raices-no-resueltas

Salida, medida sobre d5012a1:

archivos python     : 219
aristas import      : 611
  eager (al importar): 594
  diferidas          : 17
SCC total           : 5
SCC eager           : 5
  ciclo(11): stem/connection.py, stem/control.py, stem/response/__init__.py,
             stem/response/authchallenge.py, stem/response/events.py,
             stem/response/getconf.py, stem/response/getinfo.py,
             stem/response/mapaddress.py, stem/response/onion_client_auth.py,
             stem/response/protocolinfo.py, stem/socket.py
  CICLO EAGER(2): stem/response/__init__.py, stem/socket.py

Cinco componentes fuertemente conexas, y las cinco contienen al menos una arista eager. La más pequeña es la interesante: stem/response/__init__.py ↔ stem/socket.py.

Paso 3 — Convertir la sospecha en una reproducción de dos comandos

Un ciclo eager es una hipótesis, no un hallazgo. El falsificador más barato son dos procesos nuevos, con puntos de entrada distintos:

python -c 'import stem.response'   # entrada por el paquete
python -c 'import stem.socket'     # entrada por el otro extremo

Medido con Python 3.12.13:

--- import stem.response:  RC=1
Traceback (most recent call last):
  File "<string>", line 1, in <module>
  File "stem/response/__init__.py", line 37, in <module>
    import stem.socket
  File "stem/socket.py", line 105, in <module>
    class BaseSocket(object):
  File "stem/socket.py", line 253, in BaseSocket
    async def _recv(self, handler: Callable[[asyncio.StreamReader], Awaitable[stem.response.ControlMessage]]) -> stem.response.ControlMessage:
                                                                              ^^^^^^^^^^^^^
AttributeError: cannot access submodule 'response' of module 'stem' (most likely due to a circular import)

--- import stem.socket:    RC=0

El mismo código, dos resultados opuestos según por dónde entres. Eso es la firma de un defecto de orden de carga, no de una función mal escrita.

Por qué es un defecto de orden de carga

Tres hechos, cada uno verificable en el archivo:

stem/response/__init__.py:37 hace import stem.socket mientras stem.response todavía se está inicializando. En ese instante, stem.response existe en sys.modules, pero el atributo response del paquete stem —el que hace funcionar stem.response.ControlMessage— aún no está ligado.
stem/socket.py:105 abre class BaseSocket(object):. El cuerpo de una clase se ejecuta al importar, y stem/socket.py no tiene from __future__ import annotations.
Por eso la anotación de stem/socket.py:253 se evalúa de inmediato, en el momento exacto en que el nombre stem.response no es alcanzable como atributo.

La anotación no es código que corra; es metadata que Python 3 evalúa con ganas (eager) si no se le dice lo contrario. Y stem/socket.py:90 (import stem.response) cierra el círculo: los dos módulos se necesitan, y quién termina primero decide si la anotación resuelve.

Cuando entras por stem.socket, stem.socket se inicializa primero, su import stem.response corre hasta el final, y para cuando toca evaluar la anotación el nombre ya existe. Cuando entras por stem.response, el orden se invierte y revienta.

El arreglo

Cualquiera de los dos rompe la dependencia de orden:

from __future__ import annotations   # al inicio de stem/socket.py

o citar la anotación afectada ('stem.response.ControlMessage'). Ambos dejan typing.get_type_hints() funcionando, porque los nombres resuelven cuando el paquete ya está cargado.

Medido, no supuesto: con la línea añadida, import stem.response sale RC 0; revertida la línea, vuelve a salir RC 1 con el mismo AttributeError. El defecto y su cierre están en el mismo par de comandos.

Por qué un grafo AST y no un linter

Un linter de imports mira un archivo; el bug no está en un archivo, está en el par.
Las pruebas de stem no lo ven porque cada módulo de prueba importa lo que necesita en el orden que le conviene: el orden accidental del test enmascara el orden real del usuario.
El grafo cuesta segundos y no ejecuta el sujeto. Produce un ranking: 5 SCC, todas con arista eager. Eso reduce el espacio de búsqueda de "219 archivos" a "un par".

El costo real está en la resolución de nombres, no en el parseo: sobre este checkout, 1 015 imports no resolvieron (913 de STDLIB, 102 de dependencias externas como cryptography), y 211 aristas hacia el __init__ de un paquete ancestro fueron descartadas a propósito —el paquete ya está en sys.modules cuando corre el hijo, contarlas fabrica ciclos que el runtime nunca recorre—. Un motor que no declara esas dos decisiones publica ciclos falsos con total comodidad.

Alcance y límites

Ninguna afirmación de seguridad. Es un defecto de tiempo de importación: se manifiesta como un AttributeError duro en vez de un import que funciona.
No se probó contra un daemon de Tor en ejecución. Solo el import, en un intérprete limpio.
El bug es del sujeto, no del método: el método solo lo hizo visible sin leer stem/socket.py de arriba abajo primero.

Prueba

Issue abierto: torproject/stem#160 — AttributeError on class-body annotation evaluation in stem/socket.py when importing stem.response first
Observado y reproducible en d5012a1039f05c69ebe832723ce96ecbe8f79fe1, Python 3.12.13, macOS.

Si mantienes una librería con paquetes que se importan entre sí, el experimento te cuesta dos comandos: construye el grafo, separa eager de diferido, y prueba cada ciclo pequeño con dos puntos de entrada opuestos. El que falle en uno y no en el otro es tu bug.

Cómo preparar tu primera carrera de 10k en 8 semanas

Alexis Román — Thu, 20 Aug 2026 20:08:54 +0000

Correr tu primer 10k es una meta que está más cerca de lo que crees. No necesitas ser un atleta de élite ni haber corrido antes; solo necesitas un plan realista, constancia y el equipo adecuado. En Kinestesia sabemos que el miedo al 'no voy a poder' es el primer obstáculo, por eso diseñamos esta guía de 8 semanas para que llegues a la meta con confianza y sin lesiones.
La distancia de 10 kilómetros (10k) es perfecta para quien ya camina rápido o ha corrido distancias cortas como 5k. Es un reto que exige preparación, pero no te esclaviza: con tres o cuatro días de entrenamiento por semana es suficiente. Lo importante es la consistencia, no la velocidad. Al final, lo que recordarás no es tu tiempo, sino la sensación de cruzar la línea.
Antes de empezar, visita a tu médico si tienes alguna condición de salud o llevas mucho tiempo sin hacer ejercicio. También invierte en un par de tenis para correr que se ajusten bien a tu pisada; no tiene que ser el más caro, pero sí el adecuado. Y en cuanto a ropa, elige prendas transpirables que no te rocen. Aquí es donde Kinestesia te acompaña: playeras técnicas que se secan rápido y shorts con bolsillo para tu teléfono hacen que cada entrenamiento sea más cómodo.
En las próximas secciones te doy el plan semana a semana, consejos de nutrición, cómo elegir tu ropa y cómo mantener la motivación. Al final, tendrás todo lo necesario para inscribirte a tu primer 10k y disfrutarlo. Recuerda: correr es más mental que físico, y tu mente ya está lista.
H2: Plan de entrenamiento para 10k en 8 semanas
Este plan está pensado para corredores principiantes que ya pueden trotar 20 minutos sin parar. Si aún no llegas a eso, toma dos semanas extras para caminar rápido y trotar de forma intermitente. La base es alternar carrera y caminata, aumentando gradualmente el tiempo de carrera.
Semana 1: Entrena tres días. Lunes: 20 minutos de trote suave + 10 minutos de caminata. Miércoles: 25 minutos de trote + 5 de caminata. Sábado: 30 minutos de trote continuo. Entre cada día, descansa o haz caminata ligera.
Semana 2: Aumenta a cuatro días. Lunes: 25 minutos de trote. Miércoles: 30 minutos de trote. Viernes: 20 minutos de trote + 10 de caminata. Sábado: 35 minutos de trote continuo. Escucha a tu cuerpo; si sientes dolor, baja la intensidad.
Semana 3: Lunes: 30 minutos de trote. Miércoles: 35 minutos de trote. Viernes: 25 minutos de trote. Sábado: 40 minutos de trote continuo. Esta semana es clave para construir resistencia.
Semana 4: Lunes: 30 minutos de trote. Miércoles: 40 minutos de trote. Viernes: 30 minutos de trote. Sábado: 45 minutos de trote continuo. Al final de esta semana, deberías sentir que 5k ya es cómodo.
Semana 5: Lunes: 35 minutos de trote. Miércoles: 40 minutos de trote. Viernes: 30 minutos de trote. Sábado: 50 minutos de trote continuo. Aquí es donde tu cuerpo empieza a adaptarse a distancias más largas.
Semana 6: Lunes: 40 minutos de trote. Miércoles: 45 minutos de trote. Viernes: 30 minutos de trote. Sábado: 55 minutos de trote continuo. Si puedes, busca una ruta con subidas suaves para fortalecer piernas.
Semana 7: Lunes: 40 minutos de trote. Miércoles: 45 minutos de trote. Viernes: 30 minutos de trote. Sábado: 60 minutos de trote continuo. Esta es tu semana más larga; ya puedes correr 8-9k sin problema.
Semana 8: Lunes: 30 minutos de trote suave. Miércoles: 20 minutos de trote suave. Viernes: descanso total. Sábado: ¡carrera! No intentes correr más de lo que has entrenado; el objetivo es terminar, no hacer un tiempo récord.
H2: Cómo elegir la ropa adecuada para tu primer 10k
La ropa que usas para correr no es un lujo, es una herramienta. Una playera de algodón se empapa de sudor, se pega al cuerpo y te hace sentir pesado. En cambio, una playera técnica transpirable te mantiene seco y fresco, especialmente en el clima cálido de Morelos, donde corremos casi todo el año.
En Kinestesia encontrarás playeras running con tejidos que evacuan la humedad y costuras planas que evitan rozaduras. También shorts y bikers con bolsillo para tu teléfono y llaves, para que no cargues nada en las manos. Si corres en la mañana o al atardecer, un rompevientos ligero te protege del viento sin que pases calor.
Para las mujeres, los tops y sets deportivos ofrecen soporte y libertad de movimiento. No necesitas gastar una fortuna; solo prendas que se ajusten bien y te hagan sentir segura. Recuerda: cuando te sientes cómodo con tu ropa, corres mejor y disfrutas más.
H2: Nutrición e hidratación para correr 10k
Lo que comes antes de correr afecta tu rendimiento. Dos horas antes de tu entrenamiento, come algo ligero como un plátano, una tostada con mermelada o un puñado de nueces. Evita comidas pesadas o muy grasosas, porque te sentirás lento.
La hidratación es clave, sobre todo en climas cálidos. Bebe agua durante el día, no solo justo antes de correr. Si tu entrenamiento dura más de 45 minutos, lleva una botella de agua o planifica una ruta con fuentes. Después de correr, repón electrolitos con agua de coco o una bebida deportiva.
El día de la carrera, no experimentes con comidas nuevas. Desayuna lo mismo que has probado en tus entrenamientos largos. Llega con tiempo, calienta caminando 10 minutos y haz algunos estiramientos dinámicos. Tu cuerpo ya sabe lo que es correr 10k; solo tienes que dejar que lo haga.
H2: Motivación y comunidad: no corras solo
Uno de los secretos para no abandonar es encontrar una comunidad. Correr con otros te empuja a salir incluso los días que no tienes ganas. En Cuernavaca hay parques como el Chapultepec o la Barranca de Amanalco donde siempre verás corredores. También puedes buscar grupos de running en redes sociales.
En Kinestesia creemos en el poder de la comunidad. Por eso organizamos retos y compartimos consejos con nuestra comunidad de corredores. Además, en el ecosistema Tiendas Platino encontrarás aliados como Narada Yoga, ideal para estirar y recuperarte después de tus entrenamientos, o Moon & Rain para vestir con estilo fuera de la pista.
Otra forma de mantenerte motivado es fijar metas pequeñas: correr 10 minutos sin parar, completar tu primer 5k, o simplemente salir tres veces a la semana. Celebra cada logro, por pequeño que sea. Y si un día fallas, no te castigues; retoma al día siguiente. La constancia es más importante que la perfección.
H2: Preguntas frecuentes sobre preparar tu primer 10k
¿Puedo correr 10k en 8 semanas si nunca he corrido? Sí, si ya caminas rápido o has corrido 5k. Si partes de cero, toma 2-3 semanas extra para construir una base. El plan es progresivo y respeta los descansos.
¿Qué hago si me duele algo durante el entrenamiento? Escucha a tu cuerpo. Dolor muscular leve es normal, pero dolor en articulaciones o punzadas no. Descansa un día extra, aplica hielo y si persiste, consulta a un especialista. No corras con dolor fuerte.
¿Qué ropa necesito para el día de la carrera? Usa la misma ropa con la que entrenaste: playera técnica, short o legging con bolsillo, y tenis ya probados. No estrenes nada el día de la carrera. En Kinestesia encuentras todo lo que necesitas.
H2: Tu primera carrera de 10k te espera
Preparar tu primer 10k en 8 semanas es totalmente posible si sigues un plan, escuchas a tu cuerpo y te rodeas de apoyo. No se trata de ser el más rápido, sino de superar tu propio límite y disfrutar el proceso. Cada kilómetro que corras te acerca a una versión más fuerte de ti.
Equípate para tu próxima carrera en kinestesia.com.mx y aprovecha tu 10% de bienvenida con el código BIENVENIDO10. Tenemos playeras transpirables, shorts con bolsillo y todo lo que necesitas para que tu primer 10k sea una experiencia increíble. Nos vemos en la meta.