Ñò
;V
Lc
@ sÑ d Z d d k Z d d k l Z d d k l Z l Z d d k l Z d d k l Z d „ Z
d e f d „ ƒ YZ d
e f d „ ƒ YZ
d „ Z d
d d d d
g Z d d „ Z d e f d „ ƒ YZ d S( s
Middleware to display error documents for certain status codes
The middleware in this module can be used to intercept responses with
specified status codes and internally forward the request to an appropriate
URL where the content can be displayed to the user as an error document.
iÿÿÿÿN( t urlparse( t ForwardRequestExceptiont RecursiveMiddleware( t
converters( t replace_headerc C s] x8 | D]0 } t | t ƒ p t d t | ƒ ƒ ‚ q q Wd „ } t t | | d | ƒƒ S( sç
Intercepts a response with a particular status code and returns the
content from a specified URL instead.
The arguments are:
``app``
The WSGI application or middleware chain.
``codes``
A dictionary of integer status codes and the URL to be displayed
if the response uses that code.
For example, you might want to create a static file to display a
"File Not Found" message at the URL ``/error404.html`` and then use
``forward`` middleware to catch all 404 status codes and display the page
you created. In this example ``app`` is your exisiting WSGI
applicaiton::
from paste.errordocument import forward
app = forward(app, codes={404:'/error404.html'})
s4 All status codes should be type int. %s is not validc S s! | i | ƒ o | | Sd Sd S( N( t has_keyt None( t codet messaget environt global_conft codes( ( s7 /usr/lib/python2.6/site-packages/paste/errordocument.pyt error_codes_mapper/ s R ( t
isinstancet intt TypeErrort reprR t StatusBasedForward( t appR R R ( ( s7 /usr/lib/python2.6/site-packages/paste/errordocument.pyt forward s t StatusKeeperc B s e Z d „ Z d „ Z RS( c C s( | | _ | | _ | | _ | | _ d S( N( R t statust urlt headers( t selfR R R R ( ( s7 /usr/lib/python2.6/site-packages/paste/errordocument.pyt __init__? s c st d ‡ ‡ f d † } ˆ i i d ƒ } | d | d s R c B s# e Z d Z d d „ Z d „ Z RS( s¤
Middleware that lets you test a response against a custom mapper object to
programatically determine whether to internally forward to another URL and
if so, which URL to forward to.
If you don't need the full power of this middleware you might choose to use
the simpler ``forward`` middleware instead.
The arguments are:
``app``
The WSGI application or middleware chain.
``mapper``
A callable that takes a status code as the
first parameter, a message as the second, and accepts optional environ,
global_conf and named argments afterwards. It should return a
URL to forward to or ``None`` if the code is not to be intercepted.
``global_conf``
Optional default configuration from your config file. If ``debug`` is
set to ``true`` a message will be written to ``wsgi.errors`` on each
internal forward stating the URL forwarded to.
``**params``
Optional, any other configuration and extra arguments you wish to
pass which will in turn be passed back to the custom mapper object.
Here is an example where a ``404 File Not Found`` status response would be
redirected to the URL ``/error?code=404&message=File%20Not%20Found``. This
could be useful for passing the status code and message into another
application to display an error document:
.. code-block:: python
from paste.errordocument import StatusBasedForward
from paste.recursive import RecursiveMiddleware
from urllib import urlencode
def error_mapper(code, message, environ, global_conf, kw)
if code in [404, 500]:
params = urlencode({'message':message, 'code':code})
url = '/error?'%(params)
return url
else:
return None
app = RecursiveMiddleware(
StatusBasedForward(app, mapper=error_mapper),
)
c K sq | d j o
h } n | o" t i | i d t ƒ ƒ | _ n
t | _ | | _ | | _ | | _ | | _ d S( Nt debug(
R R t asboolt gett FalseR+ t applicationt mapperR
t params( R R R0 R
R1 ( ( s7 /usr/lib/python2.6/site-packages/paste/errordocument.pyR Πs
" c s‚ g ‰ d ‡ ‡ ‡ ‡ f d † } ˆ i ˆ | ƒ } ˆ o@ t | d ƒ o | i ƒ n ‡ f d † } t d | ƒ ‚ n | Sd S( Nc
sù | i d ƒ } y t | d ƒ } Wn3 t t f j
o! t d t | d ƒ ƒ ‚ n Xd i | d ƒ } ˆ i | | ˆ ˆ i ˆ i } | d j p
t | t ƒ p t d t | ƒ ƒ ‚ n | o ˆ i
| | | g ƒ n ˆ | | | ƒ Sd S( Nt i s@ StatusBasedForward middleware received an invalid status code %si si Expected the url to internally redirect to in the StatusBasedForward mapperto be a string or None, not %s( R% R t
ValueErrorR t ExceptionR t joinR0 R
R1 R R
t strR ( R R R t status_codeR R t new_url( R R R R ( s7 /usr/lib/python2.6/site-packages/paste/errordocument.pyt change_response s* t closec s4 t | d ˆ d d d ˆ d d d ˆ d d ƒS( NR i i R R i ( R ( R ( R ( s7 /usr/lib/python2.6/site-packages/paste/errordocument.pyt factory¾ s %R; ( R R/ t hasattrR: R ( R R R R9 t app_iterR; ( ( R R R R s7 /usr/lib/python2.6/site-packages/paste/errordocument.pyR( š s N( R) R* t __doc__R R R( ( ( ( s7 /usr/lib/python2.6/site-packages/paste/errordocument.pyR V s 4 c K sv h } xZ | i ƒ D]L \ } } y t | ƒ } Wn# t j
o t d | ƒ ‚ n X| | | Error %(code)s
Error %(code)s
%(message)s
Additionally an error occurred trying to produce an
error document. A description of the error was logged
to wsgi.errors.