CKTIS / Python
asyncio.shield
Предпазва задачата от отмяна, предадена чрез обвивката.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
await asyncio.shield(aw)Предпазва задачата от отмяна, предадена чрез обвивката.
Извикващият все пак получава CancelledError, а първоначалната задача продължава. Пряката отмяна на задачата засяга и обвивката. Запазете силна препратка към задачата.
В примера outer е отменен, но сигналът дава True без отмяна на 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())
Примери
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())
Резултат
True True False
В примера outer е отменен, но сигналът дава True без отмяна на task.