+ h%!csRt^RIHt]Pt^RIHt^RIH t ] ]!RR4t]!4tR# ] dRt L%i;i ] d]t L1i;i ] d]tL=i;i)z9 The ``E`` Element factory for generating XML documents. Npartial) GenericAliascs:VP RVP R2#)Z[Z])__name__Zclsitem&&3/usr/lib64/python3.14/site-packages/lxml/builder.py _GenericAliasr4s,,qq11cs@a]tRt^BtoRtRRltRtRtRtRt Vt R#) ElementMakeraG 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 )) NcsaVeRV,R,MRVnV'd \V4MRVnVeTM\PVnS'd \S4M/oRpRp\ S9d VS\ &\S9d VS\&\PS9dVS\P&V3Rlp\S9d VS\&SVn R#)N{Z}csVR,pVP;'gRV,VnR# \d'TP;'gRT,TnR#i;i)iZNi)ZtailZ IndexErrortext)elemrZ last_childs&& radd_textZ'ElementMaker.__init__..add_textsR A!"X $.??#8#8bD"@  5!YY__"4  5s /A  A A csnVP'd\RVP,4hWnR#)z.add_cdatas(yyy !_bfbkbk!kllIr cs<VPpVP4F<wr4\V\4'dWBV&K!S\ V4,!RV4W#&K> R#N)attribZitems isinstance basestringtype)r rrZkvtypemaps&& radd_dictZ'ElementMaker.__init__..add_dictsI[[F a,, !1I 'Q 0q 9FI %r ) _namespacedict_nsmapETZElement _makeelementstrunicodeZCDATA_typemap)selfrZ namespacensmapZ makeelementrrrs&f&&& r__init__ZElementMaker.__init__s3<3H# /C/d%*d5k ,7+BK $+$w- A  g #GCL ' !'GG  887 " )GBHH  : w $GDM r csPVPp\V\4'g$\V\4'dVPpM/VP e"V^,R8wdVP V,pVP WPR7pV'dV\,!WS4VFp\V4'dV!4pVP\V44pVf\P!V4'dVPV4Kh\V4PFpVPV4pVfKM) \!R\V4P": RV: R24hV!WV4p V 'gKVP\V 44!WY4K V#)Nr )r!zbad argument type: Z(Z))rrr_QNamer rrrrZcallableZgetrrZ iselementZappendZ__mro__Z TypeErrorr) r tagZchildrenrrr rZtZbasetypers &&*, r__call__ZElementMaker.__call__s@--#s## 3(?(?((C __ (SVs]//C'C  KK 8  DM$ 'D~~v DJ'Ay<<%%KK% $T 2 2H H-A} !3 $%)$Z%8%8$%@AA$ Aq DG$T-%( r c\W4#rr)r r$rr __getattr__ZElementMaker.__getattr__s t!!r cr&r)rrrr__class_getitem__ZElementMaker.__class_getitem__s S''r )rrrr)NNNN) rZ __module__Z __qualname__Z__firstlineno____doc__r"r%r'r(Z__static_attributes__Z__classdictcell__)Z __classdict__s@rr r Bs'Vp* X!F"((r r )r)Z lxml.etreeZetreerZQNamer#Z functoolsrZtypesrrZ ImportErrorrZ NameErrorrrr ZE)r rr*sL  23  m(m(bNC222J Gs1;A A AA AA A&%A&