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

3.4 版本中新加入。

源代码︰lib/asyncio/

注意

asyncio包已经在临时基础中包含在标准库中。如果核心开发人员认为必要，则可能会发生向后不兼容的更改（直到并包括模块的删除）。

此模块为编写单线程并发代码提高基础架构，通过使用协程、套接字和其他资源的 I/O 多路复用，运行网络客户端和服务器，以及其他相关的基元。以下是更详细的软件包内容列表：

• 各种系统具体实现的可插拔 事件循环 ;
• 传输 和 协议 抽象（类似于 Twisted 里的那些） ;
• 具体支持 TCP、 UDP、 SSL、 子进程管道，延迟调用，和其他 （有些可能依赖于系统）;
• 一个模仿 concurrent.futures 模块但适合在事件循环中使用的 Future 类;
• 基于 yield from ( PEP 380)的协程和任务帮助以顺序的方式编写并发代码;
• 取消操作支持 Future 和协程;
• 单线程的协程间使用的 同步基元 类似于 threading 模块里那些;
• 一个接口，用于将工作传递到线程池，在绝对，明确不得不使用一个阻塞I / O调用的库的时候。

异步编程比经典的"顺序"编程更复杂︰ 查看 Develop with 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.设置信号情报和 SIGTERM 信号处理程序
• 18.5.2.事件循环
  • 18.5.2.1.事件循环函数
  • 18.5.2.2.可用事件循环
  • 18.5.2.3.平台支持
    • 18.5.2.3.1. Windows
    • 18.5.2.3.2. Mac OS X
  • 18.5.2.4.事件循环策略和默认策略
  • 18.5.2.5.事件循环政策接口
  • 18.5.2.6.获取global循环政策
• 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. InvalidStateError 0>>
  • 18.5.3.3. TimeoutError
  • 18.5.3.4.未来
    • 18.5.3.4.1.示例：未来与run_until_complete()
    • 18.5.3.4.2.示例：未来与run_forever()
  • 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. BaseTransport
    • 18.5.4.1.2. ReadTransport
    • 18.5.4.1.3. WriteTransport
    • 18.5.4.1.4. DatagramTransport
    • 18.5.4.1.5. BaseSubprocessTransport
  • 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 echo服务器协议
    • 18.5.4.3.3. UDP echo client protocol
    • 18.5.4.3.4. UDP echo服务器协议
    • 18.5.4.3.5.注册打开的套接字以使用协议等待数据
• 18.5.5.流 (协同基于 API)
  • 18.5.5.1.流函数
  • 18.5.5.2. StreamReader
  • 18.5.5.3. StreamWriter
  • 18.5.5.4. StreamReaderProtocol
  • 18.5.5.5. IncompleteReadError
  • 18.5.5.6. LimitOverrunError
  • 18.5.5.7.流示例
    • 18.5.5.7.1. TCP echo客户端使用流
    • 18.5.5.7.2. TCP echo服务器使用流
    • 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. BoundedSemaphore
• 18.5.8.队列
  • 18.5.8.1.队列
  • 18.5.8.2. PriorityQueue
  • 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。