a $i%!@sdZddlmZejZddlmZzddlm Z Wne yLddZ Yn0ze Wne yleZ Yn0zeWne yeZYn0GdddZeZdS) z9 The ``E`` Element factory for generating XML documents. Npartial) GenericAliascCs|jd|jdS)N[])__name__clsitemr Z/var/www/staging/api/virtual_environments/venv/lib/python3.9/site-packages/lxml/builder.py _GenericAlias4sr c@s2eZdZdZd ddZddZddZd d ZdS) 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 )) Ncs|durd|dnd|_|r&t|nd|_|dus@t|s@J|durL|ntj|_r`tnidd}dd}tvr|t<tvr|t<tj vr|tj <fdd}tvr|t<|_ dS) N{}cSsDz |d}Wn"ty.|jp"d||_Yn0|jp8d||_dS)N) IndexErrortexttail)elemr Z last_childr r r add_texts   z'ElementMaker.__init__..add_textcSs|jrtd|j||_dS)Nz.add_cdatacsF|j}|D]2\}}t|tr*|||<qt|d|||<qdSN)attribitems isinstance basestringtype)rr rkvtypemapr r add_dicts   z'ElementMaker.__init__..add_dict) _namespacedict_nsmapcallableETZElement _makeelementstrunicodeZCDATA_typemap)selfr$ namespacensmapZ makeelementrrr%r r#r __init__s"   zElementMaker.__init__c Os |j}t|ts"t|tr"|j}n |jdurB|ddkrB|j|}|j||jd}|rd|t|||D]}t |rz|}| t |}|durt |r||qht |jD]}| |}|durqqtdt |j|f|||} | rh| t | || qh|S)Nrr)r1zbad argument type: %s(%r))r.rr,_QNamerr&r+r(r'r)getr r*Z iselementappend__mro__ TypeErrorr) r/tagchildrenrr$rr tZbasetyper"r r r __call__s6      zElementMaker.__call__cCs t||Srr)r/r8r r r __getattr__szElementMaker.__getattr__cCs t||Sr)r rr r r __class_getitem__szElementMaker.__class_getitem__)NNNN)r __module__ __qualname____doc__r2r;r<r=r r r r rBsX ,#r)r@Z lxml.etreeetreer*ZQNamer3 functoolsrtypesrr ImportErrorr NameErrorr,r-rEr r r r &s$       2