Restauration de ContextVar : réinitialiser avec le jeton plutôt que deviner la valeur précédente

Ce que c'est

La documentation de contextvars en Python indique que ContextVar.set renvoie un jeton (token) permettant de restaurer la valeur précédente avec reset. Le jeton enregistre l'état de contexte antérieur, y compris l'absence de valeur. Un jeton ne peut pas être réutilisé pour plusieurs réinitialisations. Python 3.14 permet en outre d'utiliser les jetons comme gestionnaires de contexte. Python contextvars

Pourquoi c'est important

Un agent peut terminer une substitution temporaire en assignant None ou une valeur par défaut globale. Cela peut écraser la valeur d'une requête englobante au lieu de la restaurer. Traiter les substitutions comme des portées imbriquées, chacune responsable de revenir exactement à l'état qu'elle a reçu, plutôt que d'inventer une valeur de nettoyage universelle.

Comment l'appliquer

• Identifier la ContextVar et tous les chemins qui la définissent. Distinguer la valeur par défaut configurée de la variable d'une valeur explicitement liée dans le contexte courant.
• Capturer le jeton renvoyé par set, puis réinitialiser ce jeton dans un bloc finally entourant le travail temporaire. Utiliser une syntaxe prise en charge par la version minimale de Python du projet.
• Proposer un montage de test (fixture) imbriqué : établir une valeur englobante, la remplacer à l'intérieur, puis vérifier que la valeur englobante revient ensuite. Répéter avec une exception levée à l'intérieur de la substitution.
• Ajouter un montage de test où la variable était auparavant non définie. Vérifier le comportement de lecture documenté après la restauration, plutôt que d'attendre une valeur nulle arbitraire.
• Examiner comment les tâches et les threads sont créés aux frontières de contexte. Documenter la propagation prévue séparément de la restauration au sein d'une même portée.

Pièges

Des liaisons locales au contexte ne rendent pas automatiquement un objet mutable stocké dans la variable indépendant ou thread-safe. Les jetons appartiennent à leur contexte et à leur variable ; ne pas les faire circuler comme des identifiants de réinitialisation génériques. Éviter d'exiger la forme gestionnaire de contexte de Python 3.14 dans un projet prenant en charge des versions antérieures. Les montages de test décrits sont des propositions, et aucun résultat observé d'isolation ou de débit n'est revendiqué.