1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
from zope.deprecation import deprecated
from zope.interface import implements
from zope.interface.interface import InterfaceClass
from webob import Request as WebobRequest
from repoze.bfg.interfaces import IRequest
def make_request_ascii(event):
""" An function that is useful as a
:class:`repoze.bfg.interfaces.INewRequest` :term:`event`
:term:`subscriber` that causes the request charset to be ASCII so
code written before :mod:`repoze.bfg` 0.7.0 can continue to work
without a change"""
request = event.request
request.default_charset = None
class Request(WebobRequest):
"""
A subclass of the :term:`WebOb` Request class. An instance of
this class is created by the :term:`router` and is provided to a
view callable (and to other subsystems) as the ``request``
argument.
The documentation below (save for the ``add_response_callback``
method, which is defined in this subclass itself, and the
attributes ``context``, ``registry``, ``root``, ``subpath``,
``traversed``, ``view_name``, ``virtual_root`` , and
``virtual_root_path``, each of which is added to the request at by
the :term:`router` at request ingress time) are autogenerated from
the WebOb source code used when this documentation was generated.
Due to technical constraints, we can't yet display the WebOb
version number from which this documentation is autogenerated, but
it will be the 'prevailing WebOb version' at the time of the
release of this :mod:`repoze.bfg` version. See
`http://http://pythonpaste.org/webob/
<http://pythonpaste.org/webob/>`_ for further information.
"""
implements(IRequest)
response_callbacks = ()
default_charset = 'utf-8'
def add_response_callback(self, callback):
"""
Add a callback to the set of callbacks to be called by the
:term:`router` at a point after a :term:`response` object is
successfully created. :mod:`repoze.bfg` does not have a
global response object: this functionality allows an
application to register an action to be performed against the
response once one is created.
A 'callback' is a callable which accepts two positional
parameters: ``request`` and ``response``. For example:
.. code-block:: python
:linenos:
def cache_callback(request, response):
'Set the cache_control max_age for the response'
response.cache_control.max_age = 360
request.add_response_callback(cache_callback)
Response callbacks are called in the order they're added
(first-to-most-recently-added). No response callback is
called if an exception happens in application code, or if the
response object returned by :term:`view` code is invalid.
All response callbacks are called *before* the
:class:`repoze.bfg.interfaces.INewResponse` event is sent.
Errors raised by callbacks are not handled specially. They
will be propagated to the caller of the :mod:`repoze.bfg`
router application. """
callbacks = self.response_callbacks
if not callbacks:
callbacks = []
callbacks.append(callback)
self.response_callbacks = callbacks
def _process_response_callbacks(self, response):
for callback in self.response_callbacks:
callback(self, response)
self.response_callbacks = ()
# override default WebOb "environ['adhoc_attr']" mutation behavior
__getattr__ = object.__getattribute__
__setattr__ = object.__setattr__
__delattr__ = object.__delattr__
# b/c dict interface for "root factory" code that expects a bare
# environ. Explicitly omitted dict methods: clear (unnecessary),
# copy (implemented by WebOb), fromkeys (unnecessary)
def __contains__(self, k):
return self.environ.__contains__(k)
def __delitem__(self, k):
return self.environ.__delitem__(k)
def __getitem__(self, k):
return self.environ.__getitem__(k)
def __iter__(self):
return iter(self.environ)
def __setitem__(self, k, v):
self.environ[k] = v
def get(self, k, default=None):
return self.environ.get(k, default)
def has_key(self, k):
return self.environ.has_key(k)
def items(self):
return self.environ.items()
def iteritems(self):
return self.environ.iteritems()
def iterkeys(self):
return self.environ.iterkeys()
def itervalues(self):
return self.environ.itervalues()
def keys(self):
return self.environ.keys()
def pop(self, k):
return self.environ.pop(k)
def popitem(self):
return self.environ.popitem()
def setdefault(self, v, default):
return self.environ.setdefault(v, default)
def update(self, v, **kw):
return self.environ.update(v, **kw)
def values(self):
return self.environ.values()
def route_request_iface(name, bases=()):
iface = InterfaceClass('%s_IRequest' % name, bases=bases)
# for exception view lookups
iface.combined = InterfaceClass('%s_combined_IRequest' % name,
bases=(iface, IRequest))
return iface
def add_global_response_headers(request, headerlist):
def add_headers(request, response):
for k, v in headerlist:
response.headerlist.append((k, v))
request.add_response_callback(add_headers)
from repoze.bfg.threadlocal import get_current_request as get_request # b/c
get_request # prevent PyFlakes complaints
deprecated('get_request',
'As of repoze.bfg 1.0, any import of get_request from'
'``repoze.bfg.request`` is '
'deprecated. Use ``from repoze.bfg.threadlocal import '
'get_current_request instead.')
|
