18.5. asyncio — 异步 I/O、事件循环、协程和任务 — Python 文档

18.5. 异步 — 异步 I/O、事件循环、协程和任务

3.4 版中的新功能。

源代码： :source:`Lib/asyncio/`

---

该模块提供了使用协程编写单线程并发代码、通过套接字和其他资源多路复用 I/O 访问、运行网络客户端和服务器以及其他相关原语的基础设施。 以下是更详细的包装内容列表：

• 具有各种系统特定实现的可插拔 事件循环 ；
• transport 和 protocol 抽象（类似于 Twisted）；
• 对 TCP、UDP、SSL、子进程管道、延迟调用等的具体支持（有些可能取决于系统）；
• Future 类模仿 concurrent.futures 模块中的类，但适用于事件循环；
• 基于 yield from (PEP 380) 的协程和任务，帮助以顺序方式编写并发代码；
• 取消支持 Future 和协程；
• 同步原语 用于在单个线程中的协程之间使用，模仿 threading 模块中的那些；
• 一个用于将工作传递给线程池的接口，当您绝对必须使用一个可以进行阻塞 I/O 调用的库时。

异步编程比经典的“顺序”编程更复杂：请参阅 使用 asyncio 开发页面，其中列出了常见陷阱并解释了如何避免它们。 在开发过程中启用调试模式以检测常见问题。

目录：

• 18.5.1. 基本事件循环
  • 18.5.1.1. 运行事件循环
  • 18.5.1.2. 通话
  • 18.5.1.3. 延迟呼叫
  • 18.5.1.4. 期货
  • 18.5.1.5. 任务
  • 18.5.1.6. 创建连接
  • 18.5.1.7. 创建监听连接
  • 18.5.1.8. 观察文件描述符
  • 18.5.1.9. 低级套接字操作
  • 18.5.1.10. 解析主机名
  • 18.5.1.11. 连接管道
  • 18.5.1.12. UNIX 信号
  • 18.5.1.13. 执行者
  • 18.5.1.14. 错误处理 API
  • 18.5.1.15. 调试模式
  • 18.5.1.16. 服务器
  • 18.5.1.17. 处理
  • 18.5.1.18. 事件循环示例
    • 18.5.1.18.1. Hello World with call_soon()
    • 18.5.1.18.2. 使用 call_later() 显示当前日期
    • 18.5.1.18.3. 观察文件描述符以获取读取事件
    • 18.5.1.18.4. 为 SIGINT 和 SIGTERM 设置信号处理程序
• 18.5.2. 事件循环
  • 18.5.2.1. 事件循环函数
  • 18.5.2.2. 可用的事件循环
  • 18.5.2.3. 平台支持
    • 18.5.2.3.1. 视窗
    • 18.5.2.3.2. Mac OS X
  • 18.5.2.4. 事件循环策略和默认策略
  • 18.5.2.5. 事件循环策略接口
  • 18.5.2.6. 访问全局循环策略
  • 18.5.2.7. 自定义事件循环策略
• 18.5.3. 任务和协程
  • 18.5.3.1. 协程
    • 18.5.3.1.1. 示例：Hello World 协程
    • 18.5.3.1.2. 示例：协程显示当前日期
    • 18.5.3.1.3. 示例：链式协程
  • 18.5.3.2. 无效状态错误
  • 18.5.3.3. 超时错误
  • 18.5.3.4. 未来
    • 18.5.3.4.1. 示例：带有 run_until_complete() 的 Future
    • 18.5.3.4.2. 示例：带有 run_forever() 的 Future
  • 18.5.3.5. 任务
    • 18.5.3.5.1. 示例：并行执行任务
  • 18.5.3.6. 任务功能
• 18.5.4. 传输和协议（基于回调的 API）
  • 18.5.4.1. 运输
    • 18.5.4.1.1. 基础传输
    • 18.5.4.1.2. 读取传输
    • 18.5.4.1.3. 写传输
    • 18.5.4.1.4. 数据报传输
    • 18.5.4.1.5. 基子进程传输
  • 18.5.4.2. 协议
    • 18.5.4.2.1. 协议类
    • 18.5.4.2.2. 连接回调
    • 18.5.4.2.3. 流媒体协议
    • 18.5.4.2.4. 数据报协议
    • 18.5.4.2.5. 流控回调
    • 18.5.4.2.6. 协程和协议
  • 18.5.4.3. 协议示例
    • 18.5.4.3.1. TCP 回显客户端协议
    • 18.5.4.3.2. TCP 回显服务器协议
    • 18.5.4.3.3. UDP 回显客户端协议
    • 18.5.4.3.4. UDP 回显服务器协议
    • 18.5.4.3.5. 使用协议注册一个打开的套接字以等待数据
• 18.5.5. Streams（基于协程的 API）
  • 18.5.5.1. 流函数
  • 18.5.5.2. 流阅读器
  • 18.5.5.3. 流写入器
  • 18.5.5.4. 流读取器协议
  • 18.5.5.5. 不完整读取错误
  • 18.5.5.6. 限制超限错误
  • 18.5.5.7. 流示例
    • 18.5.5.7.1. 使用流的 TCP 回显客户端
    • 18.5.5.7.2. 使用流的 TCP 回显服务器
    • 18.5.5.7.3. 获取 HTTP 标头
    • 18.5.5.7.4. 注册一个打开的套接字以使用流等待数据
• 18.5.6. 子进程
  • 18.5.6.1. Windows 事件循环
  • 18.5.6.2. 创建子流程：使用 Process 的高级 API
  • 18.5.6.3. 创建子流程：使用 subprocess.Popen 的低级 API
  • 18.5.6.4. 常数
  • 18.5.6.5. 过程
  • 18.5.6.6. 子进程和线程
  • 18.5.6.7. 子流程示例
    • 18.5.6.7.1. 使用传输和协议的子进程
    • 18.5.6.7.2. 使用流的子进程
• 18.5.7. 同步原语
  • 18.5.7.1. 锁
    • 18.5.7.1.1. 锁
    • 18.5.7.1.2. 事件
    • 18.5.7.1.3. 健康）状况
  • 18.5.7.2. 信号量
    • 18.5.7.2.1. 信号
    • 18.5.7.2.2. 有界信号量
• 18.5.8. 队列
  • 18.5.8.1. 队列
  • 18.5.8.2. 优先队列
  • 18.5.8.3. LifoQueue
    • 18.5.8.3.1. 例外
• 18.5.9. 使用 asyncio 进行开发
  • 18.5.9.1. asyncio 的调试模式
  • 18.5.9.2. 消除
  • 18.5.9.3. 并发和多线程
  • 18.5.9.4. 正确处理阻塞函数
  • 18.5.9.5. 日志记录
  • 18.5.9.6. 检测从未调度的协程对象
  • 18.5.9.7. 检测从未消耗的异常
  • 18.5.9.8. 正确链协程
  • 18.5.9.9. 挂起的任务已销毁
  • 18.5.9.10. 关闭传输和事件循环

也可以看看

asyncio 模块是在 PEP 3156 中设计的。 有关传输和协议的励志入门，请参阅 PEP 3153。