Ñò
ŸªJc @ sò d Z d d k i Z y d d k l Z Wn e j
o d „ Z n Xy e Wn e j
o d „ Z n Xy e d Z
Wn e e f j
o
e Z
n Xy e d Z
Wn e e f j
o
e Z
n Xd e f d „ ƒ YZ e ƒ Z d S(
s9
The ``E`` Element factory for generating XML documents.
iÿÿÿÿN( t partialc s ‡ ‡ f d † S( Nc s ˆ ˆ | | Ž S( ( ( t argst kwargs( t tagt func( s2 /usr/lib64/python2.6/site-packages/lxml/builder.pyt / s ( ( R R ( ( R R s2 /usr/lib64/python2.6/site-packages/lxml/builder.pyR . s c C s
t | d ƒ S( Nt __call__( t hasattr( t f( ( s2 /usr/lib64/python2.6/site-packages/lxml/builder.pyt callable5 s t
basestringt unicodet ElementMakerc B s5 e Z d Z d d d d d „ Z d „ Z d „ Z RS( sO Element generator factory.
Unlike the ordinary Element factory, the E factory allows you to pass in
more than just a tag and some optional attributes; you can also pass in
text and other elements. The text is added as either text or tail
attributes, and elements are inserted at the right spot. Some small
examples::
>>> from lxml import etree as ET
>>> from lxml.builder import E
>>> ET.tostring(E("tag"))
''
>>> ET.tostring(E("tag", "text"))
'text'
>>> ET.tostring(E("tag", "text", key="value"))
'text'
>>> ET.tostring(E("tag", E("subtag", "text"), "tail"))
'texttail'
For simple tags, the factory also allows you to write ``E.tag(...)`` instead
of ``E('tag', ...)``::
>>> ET.tostring(E.tag())
''
>>> ET.tostring(E.tag("text"))
'text'
>>> ET.tostring(E.tag(E.subtag("text"), "tail"))
'texttail'
Here's a somewhat larger example; this shows how to generate HTML
documents, using a mix of prepared factory functions for inline elements,
nested ``E.tag`` calls, and embedded XHTML fragments::
# some common inline elements
A = E.a
I = E.i
B = E.b
def CLASS(v):
# helper function, 'class' is a reserved word
return {'class': v}
page = (
E.html(
E.head(
E.title("This is a sample document")
),
E.body(
E.h1("Hello!", CLASS("title")),
E.p("This is a paragraph with ", B("bold"), " text in it!"),
E.p("This is another paragraph, with a ",
A("link", href="http://www.python.org"), "."),
E.p("Here are some reservered characters: ."),
ET.XML("And finally, here is an embedded XHTML fragment.
"),
)
)
)
print ET.tostring(page)
Here's a prettyprinted version of the output from the above script::
This is a sample document
Hello!
This is a paragraph with bold text in it!
This is another paragraph, with link.
Here are some reservered characters: <spam&egg>.
And finally, here is an embedded XHTML fragment.
For namespace support, you can pass a namespace map (``nsmap``)
and/or a specific target ``namespace`` to the ElementMaker class::
>>> E = ElementMaker(namespace="http://my.ns/")
>>> print(ET.tostring( E.test ))
>>> E = ElementMaker(namespace="http://my.ns/", nsmap={'p':'http://my.ns/'})
>>> print(ET.tostring( E.test ))
c s | d j o d | d | _ n
d | _ | o t | ƒ | _ n
d | _ | d j o
| | _ n
t i | _ ˆ o ˆ i ƒ ‰ n h ‰ d „ } t ˆ j o | ˆ t