KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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 str

task.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