CKTIS / Python
asyncio.shield
Beschermt de taak tegen annulering via de omhulling.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
await asyncio.shield(aw)Beschermt de taak tegen annulering via de omhulling.
De aanroeper krijgt nog steeds CancelledError en de oorspronkelijke taak gaat door. Direct annuleren van de taak bereikt ook de omhulling. Bewaar een sterke taakverwijzing.
In het voorbeeld wordt outer geannuleerd maar levert het signaal True op zonder task te annuleren.
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())
Voorbeelden
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())
Resultaat
True True False
In het voorbeeld wordt outer geannuleerd maar levert het signaal True op zonder task te annuleren.