Ńņ
÷Ń{Ic @ s³ d d k Z d d k Z d d k Z d d k Z e i d j o d d k l Z n d d k l Z d d k
l Z l Z l
Z
d d k l Z d Z d e f d YZ d S(
i’’’’Ns 2.4( t ImmutableSet( t request_config( t controller_scant MatchExceptiont RoutesException( t Routec C s@ | i d o | d } n | i d o | d } n | S( s8 Remove slashes from the beginning and end of a part/URL.t /i i’’’’( t
startswitht endswith( t name( ( s1 /usr/lib/python2.6/site-packages/routes/mapper.pyt
strip_slashes s
t Mapperc B s° e Z d Z e e e e e d Z d Z d Z d Z
e e e e
Z d Z
d Z d Z e d Z d Z d
Z d Z d Z d
Z d Z RS( s| Mapper handles URL generation and URL recognition in a web
application.
Mapper is built handling dictionary's. It is assumed that the web
application will handle the dictionary returned by URL recognition
to dispatch appropriately.
URL generation is done by passing keyword parameters into the
generate function, a URL is then returned.
c C s g | _ h | _ h | _ h | _ t | _ t | _ d | _ t i
| _ | | _ | | _
| | _ d | _ h | _ t | _ t | _ t | _ g | _ d | _ | | _ d | _ d | _ t | _ t | _ t i | _ | o t } | | _ n d S( sv
Create a new Mapper instance
All keyword arguments are optional.
``controller_scan``
Function reference that will be used to return a list of
valid controllers used during URL matching. If
``directory`` keyword arg is present, it will be passed
into the function during its call. This option defaults to
a function that will scan a directory for controllers.
``directory``
Passed into controller_scan for the directory to scan. It
should be an absolute path if using the default
``controller_scan`` function.
``always_scan``
Whether or not the ``controller_scan`` function should be
run during every URL match. This is typically a good idea
during development so the server won't need to be restarted
anytime a controller is added.
``register``
Boolean used to determine if the Mapper should use
``request_config`` to register itself as the mapper. Since
it's done on a thread-local basis, this is typically best
used during testing though it won't hurt in other cases.
``explicit``
Boolean used to determine if routes should be connected
with implicit defaults of::
{'controller':'content','action':'index','id':None}
When set to True, these defaults will not be added to route
connections and ``url_for`` will not use Route memory.
Additional attributes that may be set after mapper
initialization (ie, map.ATTRIBUTE = 'something'):
``encoding``
Used to indicate alternative encoding/decoding systems to
use with both incoming URL's, and during Route generation
when passed a Unicode string. Defaults to 'utf-8'.
``decode_errors``
How to handle errors in the encoding, generally ignoring
any chars that don't convert should be sufficient. Defaults
to 'ignore'.
``minimization``
Boolean used to indicate whether or not Routes should
minimize URL's and the generated URL's, or require every
part where it appears in the path. Defaults to True.
``hardcode_names``
Whether or not Named Routes result in the default options
for the route being used *or* if they actually force url
generation to use the route. Defaults to False.
s [^\.\/]+?\.[^\.\/]+s utf-8t ignoreN(! t matchlistt maxkeyst minkeyst urlcachet Falset
_created_regst
_created_genst Nonet prefixt threadinglocalt localt req_datat directoryt always_scanR t
_regprefixt _routenamest debugt append_slasht sub_domainst sub_domains_ignoret domain_matcht explicitt encodingt
decode_errorst Truet hardcode_namest minimizationt threadingt Lockt create_regs_lockR t mapper( t selfR R R t registerR" t config( ( s1 /usr/lib/python2.6/site-packages/routes/mapper.pyt __init__# s6 ? c C s) y | i i SWn t j
o d SXd S( N( R t environt AttributeErrorR ( R, ( ( s1 /usr/lib/python2.6/site-packages/routes/mapper.pyt _envget~ s c C s | | i _ d S( N( R R0 ( R, t env( ( s1 /usr/lib/python2.6/site-packages/routes/mapper.pyt _envset s c C s
| i ` d S( N( R R0 ( R, ( ( s1 /usr/lib/python2.6/site-packages/routes/mapper.pyt _envdel
s c O s d } t | d j o | d } | d } n d | j o | i | d
/ c O s6 | i i z | i | | Wd | i i Xd S( sP Atomically creates regular expressions for all connected
routes
N( R* t acquiret _create_regst release( R, R< t kwargs( ( s1 /usr/lib/python2.6/site-packages/routes/mapper.pyt create_regsē s
c C sÆ | d j o0 | i o | i | i } q= | i } n x; | i i D]* \ } } x | D] } | i | q` WqM W| i o t i | i d | _ n t
| _ d S( s4 Creates regular expressions for all connected routess (.*)N( R R R R t iteritemst
makeregexpR t ret compileR R% R ( R, RP RA t valR? ( ( s1 /usr/lib/python2.6/site-packages/routes/mapper.pyRU ń s
c
C s | i o | i o | i n | i p t d n | i o | i n g } | i oT t i | i | o- t i | i d | } | p
d } qµ q¹ d d | f Sn | i } | i } | i
} | i } | i } x¦ | i D] } | i o. | o | i t d | d t qš qš n | i | | | | | } | o& | i t d | d t | n | o | | | f Sqš Wd d | f S( s Internal Route matcher
Matches a URL against a route, and returns a tuple of the match
dict and the route object if a match is successfull, otherwise
it returns empty.
For internal use only.
s: You must generate the regular expressions before matching.s \1R R? R: t regexpN( R R RX R R R R[ t matchR t subR R0 R R R! R R
R: R; t dictR% t bool(
R, t urlt matchlogR0 R R R! R R? R_ ( ( s1 /usr/lib/python2.6/site-packages/routes/mapper.pyt _match s>
&c C sb | p t d n | i | } | i o | d | d | d f S| d o | d Sd S( sī Match a URL against against one of the routes contained.
Will return None if no valid match is found.
.. code-block:: python
resultdict = m.match('/joe/sixpack')
s; No URL provided, the minimum URL necessary to match is "/".i i i N( R Re R R ( R, Rc t result( ( s1 /usr/lib/python2.6/site-packages/routes/mapper.pyR_ 0 s
c C sU | i | } | i o | d | d | d f S| d o | d | d f Sd S( s5 Match a URL against against one of the routes contained.
Will return None if no valid match is found, otherwise a
result dict and a route object is returned.
.. code-block:: python
resultdict, route_obj = m.match('/joe/sixpack')
i i i N( Re R R ( R, Rc Rf ( ( s1 /usr/lib/python2.6/site-packages/routes/mapper.pyt
routematchE s
c sŚ | i p | i n | i o t | d /:_id".
If ``parent_resource`` is supplied and ``name_prefix``
isn't, ``name_prefix`` will be generated from
``parent_resource`` as "_".
Example::
>>> from routes.util import url_for
>>> m = Mapper()
>>> m.resource('location', 'locations',
... parent_resource=dict(member_name='region',
... collection_name='regions'))
>>> # path_prefix is "regions/:region_id"
>>> # name prefix is "region_"
>>> url_for('region_locations', region_id=13)
'/regions/13/locations'
>>> url_for('region_new_location', region_id=13)
'/regions/13/locations/new'
>>> url_for('region_location', region_id=13, id=60)
'/regions/13/locations/60'
>>> url_for('region_edit_location', region_id=13, id=60)
'/regions/13/locations/60/edit'
Overriding generated ``path_prefix``::
>>> m = Mapper()
>>> m.resource('location', 'locations',
... parent_resource=dict(member_name='region',
... collection_name='regions'),
... path_prefix='areas/:area_id')
>>> # name prefix is "region_"
>>> url_for('region_locations', area_id=51)
'/areas/51/locations'
Overriding generated ``name_prefix``::
>>> m = Mapper()
>>> m.resource('location', 'locations',
... parent_resource=dict(member_name='region',
... collection_name='regions'),
... name_prefix='')
>>> # path_prefix is "regions/:region_id"
>>> url_for('locations', region_id=51)
'/regions/51/locations'
t
collectiont membert newt path_prefixt name_prefixt parent_resources %s/:%s_idt collection_namet member_names %s_Rm t GETt editc S s@ x9 | i D]+ \ } } | i | i g i | q
W| S( si Swap the keys and values in the dict, and uppercase the values
from the dict during the swap.( RY RK t upperR; ( t dctt newdctRA R] ( ( s1 /usr/lib/python2.6/site-packages/routes/mapper.pyt swap s
#t POSTi t createt PUTt updatet DELETEt deleteR s /news /:(id)RC t _member_namet _collection_namet _parent_resourcec s; i } d j o h | i g d 6| d s