Ñò
,¦{Ic @ sá d Z d d k Z d d k Z d d k Z d d k l Z d „ Z d „ Z d „ Z d „ Z d „ Z
d e f d
„ ƒ YZ d „ Z
d „ Z d d
„ Z d e f d „ ƒ YZ d e f d „ ƒ YZ d e f d „ ƒ YZ d S( sÛ Utility functions for use in templates / controllers
*PLEASE NOTE*: Many of these functions expect an initialized RequestConfig
object. This is expected to have been initialized for EACH REQUEST by the web
framework.
iÿÿÿÿN( t request_configc
C s® | i } xA | i ƒ D]3 \ } } t | t ƒ o | i | ƒ | | s2
#
c C sy | oV t | t ƒ o | i | ƒ } qi t | t ƒ o
| } qi t | ƒ i | ƒ } n
t | ƒ } t i | d ƒ S( s+ A Unicode handling version of urllib.quote.R ( R R R R& t urllibt quote( t stringR t s( ( s/ /usr/lib/python2.6/site-packages/routes/util.pyt
_url_quotee s
c C sm | oV t | t ƒ o | i | ƒ } qi t | t ƒ o
| } qi t | ƒ i | ƒ } n
t | ƒ } | S( N( R R R R& ( R8 R R9 ( ( s/ /usr/lib/python2.6/site-packages/routes/util.pyt _str_encodet s
c
O s | i d ƒ } | i d ƒ } | i d ƒ } | i d d ƒ } xa d d d g D]P } | i | ƒ o | | =n | i | d ƒ o | i | d ƒ | | '/blog/view/4',
url_for(controller='/admin') => '/admin',
url_for(controller='admin') => '/admin/view/2'
url_for(action='edit') => '/blog/edit/2',
url_for(action='list', id=None) => '/blog/list'
**Static and Named Routes**
If there is a string present as the first argument, a lookup is done
against the named routes table to see if there's any matching routes. The
keyword defaults used with static routes will be sent in as GET query
arg's if a route matches.
If no route by that name is found, the string is assumed to be a raw URL.
Should the raw URL begin with ``/`` then appropriate SCRIPT_NAME data will
be added if present, otherwise the string will be used as the url with
keyword args becoming GET query args.
t anchorR2 t protocolt qualifiedt _R" i R R t SCRIPT_NAMEt ?s %s=%st &s wsgiorg.routing_argst mapper_dictt _anchorR$ t _protocolt #R! s ://s9 url_for can only return a string, got unicode instead: %ss7 url_for could not generate URL. Called with args: %s %sN( (( R
R% R R R t FalseR R R) t _routenamest TrueR t hasattrR R R t listt tuplet appendR6 R7 R R t joint getattrR t hardcode_namest defaultsR t filtert staticR R t generateR: R2 R( R= R& t GenerationException( t argsR R< R2 R= R> R t configt routeRS R t urlt
query_argsR t valueR RC t
match_dictR t newargs( ( s/ /usr/lib/python2.6/site-packages/routes/util.pyt url_for‚ s¤ ,
+ '
t URLGeneratorc B s) e Z d Z d „ Z d „ Z d „ Z RS( s, The URL Generator generates URL's
It is automatically instantiated by the RoutesMiddleware and put
into the ``wsgiorg.routing_args`` tuple accessible as::
url = environ['wsgiorg.routing_args'][0][0]
Or via the ``routes.url`` key::
url = environ['routes.url']
The url object may be instantiated outside of a web context for use
in testing, however sub_domain support and fully qualified URL's
cannot be generated without supplying a dict that must contain the
key ``HTTP_HOST``.
c C s1 | | _ d | j o d | d R? t _use_currentR" i R R@ RA s %s=%sRB R RD R$ RE RF s routes.cached_hostinfoR! s ://s1 Can only return a string, got unicode instead: %ss/ Could not generate URL. Called with args: %s %sN(% R
R% R R RG R R R) RH RI R R R R RK RL RM R6 R7 R R RN RP RQ R R RR RS t externalR R RT R: t cache_hostinfoR( R& RU ( R` RV R R< R2 R= R> R RX t use_currentRS R RY t more_argsRZ R R[ R R] t hostinfo( ( s/ /usr/lib/python2.6/site-packages/routes/util.pyt __call__1 s¤
#
+ '
c O s | d t | | Ž S( s@ Generate a route that includes params used on the current
request
The arguments for this method are identical to ``__call__``
except that arguments set to None will remove existing route
matches of the same name from the set of arguments used to
construct a URL.
Rb ( RI ( R` RV t kwargs( ( s/ /usr/lib/python2.6/site-packages/routes/util.pyt current s ( t __name__t
__module__t __doc__Ra Rh Rj ( ( ( s/ /usr/lib/python2.6/site-packages/routes/util.pyR_ s oc O s% t | | Ž } t ƒ } | i | ƒ S( s@ Issues a redirect based on the arguments.
Redirect's *should* occur as a "302 Moved" header, however the web
framework may utilize a different method.
All arguments are passed to url_for to retrieve the appropriate URL, then
the resulting URL it sent to the redirect function as the URL.
( R^ R t redirect( RV R t targetRW ( ( s/ /usr/lib/python2.6/site-packages/routes/util.pyt redirect_to¬ s c C s. h } | i d ƒ p, | i d ƒ d j p | i d ƒ d j o d | d s 0 ' Žœ !