# `asyncio` --- 非同期 I/O

asyncio は async/await 構文を使い 並行処理の コードを書くためのライブラリです。

asyncio は、高性能なネットワークとウェブサーバ、データベース接続ライブラリ、分散タスクキューなどの複数の非同期 Python フレームワークの基盤として使われています。

asyncio は多くの場合、 IOバウンドだったり高レベルの 構造化された ネットワークコードに完璧に適しています。

asyncio は次の目的で 高レベル API を提供しています:

- 並行に Python コルーチンを起動 し、実行全体を管理する

- ネットワーク IO と IPC を執り行う

- subprocesses を管理する

- キュー を使ってタスクを分散する

- 並列処理のコードを 同期 させる

これに加えて、 ライブラリやフレームワークの開発者 が次のことをするための 低レベル API があります:

- create and manage event loops, which provide asynchronous APIs for networking, running subprocesses, handling OS signals, etc;

- Transport を使った効率的な protocol を実装します

- コールバックを用いたライブラリと async/await 構文を使ったコードの 橋渡し

You can experiment with an `asyncio` concurrent context in the REPL:

    $ python -m asyncio
    asyncio REPL ...
    Use "await" directly instead of "asyncio.run()".
    Type "help", "copyright", "credits" or "license" for more information.
    >>> import asyncio
    >>> await asyncio.sleep(10, result='hello')
    'hello'

利用可能性: Emscripten でなく、WASI でもないこと。

このモジュールは WebAssembly プラットフォーム `wasm32-emscripten` と `wasm32-wasi` では動作しないか、利用不可です。詳しくは、WebAssemblyプラットフォーム を見てください。

リファレンス

高レベル API

- Runners
- コルーチンと Task
- ストリーム
- 同期プリミティブ
- サブプロセス
- キュー
- 例外

低レベル API

- イベントループ
- Future
- トランスポートとプロトコル
- ポリシー
- プラットフォームでのサポート
- Extending

ガイドとチュートリアル

- 高水準の API インデックス
- 低水準の API インデックス
- asyncio での開発

注釈

asyncio のソースコードは Lib/asyncio/ にあります。