File: //opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyo
�
a�Nc @ s� d Z d d l Z d d l Z d d l m Z d d l m Z m Z m Z d d l m Z d d l
m 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 RecursiveMiddlewaret
RecursionLoop( t
converters( t replace_headerc C s[ x6 | D]. } t | t � s 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 | j | � r | | Sd Sd S( N( t has_keyt None( t codet messaget environt global_conft codes( ( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyt error_codes_mapper0 s R ( t
isinstancet intt TypeErrort reprR t StatusBasedForward( t appR R R
( ( sD /opt/alt/python27/lib/python2.7/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 ( ( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyt __init__@ s c s� d � � f d � } � j j d � } | d | d <t | � d k rX | d | d <n
d | d <y � j | | � SWnL t k
r� } | d j d | � | d
d g t j � � d
� j g SXd S( Nc sk xR | D]J \ } } | j � d k r> � j j | | f � q t � j | | � q W� � j � j | � S( Ns
set-cookie( t lowerR t appendR R ( R R t exc_infot headert value( R t start_response( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyt keep_status_start_responseG s
t ?i t PATH_INFOi t QUERY_STRINGt s wsgi.errorss' Recursion error getting error page: %s
s 500 Server Errors Content-types
text/plains- Error: %s. (Error page could not be fetched)( s Content-types
text/plain(
R R t splitt lenR R t writet sysR R ( R R
R R! t partst e( ( R R sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyt __call__F s
( t __name__t
__module__R R, ( ( ( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyR ? 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 sm | d k r i } n | r< t j | j d t � � | _ n t | _ | | _ | | _ | | _ | | _ d S( Nt debug(
R R t asboolt gett FalseR/ t applicationt mapperR t params( R R R4 R R5 ( ( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyR � s ! c s� g � g } d � � � � f d � } � j � | � } � r| t | d � r[ | j � n � f d � } t d | � � n | Sd S( Nc s� | j d � } y t | d � } Wn1 t t f k
rV t d t | d � � � n Xd j | d � } � j | | � � j � j � } | d k p� t | t � s� t d | � � n | r� � j
| | | g � g j
S� | | | � 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 %r( R& R t
ValueErrorR t ExceptionR t joinR4 R R5 R R t strR ( R R R t status_codeR R t new_url( R
R R R ( sD /opt/alt/python27/lib/python2.7/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 ( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyt factory� s %R? ( R R3 t hasattrR> R ( R R
R t writerR= t app_iterR? ( ( R
R R R sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyR, � s
N( R- R. t __doc__R R R, ( ( ( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyR ^ s 4 c K st i } xX | j � D]J \ } } y t | � } Wn! t k
rR t d | � � n X| | | <q Wt | | � } | S( s�
Paste Deploy entry point to create a error document wrapper.
Use like::
[filter-app:main]
use = egg:Paste#errordocument
next = real-app
500 = /lib/msg/500.html
404 = /lib/msg/404.html
s Bad status code: %r( t itemsR R7 R ( R R t kwt mapR t redir_loct forwarder( ( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyt make_errordocument� s
R RI t empty_errort make_empty_errorc K s; t j d t d � | d k r( i } n t | | | | � S( s6
Deprectated; use StatusBasedForward instead.
s_ errordocuments.custom_forward has been deprecated; please use errordocuments.StatusBasedForwardi N( t warningst warnt DeprecationWarningR t _StatusBasedRedirect( R R4 R RE ( ( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyt custom_forward� s
RO c B s# e Z d Z d d � Z d � Z RS( s6
Deprectated; use StatusBasedForward instead.
c K sY t j d t d � | d k r( i } n | | _ | | _ | | _ | | _ d | _ d S( Nse errordocuments._StatusBasedRedirect has been deprecated; please use errordocuments.StatusBasedForwardi s�
<html>
<head>
<title>Error %(code)s</title>
</html>
<body>
<h1>Error %(code)s</h1>
<p>%(message)s</p>
<hr>
<p>
Additionally an error occurred trying to produce an
error document. A description of the error was logged
to <tt>wsgi.errors</tt>.
</p>
</body>
</html>
( RL RM RN R R3 R4 R RE t fallback_template( R R R4 R RE ( ( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyR s
c s g � g � y4 d � � � � � f d � } � j � | � } Wn� y& d d l } t | j � d � } Wn
d } n Xy � d \ } } Wn d d } } n X� d j d t | � � � j i | d 6| d 6g SX� r� d � i } xG � j � D]9 \ }
} |
d
k r1t � � d | d
<q| | |
<qWd t f d
� � Y� d � � f d � } � d }
|
j
} | |
_
y |
� | � } Wn[ � k
r�} � d \ } } � d j d t � d � � � j i | d 6| d 6g SX| |
_
| Sn | Sd S( Nc s� d } | j d � } y t | d � } Wn1 t t f k
r\ t d t | d � � � n Xd j | d � } � j | | � � j � j
� } | d k p� t | t � s� t d t | � � � n | r� � j
| � n � j
| | g � � | | | � S( NR6 i sB _StatusBasedRedirect middleware received an invalid status code %si sq Expected the url to internally redirect to in the _StatusBasedRedirect error_mapperto be a string or None, not %s( R R& R R7 R R8 R R9 R4 R RE R R: R ( R R R R< R* R R ( t code_messageR
R R R ( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyR= & s. i����i R% i s wsgi.errorssB Error occurred in _StatusBasedRedirect intercepting the response: R R R$ i t InvalidForwardc B s e Z RS( ( R- R. ( ( ( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyRS \ s c s' | d d k r# � d � � � n d S( s�
We don't want start_response to do anything since it
has already been called
i t 200sl The URL %s to internally forward to in order to create an error document did not return a '200' status code.N( ( R R R ( RS t url_( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyt eat_start_response^ s s paste.recursive.forwards? Error occurred in _StatusBasedRedirect redirecting to new URL: ( R R3 R) R: R R( RQ RD R R8 R ( R R
R R= RB R) t errorR R t new_environt kt vRV R t old_start_responseR+ ( ( RS RR R
R R R RU sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyR, " sZ
N( R- R. RC R R R, ( ( ( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyRO � s ( RC RL R) R t paste.recursiveR R R t
paste.utilR t paste.responseR R t objectR R RI t
__pudge_all__R RP RO ( ( ( sD /opt/alt/python27/lib/python2.7/site-packages/paste/errordocument.pyt <module>
s" , r