Annulation asyncio : effectuer le nettoyage sans avaler CancelledError

Ce que c'est

La documentation asyncio de Python recommande try/finally pour le nettoyage et, en général, de propager CancelledError après un traitement explicite. Elle avertit que TaskGroup et les mécanismes de timeout utilisent l'annulation en interne et peuvent mal se comporter si une coroutine l'avale. L'annulation fait donc partie du contrat de la tâche, et non simplement une erreur de plus à transformer en résultat ordinaire. Python asyncio tasks

Pourquoi c'est important

Un agent peut ajouter une branche de récupération large pour maintenir un worker en fonctionnement, et empêcher par accident son propriétaire de l'arrêter. Il faut distinguer l'échec attendu d'une opération d'une demande de fin de tâche. La revue proposée suit l'annulation depuis la requête du parent, à travers le nettoyage, jusqu'au résultat visible par l'appelant.

Comment l'appliquer

• Repérer chaque gestionnaire d'exception entourant du travail attendu (awaited) et identifier lequel traite l'annulation. Noter si la coroutine la propage, la convertit ou la supprime délibérément.
• Placer la libération des ressources dans un bloc finally ou un gestionnaire de contexte asynchrone adapté. Garder le nettoyage ciblé et définir ce qui se passe si le nettoyage lui-même échoue ou est annulé.
• Lorsque CancelledError est explicitement interceptée pour effectuer un travail supplémentaire, normalement la relever ensuite. Traiter sa suppression comme une décision de conception délibérée exigeant un protocole documenté au niveau du propriétaire.
• Proposer des fixtures qui annulent avant l'acquisition, pendant une opération attendue et après une progression partielle. Vérifier l'état des ressources et le résultat terminal de la tâche, plutôt que seulement contrôler qu'une ligne de journal est apparue.
• Exercer la coroutine dans son véritable TaskGroup ou contexte de timeout afin que les interactions avec la portée parente soient visibles.

Pièges

L'annulation ne défait pas les effets de bord externes déjà validés. Le nettoyage ne rend pas non plus automatiquement une nouvelle tentative sûre. Éviter d'utiliser le shielding ou la manipulation de l'état d'annulation simplement pour masquer un timeout gênant ; consulter le contrat exact de la version d'asyncio utilisée pour une suppression délibérée. Aucun test d'annulation n'a été exécuté pour cet article, et la méthode ne promet pas l'arrêt immédiat d'un code bloquant arbitraire.