首页 > 代码库 > Python——eventlet.greenthread

Python——eventlet.greenthread

  该模块实现 eventlet 中的 “绿色线程” 即协程。

  相关的 greenlet 模块的介绍。

  目录

  一、模块级函数

    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() 会抛出同样的异常(但是堆栈轨迹不可避免的包含一些协程模块中的帧)。

Python——eventlet.greenthread