async_generator 1.10

async_generator库

Python 3.6添加了异步生成器。 （什么是异步生成器？ 查看我在PyCon 2016的5分钟闪电演讲演示。）Python 3.7添加了一些工具使它们可用，如contextlib.asynccontextmanager。

此库将所有这些功能都带回了Python 3.5。

例如，此代码只能在Python 3.6+中运行

async def load_json_lines(stream_reader):
    async for line in stream_reader:
        yield json.loads(line)

但此代码执行相同的操作，并在Python 3.5+上运行

from async_generator import async_generator, yield_

@async_generator
async def load_json_lines(stream_reader):
    async for line in stream_reader:
        await yield_(json.loads(line))

或者，在Python 3.7中，你可以写

from contextlib import asynccontextmanager

@asynccontextmanager
async def background_server():
    async with trio.open_nursery() as nursery:
        value = await nursery.start(my_server)
        try:
            yield value
        finally:
            # Kill the server when the scope exits
            nursery.cancel_scope.cancel()

这与之前相同，但回退到3.5

from async_generator import async_generator, yield_, asynccontextmanager

@asynccontextmanager
@async_generator
async def background_server():
    async with trio.open_nursery() as nursery:
        value = await nursery.start(my_server)
        try:
            await yield_(value)
        finally:
            # Kill the server when the scope exits
            nursery.cancel_scope.cancel()

（如果你在3.6，你可以使用@asynccontextmanager与原生生成器。）

让我们这样做

• 安装: python3 -m pip install -U async_generator（或在Windows上，可能是py -3 -m pip install -U async_generator）

• 手册: https://async-generator.readthedocs.io/

• 错误跟踪器和源代码: https://github.com/python-trio/async_generator

• 实时聊天: https://gitter.im/python-trio/general

• 许可: MIT或Apache 2，您选择

• 贡献指南：https://trio.readthedocs.io/zh/latest/contributing.html

• 行为准则：请所有贡献者在所有项目空间中遵守我们的行为准则。

为什么有些链接提到了“trio”？

Trio 是一个专注于可用性和正确性的 Python 异步并发库 – 我们希望它易于使用，并确保正确。作为这一使命的一部分，async_generator 库由 Trio 项目维护，因为 Trio 内部使用了 async_generator。

您可以使用 async_generator 与任何异步库配合使用。它与 asyncio、Twisted 或您喜欢的任何库配合得很好。（但我们认为 Trio 非常棒。）