CKTIS / Python
Leer el nombre de una tarea con `asyncio.Task.get_name()`
`get_name()` devuelve el nombre actual de una tarea de asyncio como cadena. Úsalo como etiqueta en un informe y comprueba por separado con `cancelled()` si la tarea se canceló realmente.
Versión: Python 3.12
Sintaxis
task.get_name() # returns strtask.get_name() es un método de instancia síncrono de asyncio.Task, disponible desde Python 3.8. No recibe argumentos y devuelve el nombre actual como str. No necesita await: puedes leer el nombre antes o después de que termine la tarea.
Asigna un nombre con asyncio.create_task(coro, name=...) o cámbialo con task.set_name(value), que convierte el valor en una cadena. Si no asignas un nombre explícito, la implementación estándar de Task genera uno al crear la tarea. Úsalo como etiqueta de diagnóstico, no como identificador único ni como indicador de estado.
task.cancel() solicita la cancelación, pero no la garantiza: la corrutina puede capturar y suprimir asyncio.CancelledError. Para informar del resultado, espera a que termine con await task, maneja la excepción asyncio.CancelledError esperada y comprueba task.cancelled(). Normalmente, la corrutina debe liberar recursos en finally y dejar que la cancelación se propague.
Ejemplos
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())Resultado
report-worker: cancelled=True
El evento `started` permite esperar a que arranque la corrutina sin usar un retardo fijo. El segundo evento nunca se activa, por lo que la tarea queda pendiente hasta la cancelación. El informe combina el nombre explícito con el estado confirmado después de `await task`.
Lecciones relacionadas
- Python · Lección 30 · Avanzado · Versión: 5
Fuentes
- 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)