asyncio --- 非同步 I/O

---

Hello World!

import asyncio

async def main():
    print('Hello ...')
    await asyncio.sleep(1)
    print('... World!')

asyncio.run(main())

asyncio 是讓使用者以 async/await 語法來編寫並行 (concurrent) 程式碼的函式庫 (library)。

asyncio 作為多個 Python 非同步框架的基礎，在高效能網路與網頁伺服器、資料庫連線函式庫、分散式任務佇列等服務都可以看得到它。

asyncio 往往是個建構 IO 密集型與高階層結構化網路程式碼的完美選擇。

asyncio 提供了一系列高階 API：

• 並行地運行 Python 協程 (coroutine) 並擁有完整控制權；

• 執行網路 IO 與 IPC；

• 控制子行程 (subprocess)；

• 透過佇列 (queue) 分配任務；

• 同步並行程式碼；

此外，還有一些給函式庫與框架 (framework) 開發者的低階 API：

• 建立與管理 event loops（事件迴圈），它提供了能被用於網路、執行子行程、處理作業系統訊號等任務的非同步 API；

• 使用 transports（asyncio 底層傳輸相關類別）來實作高效能協定；

• 透過 async/await 語法來橋接基於回呼 (callback-based) 的函式庫與程式碼。

Availability: not WASI.

This module does not work or is not available on WebAssembly. See WebAssembly 平台 for more information.

asyncio REPL

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'

Raises an auditing event cpython.run_stdin with no arguments.

在 3.12.5 版的變更: (also 3.11.10, 3.10.15, 3.9.20, and 3.8.20) Emits audit events.

在 3.13 版的變更: Uses PyREPL if possible, in which case PYTHONSTARTUP is also executed. Emits audit events.

參閱

高階 API

• Runners (執行器)
• 協程與任務
• 串流
• 同步化原始物件 (Synchronization Primitives)
• 子行程
• 佇列 (Queues)
• 例外

低階 API

• 事件迴圈
• Futures
• 傳輸與協定
• Policies
• 平臺支援
• 擴充

指南與教學

• 高階 API 索引
• 低階 API 索引
• 使用 asyncio 開發

備註

asyncio 的原始碼可以在 Lib/asyncio/ 中找到。