Python 协程 asyncio 之 ABC_a coroutine object is required

loop.run_until_complete(main())

第一个异步函数是通过创建loop循环去调用，其他异步函数之间通过await进行调用。  
 像下面的一个例子

import asyncio
import time

async def say_after(delay, what):
    await asyncio.sleep(delay)
    print(what)

async def main():
    print(f"started at {time.strftime(‘%X’)}")

await say_after(1, ‘hello’)
    await say_after(2, ‘world’)

print(f"finished at {time.strftime(‘%X’)}")

if name == ‘main’:
    loop = asyncio.get_event_loop()
    # 阻塞直到hello world()协程结束时返回
    loop.run_until_complete(main())
    loop.close()

或者我们可以通过asyncio.create\_task()将协程say\_after封装任务去调用就像下面这样。

async def main():
    task1 = asyncio.create_task(
        say_after(1, ‘hello’))

task2 = asyncio.create_task(
        say_after(2, ‘world’))

print(f"started at {time.strftime(‘%X’)}")

# 等待两个子任务完成
    await task1
    await task2
    print(f"finished at {time.strftime(‘%X’)}")

#### Awaitables


我们说,如果一个对象可以用在await表达式中，那么它就是Awaitables的对象。  
 可等待对象主要有三种类型:coroutines, Tasks, and Futures.


Coroutines


前面的代码中演示了协程的运作方式，这里主要强调两点。


* 协程函数：asyc def定义的函数;
* 协程对象:通过调用协程函数返回的对象。


Tasks


任务对协程进一步封装，其中包含任务的各种状态。  
 协程对象不能直接运行，在注册事件循环的时候，其实是run\_until\_complete方法将协程包装成为了一个任务（task）对象。

import asyncio

async def nested():
    await asyncio.sleep(2)
    print(“等待2s”)

async def main():
    # 将协程包装成任务含有状态
    # task = asyncio.create_task(nested())
    task = asyncio.ensure_future(nested())
    print(task)
    # “task” can now be used to cancel “nested()”, or
    # can simply be awaited to wait until it is complete:
    await task
    print(task)
    print(task.done())

if name == ‘main’:
    loop = asyncio.get_event_loop()
    try:
        loop.run_until_complete(main())
    except KeyboardInterrupt as e:
        for task in asyncio.Task.all_tasks():
            print(task)
            task.cancel()
            print(task)
        loop.run_forever()  # restart loop
    finally:
        loop.close()

可以看到

<Task pending coro=<nested() running at /Users/chennan/pythonproject/asyncproject/asyncio-cn/1-2-1.py:9>>
等待2s
<Task finished coro=<nested() done, defined at /Users/chennan/pythonproject/asyncproject/asyncio-cn/1-2-1.py:9> result=None>
True

创建task后，task在加入事件循环之前是pending状态然后调用nested函数等待2s之后打印task为finished状态。asyncio.ensure\_future(coroutine) 和 loop.create\_task(coroutine)都可以创建一个task，python3.7增加了asyncio.create\_task(coro)。其中task是Future的一个子类


### Future


future:代表将来执行或没有执行的任务的结果。它和task上没有本质的区别  
 通常不需要在应用程序级别代码中创建Future对象。  
 future对象有几个状态：


* Pending
* Running
* Done
* Cancelled


通过上面的代码可以知道创建future的时候，task为pending，事件循环调用执行的时候是running,调用完毕自然就是done于是调用task.done()打印了true。


如果在命令行中运行上述代码,ctrl+c后会发现  
 输出以下内容

<Task pending coro=<nested() running at 1-2-1.py:9>>
^C<Task pending coro=<main() running at 1-2-1.py:21> wait_for=<Task pending coro=<nested() running at 1-2-1.py:10> wait_for=<Future pending cb=[<TaskWakeupMethWrapper object at 0x10d342978>()]> cb=[<TaskWakeupMethWrapper object at 0x10d342918>()]>>
<Task pending coro=<main() running at 1-2-1.py:21> wait_for=<Task pending coro=<nested() running at 1-2-1.py:10> wait_for= cb=[<TaskWakeupMethWrapper object at 0x10d342918>()]>>
<Task pending coro=<nested() running at 1-2-1.py:10> wait_for= cb=[<TaskWakeupMethWrapper object at 0x10d342918>()]>
<Task cancelling coro=<nested() running at 1-2-1.py:10> wait_for= cb=[<TaskWakeupMethWrapper object at 0x10d342918>()]>

因为我们调用了task.cancel() 所以可以看到此时的任务状态为取消状态。


并发的执行任务


通过使用await+asyncio.gather可以完成并发的操作。  
 asyncio.gather用法如下。  
**asyncio.gather(\*aws, loop=None, return\_exceptions=False)**  
 \*\*aws是一系列协程,协程都成功完成，就返回值一个结果列表。结果值的顺序与aws中添加协程的顺序相对应。  
 return\_exceptions=False,其实就是如果有一个任务失败了,就直接抛出异常。如果等于True就把错误信息作为结果返回回来。  
 首先来一个正常情况不出错的例子:

import asyncio

async def factorial(name, number):
    f = 1
    for i in range(2, number + 1):
        print(f"Task {name}: Compute factorial({i})…“)
        if number == 2:
            1 / 0
        await asyncio.sleep(1)
        f *= i
    print(f"Task {name}: factorial({number}) = {f}”)

async def main():
    # Schedule three calls concurrently:
    res = await asyncio.gather(
        *[factorial(“A”, 2),
          factorial(“B”, 3),
          factorial(“C”, 4)]
        , return_exceptions=True)
    for item in res:
        print(item)

if name == ‘main’:
    loop = asyncio.get_event_loop()
    try:
        loop.run_until_complete(main())
    except KeyboardInterrupt as e:
        for task in asyncio.Task.all_tasks():
            print(task)
            task.cancel()
            print(task)
        loop.run_forever()  # restart loop
    finally:
        loop.close()

输入以下内容：

Task A: Compute factorial(2)…
Task B: Compute factorial(2)…
Task C: Compute factorial(2)…
Task B: Compute factorial(3)…
Task C: Compute factorial(3)…
Task B: factorial(3) = 6
Task C: Compute factorial(4)…
Task C: factorial(4) = 24
division by zero
None
None

可以发现async.gather最后会返回一系列的结果，如果出现了错误就把错误信息作为返回结果，这里我当数字为2时人为加了异常操作1/0，于是返回了结果division by zero，对于其他的任务因为没有返回值所以是None。这里return\_exceptions=True来保证了如果其中一个任务出现异常，其他任务不会受其影响会执行到结束。


**asyncio.wait**

coroutine asyncio.wait(aws, *, loop=None, timeout=None, return_when=ALL_COMPLETED)

asyncio.wait和async.gather用法差不多只是async.wait接收的是个列表。  
 第三个参数和async.gather有点区别.




| 参数名 | 含义 |
| --- | --- |
| FIRST\_COMPLETED | 任何一个future完成或取消时返回 |
| FIRST\_EXCEPTION | 任何一个future出现错误将返回，如果出现异常等价于ALL\_COMPLETED |
| ALL\_COMPLETED | 当所有任务完成或者被取消时返回结果，默认值。 |


#### Timeouts


通过使用asyncio.wait\_for来完成一个超时函数回调操作，如果函数规定时间内未完成则报错。  
**asyncio.wait\_for(aw, timeout, \*, loop=None)**  
 aw代表一个协程，timeout单位秒。

async def eternity():
    # Sleep for one hour
    await asyncio.sleep(3600)
    print(‘yay!’)

async def main():
    # Wait for at most 1 second
    try:
        await asyncio.wait_for(eternity(), timeout=1.0)
    except asyncio.TimeoutError:
        print(‘timeout!’)

asyncio.run(main())

# Expected output:

#     timeout!

1秒内eternity没有完成就报错了。  
 python3.7中发生更改:当aw由于超时而被取消时，不再显示异常而是等待aw被取消。  
 说到timeout的，如果仅仅是对一个代码块做timeout操作而不是等待某个协程此时推荐第三方模块async\_timeout


#### async\_timeout


安装

pip installa async_timeout

使用方法很简单如下

async with async_timeout.timeout(1.5) as cm:
    await inner()
print(cm.expired)

如果1.5s可以运行完打印true,否则打印false,表示超时。


#### asyncio.as\_completed


**asyncio.as\_completed(aws, \*, loop=None, timeout=None)**  
 使用as\_completed会返回一个可以迭代的future对象,同样可以获取协程的运行结果，使用方法如下：

async def main():
    coroutine1 = do_some_work(1)
    coroutine2 = do_some_work(2)
    coroutine3 = do_some_work(4)

tasks = [
        asyncio.ensure_future(coroutine1),
        asyncio.ensure_future(coroutine2),
        asyncio.ensure_future(coroutine3)
    ]
    for task in asyncio.as_completed(tasks):
        result = await task
        print(‘Task ret: {}’.format(result))

start = now()

loop = asyncio.get_event_loop()
done = loop.run_until_complete(main())
print('TIME: ', now() - start)

#### 协程嵌套


使用async可以定义协程，协程用于耗时的io操作，我们也可以封装更多的io操作过程，这样就实现了嵌套的协程，即一个协程中await了另外一个协程，如此连接起来  
 官网实例：




如果你也是看准了Python，想自学Python，在这里为大家准备了丰厚的免费**学习**大礼包，带大家一起学习，给大家剖析Python兼职、就业行情前景的这些事儿。



### 一、Python所有方向的学习路线

Python所有方向路线就是把Python常用的技术点做整理，形成各个领域的知识点汇总，它的用处就在于，你可以按照上面的知识点去找对应的学习资源，保证自己学得较为全面。



![](https://img-blog.csdnimg.cn/img_convert/9f49b566129f47b8a67243c1008edf79.png)

### 二、学习软件



工欲善其必先利其器。学习Python常用的开发软件都在这里了，给大家节省了很多时间。



![](https://img-blog.csdnimg.cn/img_convert/8c4513c1a906b72cbf93031e6781512b.png)



### 三、全套PDF电子书

书籍的好处就在于权威和体系健全，刚开始学习的时候你可以只看视频或者听某个人讲课，但等你学完之后，你觉得你掌握了，这时候建议还是得去看一下书籍，看权威技术书籍也是每个程序员必经之路。

![](https://img-blog.csdnimg.cn/img_convert/eec417a3d4d977b313558a11d3c13e43.png)



### 四、入门学习视频

我们在看视频学习的时候，不能光动眼动脑不动手，比较科学的学习方法是在理解之后运用它们，这时候练手项目就很适合了。



![](https://img-blog.csdnimg.cn/img_convert/ec690501ea1dbe2cb209cbf4013c2477.png)  

![](https://img-blog.csdnimg.cn/img_convert/3eaeaa6747419c9d86c72e0d10d0a6a2.png)



### 四、实战案例

光学理论是没用的，要学会跟着一起敲，要动手实操，才能将自己的所学运用到实际当中去，这时候可以搞点实战案例来学习。



![](https://img-blog.csdnimg.cn/img_convert/252731a671c1fb70aad5355a2c5eeff0.png)



### 五、面试资料

我们学习Python必然是为了找到高薪的工作，下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料，并且有阿里大佬给出了权威的解答，刷完这一套面试资料相信大家都能找到满意的工作。

![](https://img-blog.csdnimg.cn/img_convert/6c361282296f86381401c05e862fe4e9.png)

成为一个Python程序员专家或许需要花费数年时间，但是打下坚实的基础只要几周就可以，如果你按照我提供的学习路线以及资料有意识地去实践，你就有很大可能成功！
最后祝你好运！！！




**网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。**

**[需要这份系统化学习资料的朋友，可以戳这里无偿获取](https://bbs.csdn.net/topics/618317507)**

**一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**