�
C��g� � � � S r SSKJr \R rSSKJr \ \ " S S5 r \ " 5 r
g! \ a \
r N f = f! \ a \
r N*f = f)z9
The ``E`` Element factory for generating XML documents.
� N��partialc �2 � \ rS rSrSr SS jrS rS rSrg) � ElementMaker�; aG 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/"/>
Nc �� ^� Ub SU- S- OS U l U( a [ U5 OS U l Ub [ U5 ( d eUb UO[ R
U l T( a [ T5 O0 mS nS n[ T; a UT[ ' [ T; a UT[ ' [ R T; a UT[ R ' U4S jn[ T; a UT[ ' TU l
g )N�{�}c � � U S nUR =( d SU- Ul g ! [ a U R =( d SU- U l g f = f)N���� )�tail�
IndexError�text)�elem�item�
last_childs �./usr/lib/python3/dist-packages/lxml/builder.py�add_text�'ElementMaker.__init__.<locals>.add_text� sM � �
A� !�"�X�
� $.�?�?�#8�b�D�"@�
��� �
5� !�Y�Y�_�"�� 4�� �
5�s �% �'A�Ac �b � U R ( a [ SU R - 5 eXl g )Nz<Can't add a CDATA section. Element already has some text: %r)r �
ValueError)r �cdatas r � add_cdata�(ElementMaker.__init__.<locals>.add_cdata� s& � ��y�y� �!_�bf�bk�bk�!k�l�l� �I� c � >� U R nUR 5 H7 u p4[ U[ 5 ( a XBU' M T[ U5 " S U5 X#' M9 g �N)�attrib�items�
isinstance�
basestring�type)r r r �k�v�typemaps �r �add_dict�'ElementMaker.__init__.<locals>.add_dict� sI �� ��[�[�F� �
�
� ��� �a��,�,� !�1�I� '��Q�� 0��q� 9�F�I� %r ) �
_namespace�dict�_nsmap�callable�ET�Element� _makeelement�str�unicode�CDATA�_typemap)�selfr& � namespace�nsmap� makeelementr r r' s ` r �__init__�ElementMaker.__init__� s� �� �3<�3H�#� �/�C�/�d���%*�d�5�k��� ��"�h�{�&;�&;�;�;�+6�+B�K��
�
��� $+�$�w�-��� A� �
�g� �#�G�C�L� �'� !� '�G�G� �
�8�8�7� "� )�G�B�H�H� � :� �w� � $�G�D�M� ��
r c � � U R n[ U[ 5 ( d" [ U[ 5 ( a
UR nO%U R
b US S:w a U R
U- nU R
XR S9nU( a U[ " XS5 U H� n[ U5 ( a U" 5 nUR [ U5 5 nUc� [ R " U5 ( a UR U5 Me [ U5 R H nUR U5 nUc M O) [! S[ U5 R" < SU< S35 eU" XV5 n U ( d M� UR [ U 5 5 " XY5 M� U$ )Nr r )r6 zbad argument type: �(�))r3 r! r0 �_QNamer r) r/ r+ r* r, �getr# r- � iselement�append�__mro__� TypeError�__name__)
r4 �tag�childrenr r& r r �t�basetyper% s
r �__call__�ElementMaker.__call__� s@ � ��-�-�� �#�s�#�#�
�3��(?�(?��(�(�C�
�_�_�
(�S��V�s�]��/�/�C�'�C�� � ��K�K� �8�� � �D�M�$� '� �D���~�~��v��� � �D��J�'�A��y��<�<��%�%��K�K��%� � $�T�
� 2� 2�H� � � �H�-�A��}� � !3� $�%)�$�Z�%8�%8�$�%@� A� A��$�
�A��q�� � �D��G�$�T�-�% �( � r c � � [ X5 $ r r )r4 rD s r � __getattr__�ElementMaker.__getattr__� s
� ��t�!�!r )r/ r) r+ r3 )NNNN) rC �
__module__� __qualname__�__firstlineno__�__doc__r8 rH rK �__static_attributes__� r r r r ; s" � �V�p $�9=�* �X!�F"r r )rP �
lxml.etree�etreer- �QNamer= � functoolsr r" � NameErrorr0 r1 r �ErR r r �<module>rY sn ��L�
� ���� ���� �
i"� i"�Z �N���m � ��J���
� ��G��s �3 �A �>�>�A � A