coroutines 0.3.0

这是一个小型软件包，它提供了一些工具来在没有asyncio事件循环的情况下运行异步函数和生成器。

coroutines模块提供了一些函数，例如coroutines.run()、coroutines.gather()和coroutines.sleep()，它们的工作方式与它们的asyncio对应物相同，但不会在任何外部事件循环中安排任何任务。例如，以下代码是从asyncio文档中改编的。

import coroutines

async def factorial(name, number):
    f = 1
    for i in range(2, number + 1):
        print(f"Task {name}: Compute factorial({number}), currently i={i}...")
        await coroutines.sleep()  # CHANGED: no argument
        f *= i
    print(f"Task {name}: factorial({number}) = {f}")
    return f

async def main():
    # Schedule three calls *concurrently*:
    L = await coroutines.gather(
        factorial("A", 2),
        factorial("B", 3),
        factorial("C", 4),
    )
    print(L)

coroutines.run(main())

# Expected output:
#
#     Task A: Compute factorial(2), currently i=2...
#     Task B: Compute factorial(3), currently i=2...
#     Task C: Compute factorial(4), currently i=2...
#     Task A: factorial(2) = 2
#     Task B: Compute factorial(3), currently i=3...
#     Task C: Compute factorial(4), currently i=3...
#     Task B: factorial(3) = 6
#     Task C: Compute factorial(4), currently i=4...
#     Task C: factorial(4) = 24
#     [2, 6, 24]

示例通过简单地调用、挂起和恢复协程直到它们完成，产生了与asyncio代码相同的结果。实际上，coroutines和asyncio示例之间的唯一区别是，coroutines.sleep()不接受参数。因为没有外部事件循环，对coroutines.sleep()的调用不能挂起当前协程链一定的时间，而只能挂起到下一次迭代恢复为止。

coroutines.run(coro) #

awaitable coroutines.sleep() #

awaitable coroutines.gather(*aws) #

awaitable coroutines.awaitable(obj=None) #

awaitable coroutines.aiterable(iterable) #

awaitable coroutines.arange(stop) #
awaitable coroutines.arange(start, stop[, step])