API-index på hög nivå

På den här sidan listas alla async/await-aktiverade asyncio API:er på hög nivå.

Uppgifter

Verktyg för att köra asyncioprogram, skapa uppgifter och vänta på flera saker med tidsgränser.

run()

Skapa en händelseslinga, kör en coroutine, stäng slingan.

Runner

En kontexthanterare som förenklar flera asynkrona funktionsanrop.

Task

Uppgiftsobjekt.

TaskGroup

En kontexthanterare som innehåller en grupp av uppgifter. Ger ett bekvämt och tillförlitligt sätt att vänta på att alla uppgifter i gruppen ska bli klara.

skapa_uppgift()

Starta en asyncio-uppgift och returnera den sedan.

aktuell_uppgift()

Returnerar den aktuella uppgiften.

alla_uppgifter()

Returnerar alla uppgifter som ännu inte har slutförts för en händelseslinga.

await sleep()

Sov i ett antal sekunder.

await gather()

Schemalägg och vänta på saker samtidigt.

await wait_for()

Kör med en timeout.

await sköld()

Skydd mot avbeställning.

await wait()

Övervaka för slutförande.

timeout()

Körs med en timeout. Användbart i fall där wait_for inte är lämpligt.

to_thread()

Kör en funktion asynkront i en separat OS-tråd.

run_coroutine_threadsafe()

Schemalägg en coroutine från en annan OS-tråd.

for in as_completed()

Övervaka för slutförande med en for-loop.

Exempel

Köer

Köer bör användas för att fördela arbete mellan flera asyncio Tasks, implementera anslutningspooler och pub/sub-mönster.

Queue

En FIFO-kö.

PriorityQueue

En prioriterad kö.

LifoQueue

En LIFO-kö.

Exempel

Delprocesser

Verktyg för att starta underprocesser och köra shell-kommandon.

await skapa_subprocess_exec()

Skapa en underprocess.

await skapa_subprocess_shell()

Kör ett shell-kommando.

Exempel

Strömmar

API:er på hög nivå för att arbeta med nätverks-IO.

await öppna_connection()

Upprätta en TCP-anslutning.

await open_unix_connection()

Upprätta en Unix-socketanslutning.

await start_server()

Starta en TCP-server.

await starta_unix_server()

Starta en Unix-socket-server.

StreamReader

Async/await-objekt på hög nivå för att ta emot nätverksdata.

StreamWriter

Async/await-objekt på hög nivå för att skicka nätverksdata.

Exempel

Synkronisering

Trådliknande synkroniseringsprimitiver som kan användas i Tasks.

Lock

Ett mutexlås.

Händelse

Ett händelseobjekt.

Villkor

Ett villkorat objekt.

Semaphore

En semafor.

BoundedSemaphore

En avgränsad semafor.

Barriär

Ett barriärobjekt.

Exempel

Undantag

asyncio.CancelledError

Utlöses när en Task avbryts. Se även Task.cancel().

asyncio.BrokenBarrierError

Utlöses när en barriär bryts. Se även Barrier.wait().

Exempel