Coroutine 终止协程和异常处理

 终止协程和异常处理
 
     协程中未处理的异常会向上冒泡，传给 next 函数或 send 方法的调用方（即触发协程的对象）
     终止协程的一种方式：发送某个哨符值，让协程退出。内置的 None 和
     Ellipsis 等常量经常用作哨符值。 Ellipsis 的优点是，数据流中不太常有这个值。有人把
     StopIteration 类（类本身，而不是实例，也不抛出）作为哨符值；也就是说，
     是像这样使用的： my_coro.send(StopIteration)。从 Python 2.5 开始，客户代码可以在
     生成器对象上调用两个方法，显式地把异常发给协程。这两个方法是 throw 和 close。
 
     generator.throw(exc_type[, exc_value[, traceback]])
     　　致使生成器在暂停的 yield 表达式处抛出指定的异常。如果生成器处理了抛出的异
         常，代码会向前执行到下一个 yield 表达式，而产出的值会成为调用 generator.throw
         方法得到的返回值。如果生成器没有处理抛出的异常，异常会向上冒泡，传到调用方的上
         下文中。
 
     generator.close()
     　　 致使生成器在暂停的 yield 表达式处抛出 GeneratorExit 异常。如果生成器没有处
         理这个异常，或者抛出了 StopIteration 异常（通常是指运行到结尾），调用方不会报
         错。如果收到 GeneratorExit 异常，生成器一定不能产出值，否则解释器会抛出
         RuntimeError 异常。生成器抛出的其他异常会向上冒泡，传给调用方。
 
 让协程返回值
 
     from collections import namedtuple
 
     Results = namedtuple('Result', 'count average')
 
     def coro_average_return():
         total = 0.0
         count = 0
         average = None
         while 1:
             term = yield        #  这一版不产出值
             if term is None:    #  发送 None 会终止循环，导致协程结束，返回结果。一如既往，生成器对象会抛出 StopIteration 异常。异常对象的 value 属性保存着返回的值。
                 break
             total += term
             count += 1
             average = total / count
         return Results(count, average)
 
     coro4 = coro_average_return()
     next(coro4)
     coro4.send(10)
     coro4.send(15)
     coro4.send(3)
     try:
         coro4.send(None)
     except StopIteration as exe:
         result = exe.value        # return 表达式的值会偷偷传给调用方，赋值给 StopIteration 异常的一个属性。
                                   # 这样做有点不合常理，但是能保留生成器对象的常规行为——耗尽时抛出 StopIteration 异常。
 
     获取协程的返回值虽然要绕个圈子，但这是 PEP 380 定义的方式，当我们意识到这一点之
     后就说得通了： yield from 结构会在内部自动捕获 StopIteration 异常。这种处理方
     式与 for 循环处理 StopIteration 异常的方式一样：循环机制通过用户易于理解的方式
     处理异常。对 yield from 结构来说，解释器不仅会捕获 StopIteration 异常，还会把
     value 属性的值变成 yield from 表达式的值。但是，我们无法在控制台中使用交互的方
     式测试这种行为，因为在函数外部使用 yield from（以及 yield）会导致句法出错。