CKTIS / Python
asyncio.shield
Schirmt den Task gegen über die Hülle weitergegebenen Abbruch ab.
Version: Python 3.14; repository image, production runtime not attested
Syntax
await asyncio.shield(aw)Schirmt den Task gegen über die Hülle weitergegebenen Abbruch ab.
Der Aufrufer erhält dennoch CancelledError und der ursprüngliche Task läuft weiter. Direkter Abbruch des Tasks erreicht auch die Hülle. Eine starke Taskreferenz behalten.
Im Beispiel wird outer abgebrochen, doch die Freigabe liefert True ohne Abbruch von task.
import asyncio
async def main():
e = asyncio.Event()
t = asyncio.create_task(e.wait())
s = asyncio.shield(t)
s.cancel()
try:
await s
except asyncio.CancelledError:
assert not t.cancelled()
e.set()
assert await t is True
asyncio.run(main())
Beispiele
import asyncio
async def main():
gate = asyncio.Event()
task = asyncio.create_task(gate.wait())
outer = asyncio.shield(task)
outer.cancel()
gate.set()
print(outer.cancelled(), await task, task.cancelled())
asyncio.run(main())
Ergebnis
True True False
Im Beispiel wird outer abgebrochen, doch die Freigabe liefert True ohne Abbruch von task.