�
�'�Yc @ s� d Z d d l j Z d d l m Z y e Wn e k
rF e Z n Xy e Wn e k
rh e Z n Xd e
f d � � YZ e � Z d S( s9
The ``E`` Element factory for generating XML documents.
i����N( t partialt ElementMakerc B s5 e Z d Z d d d d d � Z d � Z d � Z RS( sc 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"))
'<tag/>'
>>> ET.tostring(E("tag", "text"))
'<tag>text</tag>'
>>> ET.tostring(E("tag", "text", key="value"))
'<tag key="value">text</tag>'
>>> ET.tostring(E("tag", E("subtag", "text"), "tail"))
'<tag><subtag>text</subtag>tail</tag>'
For simple tags, the factory also allows you to write ``E.tag(...)`` instead
of ``E('tag', ...)``::
>>> ET.tostring(E.tag())
'<tag/>'
>>> ET.tostring(E.tag("text"))
'<tag>text</tag>'
>>> ET.tostring(E.tag(E.subtag("text"), "tail"))
'<tag><subtag>text</subtag>tail</tag>'
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 reserved characters: <spam&egg>."),
ET.XML("<p>And finally, here is an embedded XHTML fragment.</p>"),
)
)
)
print ET.tostring(page)
Here's a prettyprinted version of the output from the above script::
<html>
<head>
<title>This is a sample document</title>
</head>
<body>
<h1 class="title">Hello!</h1>
<p>This is a paragraph with <b>bold</b> text in it!</p>
<p>This is another paragraph, with <a href="http://www.python.org">link</a>.</p>
<p>Here are some reserved characters: <spam&egg>.</p>
<p>And finally, here is an embedded XHTML fragment.</p>
</body>
</html>
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 ))
<test xmlns="http://my.ns/"/>
>>> E = ElementMaker(namespace="http://my.ns/", nsmap={'p':'http://my.ns/'})
>>> print(ET.tostring( E.test ))
<p:test xmlns:p="http://my.ns/"/>
c s! | d k r d | d | _ n d | _ | rA t | � | _ n d | _ | d k rb | | _ n t j | _ � r� t � � � n i � d � } d � } t � k r� | � t <n t � k r� | � t <n t j � k r� | � t j <n � f d � } t � k r| � t <n � | _
d S( Nt {t }c S sP y" | d j p d | | d _ Wn' t k
rK | j p> d | | _ n Xd S( Ni����t ( t tailt
IndexErrort text( t elemt item( ( s2 /usr/lib64/python2.7/site-packages/lxml/builder.pyt add_text� s "
c S s, | j r t d | j � � n | | _ d S( Ns< Can't add a CDATA section. Element already has some text: %r( R t
ValueError( R t cdata( ( s2 /usr/lib64/python2.7/site-packages/lxml/builder.pyt add_cdata� s c sc | j } xS | j � D]E \ } } t | t � r> | | | <q � t | � d | � | | <q Wd S( N( t attribt itemst
isinstancet
basestringt typet None( R R R t kt v( t typemap( s2 /usr/lib64/python2.7/site-packages/lxml/builder.pyt add_dict� s
( R t
_namespacet dictt _nsmapt _makeelementt ETt Elementt strt unicodet CDATAt _typemap( t selfR t namespacet nsmapt makeelementR
R
R ( ( R s2 /usr/lib64/python2.7/site-packages/lxml/builder.pyt __init__� s0
c
O si | j } | j d k r8 | d d k r8 | j | } n | j | d | j �} | rj | t | | � n x� | D]� } t | � r� | � } n | j t | � � } | d k r-t j
| � r� | j | � qq n xX t | � j D]% } | j | � } | d k r� Pq� q� Wt
d t | � j | f � � n | | | � } | rq | j t | � � | | � qq qq W| S( Ni R R$ s bad argument type: %s(%r)( R! R R R R R t callablet getR R t iselementt appendt __mro__t TypeErrort __name__(
R" t tagt childrenR R R R t tt basetypeR ( ( s2 /usr/lib64/python2.7/site-packages/lxml/builder.pyt __call__� s0
#c C s
t | | � S( N( R ( R" R. ( ( s2 /usr/lib64/python2.7/site-packages/lxml/builder.pyt __getattr__� s N( R- t
__module__t __doc__R R& R2 R3 ( ( ( s2 /usr/lib64/python2.7/site-packages/lxml/builder.pyR 7 s
W6 (
R5 t
lxml.etreet etreeR t functoolsR R t NameErrorR R t objectR t E( ( ( s2 /usr/lib64/python2.7/site-packages/lxml/builder.pyt <module>& s
�