该模块实现 eventlet 中的 “绿色线程” 即协程。
目录
一、模块级函数
sleep()
spawn()
模块级函数
eventlet.greenthread.sleep(seconds=0)
- 在至少参数 seconds 秒后让出控制权，参数 seconds 可以是一个整数，也可是浮点型的。当参数 seconds 为0时，主动让出控制权，在执行长时间计算时这么做有助于让别的协程也得到执行。
- eventlet.greenthread.spawn(func, *args, **kwargs)
- 孵化（创建）一个可以调用 func(*args, **kwargs) 的协程，返回一个 GreenThread 对象，可以使用该对象获得调用 func(*args, **kwargs) 的返回值。
- 这条指令执行后控制权立即返回给调用这个接口的函数，创建的协程只是有了调用 func(*args, **kwargs) 的能力，而不是这里一孵化，协程就会立刻调用 func(*args, **kwargs)。 spawn_after() 可以指定在一定时间后孵化一个协程。
- eventlet.greenthread.spawn_n(func, *args, **kwargs)
- 孵化（创建）一个可以调用 func(*args, **kwargs) 的协程，这里返回的协程不能获取 func(*args, **kwargs) 的返回值或者抛出的异常，比 spawn() 更快，当没有关键字参数的时候该指令运行最快。
- 如果函数抛出一个异常，spawn_n 会打印堆栈轨迹，可以通过 eventlet.debug.hub_exceptions() 将这个功能关闭。
- eventlet.greenthread.spawn_after(seconds, func, *args, **kwargs)
- 参数 seconds 秒后孵化一个可以调用 func 的协程。返回一个 GreenThread 对象，可以用来获取调用 func 的返回值。
- eventlet.greenthread.spawn_after_local(seconds, func, *args, **kwargs)
- seconds 秒后孵化协程，如果当前的协程退出，那么函数不会被调用。 seconds 可以是整数或者浮点数，参数 func 会在自己所在的协程中执行，传给它的参数正好是 args 和 kwargs。
- 返回一个 GreenThread 对象，可以获取 func 的返回值。
- GreenThread 对象
- class eventlet.greenthread.GreenThread(parent)
- GreenThread 类是 Greenlet 的子类，添加了能够获取主函数返回值的功能，不要直接构造 GreenThread 对象，而是用 spawn() 函数来孵化一个新的协程！
- cancel(*throw_args)
- 如果这个协程还没有运行，等价于杀掉它，如果这个协程已经运行了，这里会等待它运行完，然后杀掉它。一旦调用过这个函数，所有的 wait() 调用都会抛出异常 throw_args (默认为 greenlet.GreenletExit)。
- kill(*throw_args)
- 强制杀掉协程，就算协程里面的函数已经运行了也要杀掉它。一旦调用过这个函数，所有的 wait() 调用都会抛出异常 throw_args (默认为 greenlet.GreenletExit)。
- link(func, *curried_args, **curried_kwargs)
- 建立一个函数 func ，这个函数会以当前协程的结果为参数调用。
- 函数 func 应该有以下这种签名：
def func(gt, [curried args/kwargs]):
- 当协程运行完成后，它会立刻调用 func ，将自己和 curried arguments 一起传递给 func 。如果 func 想要获取协程的返回值，就应该调用第一个参数，也就是调用自己的那个协程的 wait() 方法。
- func 以调用自己的协程的上下文运行，所以有可能会干扰其他被连接的函数，比如通过显式切换到其他的协程。
- unlink(func, *curried_args, **curried_kwargs)
- 移除 link() 函数设置的连接，如果成功返回 True ,否则返回 False。
- wait()
- 返回当前协程中主函数的执行结果，如果是一般的执行结果，wait() 会返回它；如果是异常，wait() 会抛出同样的异常（但是堆栈轨迹不可避免的包含一些协程模块中的帧）。