gdZddlmZejZddlmZ e e GddZ e Z y#e $re ZYwxYw#e $re Z Y(wxYw)z9 The ``E`` Element factory for generating XML documents. Npartialc(eZdZdZ ddZdZdZy) ElementMakerac 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 reserved 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 reserved 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 )) Nc|d|zdznd|_|r t|nd|_| t|sJ||ntj |_r tnid}d}tvr |t<tvr |t<tjvr|tj<fd}tvr |t<|_ y)N{}c |d}|jxsd|z|_y#t$r|jxsd|z|_YywxYw)N)tail IndexErrortext)elemitem last_childs =/opt/hc_python/lib64/python3.12/site-packages/lxml/builder.pyadd_textz'ElementMaker.__init__..add_textsM A!"X $.??#8bD"@  5!YY_"4  5s !AAcZ|jrtd|jz||_y)Nz.add_cdatas(yy !_bfbkbk!kllDIc|j}|jD]3\}}t|tr|||<t |d|||<5yN)attribitems isinstance basestringtype)rrrkvtypemaps radd_dictz'ElementMaker.__init__..add_dictsN[[F 1a, !F1I 0Q 0q 9F1I %r) _namespacedict_nsmapcallableETElement _makeelementstrunicodeCDATA_typemap)selfr# namespacensmap makeelementrrr$s ` r__init__zElementMaker.__init__s3<3H# /C/d%*d5k "h{&;;;+6+BK $+$w- A  g #GCL ' !'GG  887 " )GBHH  : w $GDM rc|j}t|tst|tr |j}n#|j |ddk7r|j |z}|j ||j}|r|t|||D]}t|r|}|jt|}|{tj|r|j|Xt|jD]}|j|}|n&t!dt|j"d|d|||} | s|jt| || |S)Nrr)r2zbad argument type: ())r/rr,_QNamerr%r+r'r&r(getr r) iselementappend__mro__ TypeError__name__) r0tagchildrenrr#rrtbasetyper"s r__call__zElementMaker.__call__s?--#s# 3(?((C __ (SVs]//C'C  DKK 8  GDM$ 'D~v DJ'Ay<<%KK% $T 2 2H H-A} !3 $%)$Z%8%8$%@AA$ A$ DG$T1-%( rct||Srr)r0r?s r __getattr__zElementMaker.__getattr__stS!!r)NNNN)r> __module__ __qualname____doc__r4rCrErrrr;s"Vp $9=* X!F"rr)rH lxml.etreeetreer)QNamer8 functoolsrr NameErrorr,r-rErIrrrPsnL   i"i"ZNmJ Gs3A==A  A