Ńň
eIc @ s
d Z d d k Z d d k Z d e f d YZ e d Z d d k l Z d d k l
Z
l Z l Z d d d
d d g Z
d S(
sE Provides common classes and functions most users will want access to.i˙˙˙˙Nt _RequestConfigc B s> e Z d Z e i Z d Z d Z d Z d Z RS( sÁ
RequestConfig thread-local singleton
The Routes RequestConfig object is a thread-local singleton that should be initialized by
the web framework that is utilizing Routes.
c C s t | i | S( N( t getattrt _RequestConfig__shared_state( t selft name( ( s3 /usr/lib/python2.6/site-packages/routes/__init__.pyt __getattr__
s c C sA | d j o! | i | | i i | | S| i i | | S( sq
If the name is environ, load the wsgi envion with load_wsgi_environ
and set the environ
t environ( t load_wsgi_environR t __setattr__( R R t value( ( s3 /usr/lib/python2.6/site-packages/routes/__init__.pyR s
c C s t | i | d S( N( t delattrR ( R R ( ( s3 /usr/lib/python2.6/site-packages/routes/__init__.pyt __delattr__ s c C sÚ d | j p, | i d d j p | i d d j o d | i _ n
d | i _ y | | i _ Wn t j
o n Xy d | j oo | i } | d } | i | } | d j o$ | d | i _ | d | i _ qú d | i _ d | i _ n Wn t j
o n Xd | j o | d | i _
nĽ d
| j o | d
| i _
n | d | i _
| d d j o3 | d d
j o | i i
d | d 7_
qÖn0 | d d j o | i i
d | d 7_
n d S( sË
Load the protocol/server info from the environ and store it.
Also, match the incoming URL if there's already a mapper, and
store the resulting match dict in mapper_dict.
t HTTPSs wsgi.url_schemet httpst HTTP_X_FORWARDED_PROTOt httpt PATH_INFOi i t HTTP_X_FORWARDED_HOSTt HTTP_HOSTt SERVER_NAMEt SERVER_PORTt 443t :t 80N( t getR t protocolt mapperR t AttributeErrort
routematcht Nonet mapper_dictt routet host( R R R t patht result( ( s3 /usr/lib/python2.6/site-packages/routes/__init__.pyR s< #
"(
t __name__t
__module__t __doc__t threadinglocalt localR R R R R ( ( ( s3 /usr/lib/python2.6/site-packages/routes/__init__.pyR s
c C sd t } y, | i o | t j o t | d SWn% t j
o t | _ t | _ n Xt S( sy
Returns the Routes RequestConfig object.
To get the Routes RequestConfig:
>>> from routes import *
>>> config = request_config()
The following attributes must be set on the config object every request:
mapper
mapper should be a Mapper instance thats ready for use
host
host is the hostname of the webapp
protocol
protocol is the protocol of the current request
mapper_dict
mapper_dict should be the dict returned by mapper.match()
redirect
redirect should be a function that issues a redirect,
and takes a url as the sole argument
prefix (optional)
Set if the application is moved under a URL prefix. Prefix
will be stripped before matching, and prepended on generation
environ (optional)
Set to the WSGI environ for automatic prefix support if the
webapp is underneath a 'SCRIPT_NAME'
Setting the environ will use information in environ to try and
populate the host/protocol/mapper_dict options if you've already
set a mapper.
**Using your own requst local**
If you have your own request local object that you'd like to use instead of the default
thread local provided by Routes, you can configure Routes to use it::
from routes import request_config()
config = request_config()
if hasattr(config, 'using_request_local'):
config.request_local = YourLocalCallable
config = request_config()
Once you have configured request_config, its advisable you retrieve it again to get the
object you wanted. The variable you assign to request_local is assumed to be a callable
that will get the local config object you wish.
This example tests for the presence of the 'using_request_local' attribute which will be
present if you haven't assigned it yet. This way you can avoid repeat assignments of the
request specific callable.
Should you want the original object, perhaps to change the callable its using or stop
this behavior, call request_config(original=True).
t
request_local( R R( t FalseR R t using_request_local( t originalt obj( ( s3 /usr/lib/python2.6/site-packages/routes/__init__.pyt request_configJ s 7 ( t Mapper( t redirect_tot url_fort URLGeneratorR. R0 R1 R/ R- ( R% R& t syst objectR R) R- t
routes.mapperR. t routes.utilR/ R0 R1 t __all__( ( ( s3 /usr/lib/python2.6/site-packages/routes/__init__.pyt s F @