Class StripDirective
object --+
|
Directive --+
|
StripDirective
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('''<div xmlns:py="http://genshi.edgewall.org/">
... <div py:strip="True"><b>foo</b></div>
... </div>''')
>>> print tmpl.generate()
<div>
<b>foo</b>
</div>
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('''<div xmlns:py="http://genshi.edgewall.org/">
... <div py:def="echo(what)" py:strip="">
... <b>${what}</b>
... </div>
... ${echo('foo')}
... </div>''')
>>> print tmpl.generate()
<div>
<b>foo</b>
</div>
|
|
__call__(self,
stream,
directives,
ctxt,
**vars)
Apply the directive to the given stream. |
|
|
|
Inherited from Directive:
__init__,
__repr__
Inherited from object:
__delattr__,
__getattribute__,
__hash__,
__new__,
__reduce__,
__reduce_ex__,
__setattr__,
__str__
|
|
|
attach(cls,
template,
stream,
value,
namespaces,
pos)
Called after the template stream has been completely parsed. |
|
|
|
Inherited from Directive:
expr
Inherited from object:
__class__
|
__call__(self,
stream,
directives,
ctxt,
**vars)
(Call operator)
|
|
Apply the directive to the given stream.
- Parameters:
stream - the event streamdirectives - a list of the remaining directives that should
process the streamctxt - the context datavars - additional variables that should be made available when
Python code is executed - Overrides:
Directive.__call__
- (inherited documentation)
|
attach(cls,
template,
stream,
value,
namespaces,
pos)
Class Method
|
|
Called after the template stream has been completely parsed.
This class method should return a (directive, stream) tuple. If
directive is not None, it should be an instance of the Directive
class, and gets added to the list of directives applied to the substream
at runtime. stream is an event stream that replaces the original
stream associated with the directive.
- Parameters:
template - the Template objectstream - the event stream associated with the directivevalue - the argument value for the directive; if the directive was
specified as an element, this will be an Attrs instance
with all specified attributes, otherwise it will be a
unicode object with just the attribute valuenamespaces - a mapping of namespace URIs to prefixespos - a (filename, lineno, offset) tuple describing the
location where the directive was found in the source - Overrides:
Directive.attach
- (inherited documentation)
|