CKTIS / Python
De naam van een taak lezen met `asyncio.Task.get_name()`
`get_name()` geeft de huidige naam van een asyncio-taak terug als tekenreeks. Gebruik die als label in een rapport en controleer apart met `cancelled()` of de taak echt is geannuleerd.
Versie: Python 3.12
Syntax
task.get_name() # returns strtask.get_name() is een synchrone instantiemethode van asyncio.Task, beschikbaar sinds Python 3.8. De methode neemt geen argumenten aan en geeft de huidige naam terug als str. Je gebruikt geen await: de naam is zowel vóór als na afloop van de taak leesbaar.
Geef de taak een naam met asyncio.create_task(coro, name=...) of wijzig de naam met task.set_name(value), dat de waarde omzet in een tekenreeks. Zonder expliciete naam genereert de standaardimplementatie van Task bij het aanmaken een naam. Gebruik die als label voor diagnose, niet als unieke identificatie of status.
task.cancel() vraagt om annulering, maar garandeert die niet: de coroutine kan asyncio.CancelledError opvangen en onderdrukken. Wacht voor het rapport met await task tot de taak klaar is, vang de verwachte asyncio.CancelledError op en controleer task.cancelled(). De coroutine hoort normaal gesproken in finally op te ruimen en de annulering niet te onderdrukken.
Voorbeelden
import asyncio
async def worker(started):
started.set()
await asyncio.Event().wait()
async def main():
started = asyncio.Event()
task = asyncio.create_task(worker(started), name="report-worker")
await started.wait()
task.cancel()
try:
await task
except asyncio.CancelledError:
print(f"{task.get_name()}: cancelled={task.cancelled()}")
if __name__ == "__main__":
asyncio.run(main())Resultaat
report-worker: cancelled=True
Dankzij de gebeurtenis `started` kan de aanroeper zonder vaste vertraging wachten tot de coroutine start. De tweede gebeurtenis wordt nooit gezet, dus de taak blijft wachten tot de annulering. Het rapport combineert de expliciete naam met de status die na `await task` is bevestigd.
Gerelateerde lessen
- Python · Les 30 · Gevorderd · Versie: 5
Bronnen
- Coroutines and Tasks — Task.get_name() (Python 3.12)
- Coroutines and Tasks — asyncio.create_task() (Python 3.12)
- Coroutines and Tasks — Task.set_name() (Python 3.12)
- Coroutines and Tasks — Task.cancel() (Python 3.12)
- Coroutines and Tasks — Task.cancelled() (Python 3.12)
- Coroutines and Tasks — Task Cancellation (Python 3.12)