Ñò
ûãtHc @ s! d Z d d k Z y e Wn# e j
o d d k l Z n Xd d k l Z l Z d d k l
Z
d d k l Z l
Z
l Z l Z l Z l Z d d k l Z l Z l Z d d d
d d d
d d d d d d g Z d Z d e f d „ ƒ YZ d e f d „ ƒ YZ d „ Z d e f d „ ƒ YZ d
e f d „ ƒ YZ d e f d „ ƒ YZ d e f d „ ƒ YZ d
e f d „ ƒ YZ! d e f d „ ƒ YZ" d e f d „ ƒ YZ# d e f d! „ ƒ YZ$ d e f d" „ ƒ YZ% d e f d# „ ƒ YZ& d e f d$ „ ƒ YZ' d e f d% „ ƒ YZ( d S(& s2 Implementation of the various template directives.iÿÿÿÿN( t ImmutableSet( t QNamet Stream( t Path( t TemplateRuntimeErrort TemplateSyntaxErrort EXPRt _apply_directivest
_eval_exprt _exec_suite( t
Expressiont ExpressionASTTransformert _parset AttrsDirectivet ChooseDirectivet ContentDirectivet DefDirectivet ForDirectivet IfDirectivet MatchDirectivet OtherwiseDirectivet ReplaceDirectivet StripDirectivet
WhenDirectivet
WithDirectives restructuredtext ent
DirectiveMetac B s e Z d Z d „ Z RS( s# Meta class for template directives.c C s2 | i ƒ i d d ƒ | d ( t getattrt NoneR) t sourcet __class__R% ( R+ R) ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyt __repr__g s c C sŒ y. | o t | | i | d | i ƒp d SWnW t j
oK } | i d | | i f 7_ t | | i | | | i p d ƒ ‚ n Xd S( sp Parses the given expression, raising a useful error message when a
syntax error is encountered.
t lookups% in expression "%s" of "%s" directivei N( R
t filepathR? R; t SyntaxErrort msgR R R0 ( R! R) R- R/ R0 t err( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR* m s
N(
R% R& R' R t
__metaclass__t __slots__R; R1 R4 t classmethodR9 R> R* ( ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR( , s c s+ ‡ f d † ‰ ˆ | ƒ ‡ f d † ‰ ˆ S( sŒ Takes the AST representation of an assignment, and returns a function
that applies the assignment of a given value to a dictionary.
c s t | t i i t i i f ƒ o/ t g } | i D] } | ˆ | ƒ q3 ~ ƒ St | t i i t i i f ƒ o | i Sd S( N(
t
isinstancet compilert astt AssTuplet Tuplet tuplet nodest AssNamet NameR" ( t nodet _[1]t child( t _names( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyRS € s "/"c sZ t | ƒ t j o9 x@ t t | ƒ ƒ D] } ˆ | | | | | ƒ q& Wn | | | >> from genshi.template import MarkupTemplate
>>> tmpl = MarkupTemplate('''
If the value evaluates to ``None`` (or any other non-truth value), no
attributes are added:
>>> print tmpl.generate(foo=None)
Bar
c s. ‡ ‡ ‡ ‡ f d † } t | ƒ | ˆ ˆ S( Nc
3 s_ ˆ i ƒ \ } \ } } } t ˆ i ˆ ˆ } | oú t | t ƒ o6 y t | ƒ i ƒ } Wq t j
o
g } q Xn! t | t ƒ p | i ƒ } n | g } | D]$ \ } } | d j o | | q« q« ~ 8} | g } | D]< \ } } | d j o# | t
| ƒ t | ƒ i ƒ f qç qç ~ O} n | | | f | f Vx ˆ D] } | VqLWd S( N(
t nextR R) RG R t itert
StopIterationt listt itemsR; R t unicodet strip(
t kindt tagt attribR3 t attrsRQ R" t valt _[2]t event( R8 R2 R+ R7 ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyt _generate s" <
N ( R ( R+ R2 R6 R7 R8 Ri ( ( R2 R8 R+ R7 s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR9 ¬ s ( R% R& R' RE R9 ( ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR
Ž s c B s) e Z d Z g Z d „ Z e e ƒ Z RS( sÔ Implementation of the ``py:content`` template directive.
This directive replaces the content of the element with the result of
evaluating the value of the ``py:content`` attribute:
>>> from genshi.template import MarkupTemplate
>>> tmpl = MarkupTemplate('''
...
Hello
...
''')
>>> print tmpl.generate(bar='Bye')
Bye
c C sm t | ƒ t j o t d | i | d Œ ‚ n | i | | | d Œ } d | d t | | f | d g f S( Ns3 The content directive can not be used as an elementi i iÿÿÿÿ( R t dictR R@ R* R; R ( R! R- R2 R, R. R3 R) ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR4 Ó s ( R% R& R' RE R4 RF ( ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR  s c B s\ e Z d Z d d d d d g Z d d d d „ Z d „ Z e e ƒ Z d „ Z d
„ Z RS( s Implementation of the ``py:def`` template directive.
This directive can be used to create "Named Template Functions", which
are template snippets that are not actually output during normal
processing, but rather can be expanded from expressions in other places
in the template.
A named template function can be used just like a normal Python function
from template expressions:
>>> from genshi.template import MarkupTemplate
>>> tmpl = MarkupTemplate('''
...
... ${greeting}, ${name}!
...
... ${echo('Hi', name='you')}
...
''')
>>> print tmpl.generate(bar='Bye')
Hi, you!
If a function does not require parameters, the parenthesis can be omitted
in the definition:
>>> tmpl = MarkupTemplate('''
...
... Hello, world!
...
... ${helloworld()}
...
''')
>>> print tmpl.generate(bar='Bye')
Hello, world!
R" t argst star_argst
dstar_argst defaultsiÿÿÿÿc C sA t i | d | | | | ƒ t | ƒ i } g | _ d | _ d | _ h | _ t | t
i i ƒ oÌ | i i
| _
x| | i D]q } t | t
i i ƒ oB | i i | i
ƒ t | i | i | d | i ƒ| i | i
( R= R% R" ( R+ ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR> L s N(
R% R& R' RE R; R1 R4 RF R9 R> ( ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR Ý s ( $c B sS e Z d Z d d g Z d d d d „ Z d „ Z e e ƒ Z d „ Z d „ Z RS( s Implementation of the ``py:for`` template directive for repeating an
element based on an iterable in the context data.
>>> from genshi.template import MarkupTemplate
>>> tmpl = MarkupTemplate('''
...
${item}
...
''')
>>> print tmpl.generate(items=[1, 2, 3])
1
2
3
t assignt filenameiÿÿÿÿc C s¨ d | j o t d | i | | ƒ ‚ n | i d d ƒ \ } } t | d ƒ } d | i ƒ } t | i i d i ƒ | _ | i | _
t i | | | | | | ƒ d S( Ns in s' "in" keyword missing in "for" directivei t execs iter(%s)i (
R R@ t splitR Ra RZ RP RM R) R| R} R( R1 ( R+ R, R- R. R/ R0 R| RI ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR1 _ s
c C sH t | ƒ t j o | i d ƒ } n t t | ƒ i | | | | | ƒ S( Nt each( R Rj Rt Ru R R4 ( R! R- R2 R, R. R3 ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR4 j s c
k s t | i | | } | d j o d S| i } h } t | ƒ } xW | D]O } | | | ƒ | i | ƒ x" t | | | | D] } | Vq W| i ƒ qI Wd S( N( R R) R; R| R^ Rw R Rv (
R+ R2 R6 R7 R8 t iterableR| Ry t itemRh ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR9 q s
c C s d | i i S( Ns <%s>( R= R% ( R+ ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR> € s N(
R% R& R' RE R; R1 R4 RF R9 R> ( ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR P s c B s2 e Z d Z g Z d „ Z e e ƒ Z d „ Z RS( s‹ Implementation of the ``py:if`` template directive for conditionally
excluding elements from being output.
>>> from genshi.template import MarkupTemplate
>>> tmpl = MarkupTemplate('''
c C sH t | ƒ t j o | i d ƒ } n t t | ƒ i | | | | | ƒ S( Nt test( R Rj Rt Ru R R4 ( R! R- R2 R, R. R3 ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR4 “ s c K s4 t | i | | } | o t | | | | Sg S( N( R R) R ( R+ R2 R6 R7 R8 R, ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR9 š s ( R% R& R' RE R4 RF R9 ( ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR „ s
c B sY e Z d Z d d d g Z d d d d d „ Z d „ Z e e ƒ Z d „ Z d „ Z RS(
s° Implementation of the ``py:match`` template directive.
>>> from genshi.template import MarkupTemplate
>>> tmpl = MarkupTemplate('''
...
... Hello ${select('@name')}
...
...
...
''')
>>> print tmpl.generate()
Hello Dude
t pathR. t hintsiÿÿÿÿc C sX t i | d | | | | ƒ t | | i | ƒ | _ | p h | _ | p d | _ d S( N( ( R( R1 R; R R@ R„ R. R… ( R+ R, R- R… R. R/ R0 ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR1 ´ s c C sâ g } t | ƒ t j o£ | i d d ƒ i ƒ d j o | i d ƒ n | i d d ƒ i ƒ d j o | i d ƒ n | i d d ƒ i ƒ d j o | i d ƒ n | i d
ƒ } n | | | t | ƒ | | d Œ | f S( Nt bufferR t falset not_bufferedt oncet truet
match_oncet recursivet
not_recursiveR„ i ( R Rj Rt R Rq t frozenset( R! R- R2 R, R. R3 R… ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR4 » s c K sD | i i | i i d t ƒ | i t | ƒ | i | i | f ƒ g S( Nt ignore_context( t _match_templatesRq R„ Rƒ t TrueR^ R… R. ( R+ R2 R6 R7 R8 ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR9 É s c C s d | i i | i i f S( Ns <%s "%s">( R= R% R„ R< ( R+ ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR> Ï s N(
R% R& R' RE R; R1 R4 RF R9 R> ( ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR ¡ s c B s) e Z d Z g Z d „ Z e e ƒ Z RS( s; Implementation of the ``py:replace`` template directive.
This directive replaces the element with the result of evaluating the
value of the ``py:replace`` attribute:
>>> from genshi.template import MarkupTemplate
>>> tmpl = MarkupTemplate('''
... Hello
...
''')
>>> print tmpl.generate(bar='Bye')
Bye
This directive is equivalent to ``py:content`` combined with ``py:strip``,
providing a less verbose way to achieve the same effect:
>>> tmpl = MarkupTemplate('''
... Hello
...
''')
>>> print tmpl.generate(bar='Bye')
Bye
c C sy t | ƒ t j o | i d ƒ } n | p t d | i | d Œ ‚ n | i | | | d Œ } d t | | f g f S( NR, s% missing value for "replace" directivei ( R Rj Rt R R@ R* R; R ( R! R- R2 R, R. R3 R) ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR4 ï s ( R% R& R' RE R4 RF ( ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR Ó s c B s2 e Z d Z g Z d „ Z d „ Z e e ƒ Z RS( s¾ Implementation of the ``py:strip`` template directive.
When the value of the ``py:strip`` attribute evaluates to ``True``, the
element is stripped from the output
>>> from genshi.template import MarkupTemplate
>>> tmpl = MarkupTemplate('''
...
foo
...
''')
>>> print tmpl.generate()
foo
Leaving the attribute value empty is equivalent to a truth value.
This directive is particulary interesting for named template functions or
match templates that do not generate a top-level element:
>>> tmpl = MarkupTemplate('''
...
... ${what}
...
... ${echo('foo')}
...
''')
>>> print tmpl.generate()
foo
c s. ‡ ‡ ‡ ‡ f d † } t | ƒ | ˆ ˆ S( Nc 3 sf t ˆ i ˆ ˆ o6 ˆ i ƒ ˆ i ƒ } x3 ˆ D] } | V| } q3 Wn x ˆ D] } | VqS Wd S( N( R R) R[ ( t previousRh ( R8 R2 R+ R7 ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyRi s
( R ( R+ R2 R6 R7 R8 Ri ( ( R2 R8 R+ R7 s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR9 s
c C s; | p d | d d !f St t | ƒ i | | | | | ƒ S( Ni iÿÿÿÿ( R; Ru R R4 ( R! R- R2 R, R. R3 ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR4 ( s ( R% R& R' RE R9 R4 RF ( ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR ú s
c B s8 e Z d Z d d g Z d „ Z e e ƒ Z d „ Z RS( sŒ Implementation of the ``py:choose`` directive for conditionally selecting
one of several body elements to display.
If the ``py:choose`` expression is empty the expressions of nested
``py:when`` directives are tested for truth. The first true ``py:when``
body is output. If no ``py:when`` directive is matched then the fallback
directive ``py:otherwise`` will be used.
>>> from genshi.template import MarkupTemplate
>>> tmpl = MarkupTemplate('''
... 0
... 1
... 2
...
''')
>>> print tmpl.generate()
1
If the ``py:choose`` directive contains an expression, the nested
``py:when`` directives are tested for equality to the ``py:choose``
expression:
>>> tmpl = MarkupTemplate('''
... 1
... 2
...
''')
>>> print tmpl.generate()
2
Behavior is undefined if a ``py:choose`` block contains content outside a
``py:when`` or ``py:otherwise`` block. Behavior is also undefined if a
``py:otherwise`` occurs before ``py:when`` blocks.
t matchedR, c C sH t | ƒ t j o | i d ƒ } n t t | ƒ i | | | | | ƒ S( NRƒ ( R Rj Rt Ru R R4 ( R! R- R2 R, R. R3 ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR4 Y s c k s… t t | i ƒ d g } | i o t | i | | | d "when" directives can only be used inside a "choose" directivei i i s? either "choose" or "when" directive must have a test expression( R– R R} R[ R) R R• R ( R+ R2 R6 R7 R8 R— R, R“ ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR9 } s& ! !
N( R% R& R' RE R; R1 R4 RF R9 ( ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR j s c B s2 e Z d Z d g Z d d d d „ Z d „ Z RS( s² Implementation of the ``py:otherwise`` directive for nesting in a parent
with the ``py:choose`` directive.
See the documentation of `ChooseDirective` for usage.
R} iÿÿÿÿc C s, t i | d | | | | ƒ | i | _ d S( N( R( R1 R; R@ R} ( R+ R, R- R. R/ R0 ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR1 s c K sr | i o | i d } | p' t d | i | i ƒ d d Œ ‚ n | d o g St | d >> from genshi.template import MarkupTemplate
>>> tmpl = MarkupTemplate('''
... $x $y $z
...
''')
>>> print tmpl.generate(x=42)
42 7 52
R8 iÿÿÿÿc C s] t i | d | | | | ƒ g | _ | i ƒ } yÎ t | d ƒ i } xµ | i D]ª } t | t i
i ƒ o qP n3 t | t i
i ƒ p t
d | i | | ƒ ‚ n | i i g } | i D] } | t | ƒ q¼ ~ t | i | i | d | i ƒf ƒ qP WWnW t j
oK }
|
i d | | i f 7_ t
|
| i | | |
i p d ƒ ‚ n Xd S( NR~ s8 only assignment allowed in value of the "with" directiveR? s% in expression "%s" of "%s" directivei ( R( R1 R; R8 Ra R RP RM RG RH RI t Discardt AssignR R@ Rq RZ R
R) R? RA RB R R0 ( R+ R, R- R. R/ R0 RI RP RQ t nRC ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR1 À s(
0
c C sH t | ƒ t j o | i d ƒ } n t t | ƒ i | | | | | ƒ S( NR8 ( R Rj Rt Ru R R4 ( R! R- R2 R, R. R3 ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR4 Ö s c k s h } | i | ƒ xG | i D]< \ } } t | | | } x | D] } | | | ƒ qB Wq Wx" t | | | | D] }
|
Vqs W| i ƒ d S( N( Rw R8 R R Rv ( R+ R2 R6 R7 R8 t framet targetsR) R, R| Rh ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR9 Ý s
c C s d | i i S( Ns <%s>( R= R% ( R+ ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR> è s N(
R% R& R' RE R; R1 R4 RF R9 R> ( ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyR ± s () R' RH RŽ t NameErrort setsR t genshi.coreR R t genshi.pathR t genshi.template.baseR R R R R R t genshi.template.evalR
R R t __all__t
__docformat__R R t objectR( RZ R
R R R R R R R R R R R ( ( ( s@ /usr/lib64/python2.6/site-packages/genshi/template/directives.pyt s: . P 4s4 2'6:.