Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

asyncio.Task

Představuje korutinu prováděnou kooperativně smyčkou.

Verze: Python 3.14; repository image, production runtime not attested

Syntaxe

task = asyncio.create_task(coro)

Představuje korutinu prováděnou kooperativně smyčkou.

name pojmenuje úlohu, context zvolí kontext a eager_start umožní okamžitý start. Výsledek pochází z korutiny. Vnější volání set_result a set_exception známá z Future nejsou povolena. Když se pozastaví při await, mohou běžet jiné úlohy. Čekání na úlohu vrátí hodnotu nebo předá výjimku. result() před dokončením vyvolá InvalidStateError a cancel() požádá o zrušení.

Signál dovolí úloze v příkladu vrátit True.

import asyncio
async def main():
    async def fail():
        raise LookupError("missing")
    t = asyncio.create_task(fail())
    try:
        await t
    except LookupError:
        assert t.done() and isinstance(t.exception(), LookupError)
    else:
        raise AssertionError
asyncio.run(main())
import asyncio
async def main():
    t = asyncio.create_task(asyncio.sleep(0, result=3), name="job")
    for mutate in (lambda: t.set_result(4), lambda: t.set_exception(ValueError())):
        try:
            mutate()
        except RuntimeError:
            pass
        else:
            raise AssertionError
    assert await t == 3 and t.get_name() == "job"
asyncio.run(main())

asyncio.Task.cancel · asyncio.Task.get_name

get_name() vrátí název úlohy, zde reader. cancel(msg) požádá o vložení CancelledError v příštím průchodu smyčkou. Korutina jej může zachytit. Po dokončení úlohy vrátí cancel() False.

import asyncio
async def main():
    ready = asyncio.Event()
    async def idle():
        ready.set()
        await asyncio.Event().wait()
    task = asyncio.create_task(idle(), name="reader")
    await ready.wait()
    assert task.get_name() == "reader" and task.cancel("done")
    try:
        await task
    except asyncio.CancelledError as exc:
        assert exc.args == ("done",)
    assert task.cancelled() and not task.cancel()
asyncio.run(main())

Příklady

import asyncio

async def main():
    gate = asyncio.Event()
    task = asyncio.create_task(gate.wait())
    print(isinstance(task, asyncio.Task))
    try:
        task.result()
    except asyncio.InvalidStateError as error:
        print(type(error).__name__)
    gate.set()
    print(await task)

asyncio.run(main())

Výsledek

True
InvalidStateError
True

Signál dovolí úloze v příkladu vrátit True.

Zdroje