
    h                         S r SSKJr  \R                  rSSKJr   \   \   " S S5      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    \ rS rSrSr  SS jrS rS rSrg)	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: &lt;spam&amp;egg&gt;.</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                   ^ Ub  SU-   S-   OS U l         U(       a  [        U5      OS U l        Ub  [        U5      (       d   eUb  UO[        R
                  U l        T(       a  [        T5      O0 mS nS n[        T;  a	  UT[        '   [        T;  a	  UT[        '   [        R                  T;  a  UT[        R                  '   U4S jn[        T;  a	  UT[        '   TU l
        g )N{}c                      U S   nUR                   =(       d    SU-   Ul         g ! [         a     U R                  =(       d    SU-   U l         g f = f)N )tail
IndexErrortext)elemitem
last_childs      >/var/www/html/env/lib/python3.13/site-packages/lxml/builder.pyadd_text'ElementMaker.__init__.<locals>.add_text   sM    A!"X
 $.??#8bD"@
  5!YY_"4	5s   % 'AAc                 b    U R                   (       a  [        SU R                   -  5      eXl         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&    yy !_bfbkbk!kllI    c                    > U R                   nUR                  5        H7  u  p4[        U[        5      (       a  XBU'   M   T[	        U5         " S U5      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,, !1I 'Q 0q 9FI	 %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%*d5k"h{&;&;;;+6+BK

 $+$w-	A	
 g#GCL'!'GG887" )GBHH	: w$GDMr   c                    U R                   n[        U[        5      (       d"  [        U[        5      (       a  UR                  nO%U R
                  b  US   S:w  a  U R
                  U-   nU R                  XR                  S9nU(       a  U[           " XS5        U H  n[        U5      (       a  U" 5       nUR                  [        U5      5      nUc  [        R                  " U5      (       a  UR                  U5        Me  [        U5      R                   H  nUR                  U5      nUc  M    O)   [!        S[        U5      R"                  < SU< S35      eU" XV5      n	U	(       d  M  UR                  [        U	5      5      " XY5        M     U$ )Nr   r	   )r6   zbad 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Vs]//C'C  KK 8DM$'D~~vDJ'Ay<<%%KK% $T
 2 2HH-A}	 !3 $%)$Z%8%8$%@ A A$AqDG$T-% ( r   c                     [        X5      $ 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