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：

• 创建和管理 事件循环，它提供用于 连接网络, 运行 子进程, 处理 OS 信号 等功能的异步 API；

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

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

可用性: 非 Emscripten，非 WASI。

此模块在 WebAssembly 平台 wasm32-emscripten 和 wasm32-wasi 上不适用或不可用。 请参阅 WebAssembly 平台 了解详情。

asyncio REPL

你可以在 REPL 中尝试使用 asyncio 并发上下文:

$ 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.11.10 版的變更: (also 3.10.15, 3.9.20, and 3.8.20) Emits audit events.

參閱

高階 API

• 运行器
• 协程与任务
• 串流
• 同步化原始物件 (Synchronization Primitives)
• 子行程
• 佇列 (Queues)
• 例外

低階 API

• 事件循环
• Futures
• 传输和协议
• 策略
• 平臺支援
• 扩展

指南與教學

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

備註

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