django-pandora 0.1.0

安装

1. pip install django-pandora

2. 将 'pandora.middleware.RequestMiddleware' 添加到你的 MIDDLEWARE_CLASSES 设置中。 (可选)

用法

pandora.box 对象实现了一个类似dict的接口，你可以使用它来存储线程局部值。使用起来非常简单，就像使用字典一样

>>> from pandora import box
>>> box['foo'] = 'Hello world!'
>>> box['foo']
'Hello world!'
>>> 'foo' in box
True
>>> 'bar' in box
False
>>> box['bar']
Traceback (most recent call last):
  ...
KeyError: 'bar'
>>> box.get('bar', None)
None

如上所述，您可能想使用盒子来存储当前的请求对象。Pandora附带了一个用于此目的的自定义中间件。只需将'pandora.middleware.RequestMiddleware'添加到您的MIDDLEWARE_CLASSES设置中。然后您可以使用box['request']来访问请求。

还有一个中间件可以将当前用户对象存储在box['user']中。要使用此中间件，请将'pandora.middleware.UserMiddleware'添加到您的MIDDLEWARE_CLASSES设置中，但请确保它排在'django.contrib.auth.middleware.AuthenticationMiddleware'之后。

提示

• 如果您认为“盒子”这个名字太通用，可能会与您的某些本地名称冲突，则无需将“盒子”对象导入到您的模块中。只需使用

  >>> import pandora
  >>> pandora.box['request']
  ...

• 即使打开潘多拉的盒子看起来可能并不那么邪恶，但请尽量避免这样做，并在可能的情况下传递请求对象或其他依赖项。全局状态会使事情对每个人来说都更加困难——尤其是对可靠测试您的代码来说。

• 阅读维基百科上的潘多拉盒子文章。