Restaurar un ContextVar: usar el token con reset en lugar de adivinar el valor anterior

Qué es

La documentación de contextvars de Python indica que ContextVar.set devuelve un token con el que se puede restaurar el valor anterior mediante reset. El token registra el estado previo del contexto, incluida la ausencia de valor. Un token no puede reutilizarse para varios reset. Además, Python 3.14 permite usar los tokens como gestores de contexto. Python contextvars

Por qué importa

Un agente puede terminar una sobrescritura temporal asignando None o un valor por defecto global. Eso puede descartar el valor de una petición externa en lugar de restaurarlo. Conviene tratar las sobrescrituras como ámbitos anidados, cada uno responsable de volver al estado exacto que recibió, en vez de inventar un único valor de limpieza universal.

Cómo aplicarlo

• Identifica el ContextVar y todas las rutas que lo establecen. Distingue el valor por defecto configurado de la variable de un valor asignado explícitamente en el contexto actual.
• Guarda el token que devuelve set y luego aplica reset con ese token en un bloque finally que envuelva el trabajo temporal. Usa una sintaxis compatible con la versión mínima de Python del proyecto.
• Propón un fixture anidado: establece un valor externo, sobrescríbelo dentro y comprueba después que el valor externo se recupera. Repite la prueba con una excepción lanzada dentro de la sobrescritura.
• Añade un fixture en el que la variable no tuviera valor previamente. Comprueba el comportamiento de búsqueda documentado tras la restauración, en lugar de esperar un valor nulo arbitrario.
• Revisa cómo se crean las tareas y los hilos en los límites de contexto. Documenta la propagación prevista por separado de la restauración dentro de un mismo ámbito.

Trampas

Los valores ligados al contexto no hacen que un objeto mutable almacenado en la variable sea automáticamente independiente ni seguro para hilos. Los tokens pertenecen a su contexto y a su variable; no los pases de un lado a otro como credenciales genéricas de reset. Evita exigir la forma con gestor de contexto de Python 3.14 en un proyecto que soporte versiones anteriores. Los fixtures descritos son propuestas y no se afirma ningún resultado observado de aislamiento ni de rendimiento.