Request and Response¶
Pylons magic globals¶
Pylons has several magic globals that contain state data for the current request. Here are the closest Pyramid equivalents:
The request URL, query parameters, etc. In Pyramid it's the
requestargument to view functions and
self.requestin view methods (if your class constructor follows the normal pattern). In templates it's
req(starting in Pyramid 1.3). In pshell or unit tests where you can't get it any other way, use
request = pyramid.threadlocal.get_current_request().
The HTTP response status and document. Pyramid does not have a global response object. Instead, your view should create a
pyramid.response.Responseinstance and return it. If you're using a renderer, it will create a response object for you.
For convenience, there's a
request.responseobject available which you can set attributes on and return, but it will have effect only if you return it. If you're using a renderer, it will honor changes you make to
Session variables. See the Sessions chapter.
A scratch object for request-local data, usually used to pass varables to the template. In Pyramid, you return a dict of variables and let the renderer apply them to a template. Or you can render a template yourself in view code.
If the view is a method, you can also set instance variables. The view instance is visible as
viewin templates. There are two main use cses for this. One, to set variables for the site template that would otherwise have to be in every return dict. Two, for variables that are specific to HTML rendering, when the view is registered with both an HTML renderer and a non-HTML renderer (e.g., JSON).
Pyramid does have a port of "tmpl_context" at
request.tmpl_context, which is visible in templates as
c. However, it never caught on among Pyramid-Pylons users and is no longer documented.
Global variables shared across all requests. The nearest equivalent is
request.registry.settings. This normally contains the application settings, but you can also store other things in it too. (The registery is a singleton used internally by Pyramid.)
A cache object, used to automatically save the results of expensive calculations for a period of time, across multiple requests. Pyramid has no built-in equivalent, but you can set up a cache using "pyramid_beaker". You'll probably want to put the cache in the settings?
A URL generator. Pyramid's request object has methods that generate URLs. See also the URL Generator chapter for a convenience object that reduces boilerplate code.
Request and response API¶
Pylons uses WebOb's request and response objects. Pyramid uses subclasses of
these so all the familiar attributes and methods are there:
body_file. The most commonly-used attribute is
which is the query parameters and POST variables.
Pyramid adds several attributes and methods.
tmpl_context access the request's state data and global application data.
Rather than repeating the existing documentation for these attributes and methods, we'll just refer you to the original docs:
1response = request.response 2 3# -OR- 4from pyramid.response import Response 5response = Response 6 7# In either case. 8response.status = "200 OK" 9response.status_int = 200 10response.content_type = "text/plain" 11response.charset = "utf-8" 12response_headerlist = [ 13 ("Set-Cookie", "abc=123"), ("X-My-Header", "foo")] 14response_cache_for = 3600 # Seconds 15return response