xlocal 0.5

此模块提供了执行本地化，即“xlocal”对象，它实现了一种更受限制的“线程本地”变体。执行本地化允许以类似于真实局部变量的方式按执行方式管理属性

• 被调用的函数不能更改调用函数的绑定

• 绑定存在于代码块中（及其调用的所有内容）

xlocal 对象的属性绑定不会泄漏到代码块之外，也不会泄漏到其他 greenlets 线程。相比之下，进程全局和所谓的“线程本地”都不实现上述属性。

让我们看一个基本示例

# content of example.py

from xlocal import xlocal

xcurrent = xlocal()

def output():
    print "hello world", xcurrent.x

if __name__ == "__main__":
    with xcurrent(x=1):
        output()

如果我们执行此模块，output() 函数将看到一个 xcurrent.x==1 绑定

$ python example.py
hello world 1

以下是详细情况：当执行 xcurrent(x=1) 时，它返回一个上下文管理器，该管理器设置/重置 x 属性在 xcurrent 对象上。在同一个线程/greenlet 中，所有由 with-body 触发的代码（在这个例子中只是 output() 函数）都可以访问 xcurrent.x。在 with-body 之外，xcurrent.x 将引发 AttributeError。也不允许直接设置 xcurrent 属性；您必须始终使用 with 语句明确标记其生命周期。这意味着被调用的代码

• 不能重新绑定调用函数的 xlocal 状态（没有副作用，真好！）

• xlocal 状态不会泄漏到 with 上下文之外（生命周期控制）

现在另一个模块可以重用示例代码

# content of example_call.py
import example

with example.xcurrent(x=3):
    example.output()

当运行时…

$ python example_call.py
hello world 3

这将会导致example.output()函数打印出在调用with xcurrent(x=3)语句时定义的绑定。

其他线程或greenlets将永远看不到这个绑定；它们甚至可以设置和读取它们自己的独特的对象。这意味着所有的线程/greenlets都可以并发调用一个函数，该函数总是会看到执行特定的属性。

xcurrent = xlocal()

def with_xlocal(func, **kwargs):
    with xcurrent(**kwargs):
        func()

def handle_request(request):
    func = gethandler(request)  # some user code
    spawn(with_xlocal(func, request=request))

Class Renderer:
    @property
    def request(self):
        return xcurrent.request