`asyncio` — 异步 I/O ¶

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

asyncio 库能编写 concurrent 代码使用 async/await 句法。

asyncio 被用作多种 Python 异步框架的基础，提供高性能网络和 Web 服务器、数据库连接库、分布式任务队列、等。

asyncio 通常完美适合 IO 绑定和高级 structured 网络代码。

asyncio 提供一组高级 API：

运行 Python 协程并发且完整控制它们的执行；
履行网络 IO 和 IPC (进程间通信) ;
控制子进程 ;
分发任务凭借队列 ;
同步并发代码；

此外，还有低级 API 对于 库和框架开发者 to:

创建和管理事件循环，提供异步 API 为 networking ，运行子进程，处理 OS signals ，等；
实现高效协议使用传输 ;
bridge 基于回调的库和采用 async/await 句法的代码。

可用性：非 WASI。

This module does not work or is not available on WebAssembly. See WebAssembly 平台了解更多信息。

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'

引发审计事件 cpython.run_stdin 不带自变量。

Changed in version 3.12.5: (also 3.11.10, 3.10.15, 3.9.20, and 3.8.20) Emits audit events.

Changed in version 3.13: Uses PyREPL if possible, in which case PYTHONSTARTUP is also executed. Emits audit events.

参考

高级 API

低级 API

指南和教程

注意

可以找到 asyncio 源代码在 Lib/asyncio/ .

上一话题

网络和进程间通信

下一话题

运行器

上一话题

下一话题

本页

asyncio — 异步 I/O ¶

上一话题

下一话题

本页

`asyncio` — 异步 I/O ¶