o k`@@snddlZddlmZddlmZmZedZGddde Z e dkr5ddl Z ddl Z e e je dSdS)N)Context) unicode_quoteunicode_urlencodez/{2,}c@s\eZdZdZdZdZdZdddZddZd d Z d d Z d e e eddZddZdS)HrefaImplements a callable that constructs URLs with the given base. The function can be called with any number of positional and keyword arguments which then are used to assemble the URL. Positional arguments are appended as individual segments to the path of the URL: >>> href = Href('/trac') >>> repr(href) "" >>> href('ticket', 540) '/trac/ticket/540' >>> href('ticket', 540, 'attachment', 'bugfix.patch') '/trac/ticket/540/attachment/bugfix.patch' >>> href('ticket', '540/attachment/bugfix.patch') '/trac/ticket/540/attachment/bugfix.patch' If a positional parameter evaluates to None, it will be skipped: >>> href('ticket', 540, 'attachment', None) '/trac/ticket/540/attachment' The first path segment can also be specified by calling an attribute of the instance, as follows: >>> href.ticket(540) '/trac/ticket/540' >>> href.changeset(42, format='diff') '/trac/changeset/42?format=diff' Simply calling the Href object with no arguments will return the base URL: >>> href() '/trac' Keyword arguments are added to the query string, unless the value is None: >>> href = Href('/trac') >>> href('timeline', format='rss') '/trac/timeline?format=rss' >>> href('timeline', format=None) '/trac/timeline' >>> href('search', q='foo bar') '/trac/search?q=foo+bar' Multiple values for one parameter are specified using a sequence (a list or tuple) for the parameter: >>> href('timeline', show=['ticket', 'wiki', 'changeset']) '/trac/timeline?show=ticket&show=wiki&show=changeset' Alternatively, query string parameters can be added by passing a dict or list as last positional argument: >>> href('timeline', {'from': '02/24/05', 'daysback': 30}) '/trac/timeline?daysback=30&from=02%2F24%2F05' >>> href('timeline', {}) '/trac/timeline' >>> href('timeline', [('from', '02/24/05')]) '/trac/timeline?from=02%2F24%2F05' >>> href('timeline', ()) == href('timeline', []) == href('timeline', {}) True The usual way of quoting arguments that would otherwise be interpreted as Python keywords is supported too: >>> href('timeline', from_='02/24/05', daysback=30) '/trac/timeline?daysback=30&from=02%2F24%2F05' If the order of query string parameters should be preserved, you may also pass a sequence of (name, value) tuples as last positional argument: >>> href('query', (('group', 'component'), ('groupdesc', 1))) '/trac/query?group=component&groupdesc=1' >>> params = [] >>> params.append(('group', 'component')) >>> params.append(('groupdesc', 1)) >>> href('query', params) '/trac/query?group=component&groupdesc=1' By specifying an absolute base, the function returned will also generate absolute URLs: >>> href = Href('https://trac.edgewall.org') >>> href('ticket', 540) 'https://trac.edgewall.org/ticket/540' >>> href = Href('https://trac.edgewall.org') >>> href('ticket', 540) 'https://trac.edgewall.org/ticket/540' In common usage, it may improve readability to use the function-calling ability for the first component of the URL as mentioned earlier: >>> href = Href('/trac') >>> href.ticket(540) '/trac/ticket/540' >>> href.browser('/trunk/README.txt', format='txt') '/trac/browser/trunk/README.txt?format=txt' The ``path_safe`` argument specifies the characters that don't need to be quoted in the path arguments. Likewise, the ``query_safe`` argument specifies the characters that don't need to be quoted in the query string: >>> href = Href('') >>> href.milestone('', param='') '/milestone/%3Clook%2Chere%3E?param=%3Chere%2Ctoo%3E' >>> href = Href('', path_safe='/<,', query_safe=',>') >>> href.milestone('', param='') '/milestone/' r/!~*'()!~*'()cCs"|d|_||_||_i|_dSN/)rstripbase path_safe query_safe_derived)selfr r r r//usr/lib/python3/dist-packages/trac/web/href.py__init__s  z Href.__init__cCsd|jj|jfS)Nz<%s %r>) __class____name__r rrrr__repr__sz Href.__repr__c sLj}gfdd}|rt|dtr|dd}|rY|d}t|tr@t|dddD] \}}|||q/|dd}nt|ttfrY|D] \}}|||qI|dd}d fd d |D}|ru|d t d | d 7}n|syd }t|d ddD]\}}|| d r|ddn||qr|dt j7}|S)NcsRt|ttfrdd|DD] }||fqdS|dur'||fdSdS)NcSsg|]}|dur|qSNr).0irrr sz4Href.__call__..add_param..) isinstancelisttupleappend)namevaluer)paramsrr add_paramsz Href.__call__..add_paramrcS|dSNrrrrrrzHref.__call__..)keyr c3s.|]}|durtt|djVqdSr)rstrstripr )rargrrr s  z Href.__call__..cSr%r&rr'rrrr(r)_?)r r Jinja2Contextdictsorteditemsrrjoin slashes_resublstripendswithrr ) rargskwhrefr"lastpkvpathr)r!rr__call__s6       "z Href.__call__cs(jvrfddj<jS)Ncsg|Ri|Srr)r:r;rrrrr(sz"Href.__getattr__..)r)rrrrBr __getattr__s  zHref.__getattr__!cCsR|s|jpdS|dr|jpdt||jS|ds d|}|jt||jS)Nr r0)r startswithr_printable_safe)rrhsrrr__add__s    z Href.__add__N)rr)r __module__ __qualname____doc__contextfunctionevalcontextfunctionenvironmentfunctionrrrArCr5mapchrrangerHrJrrrrrst * r__main__)rejinja2.runtimerr1trac.util.textrrcompiler6objectrrdoctestsystestmodmodulesrrrrs  ?