o jrc@sdZddlmZddlZddlmZmZmZmZm Z m Z ddl m Z ddl mZmZddlmZddlmZmZmZdd lmZerNdd lmZdd lmZd,ddZGdddeZe dZGddde Z!GdddZ"Gddde"Z#Gddde"Z$GdddZ%Gddde%Z&Gdd d e%Z'Gd!d"d"e%Z(Gd#d$d$e%Z)Gd%d&d&e%Z*Gd'd(d(e%Z+Gd)d*d*e je!d+Z,dS)-z?Enabling declarative definition of lxml custom element classes.) annotationsN) TYPE_CHECKINGAnyCallableSequenceTypeTypeVar)etree) ElementBase_Element)InvalidXmlError)NamespacePrefixedTagnsmapqn) lazyproperty) BaseXmlEnum)BaseSimpleTypeelementr cCstj|ddd}t|S)z[Serialize `element` to human-readable XML suitable for tests. No XML declaration. unicodeT)encodingZ pretty_print)r Ztostring XmlString)rxmlrS/var/www/html/Deteccion_Ine/venv/lib/python3.10/site-packages/docx/oxml/xmlchemy.pyserialize_for_readingsrc@sPeZdZdZedZdddZdd d ZdddZ dddZ e dddZ dS)rz]Provides string comparison override suitable for serialized XML that is useful for tests.z)( *)([^<]*)?$otherobjectreturnboolcCs\t|tsdS|}|}t|t|krdSt||D] \}}|||s+dSqdS)NFT) isinstancestr splitlineslenzip _eq_elm_strs)selfrlinesZ lines_otherlineZ line_otherrrr__eq__+s  zXmlString.__eq__cCs || SN)r()r%rrrr__ne__7 zXmlString.__ne__attrsr list[str]cCs|}|}t|S)zReturn a sequence of attribute strings parsed from `attrs`. Each attribute string is stripped of whitespace on both ends. )stripsplitsorted)r%r,Zattr_lstrrr _attr_seq:szXmlString._attr_seqr'line_2c Cs\||\}}}}||\}}} } ||krdS||||kr$dS|| kr*dS|| kS)zZReturn True if the element in `line_2` is XML equivalent to the element in `line`.F) _parse_liner1) r%r'r2frontr,closetextZfront_2Zattrs_2Zclose_2Ztext_2rrrr$CszXmlString._eq_elm_strstuple[str, str, str, str]csD|j|dur dSfddtddD\}}}}||||fS)zI(front, attrs, close, text) 4-tuple result of parsing XML element `line`.N)r8r8r8csg|]}|qSr)group).0nmatchrr Vsz)XmlString._parse_line..)_xml_elm_line_pattr=range)clsr'r4r,r5r6rr<rr3Ps   zXmlString._parse_lineN)rrrr)r,r rr-)r'r r2r )r'r rr7) __name__ __module__ __qualname____doc__recompilerAr(r*r1r$ classmethodr3rrrrrs    r_Tc@seZdZdZd dd Zd S) MetaOxmlElementzMetaclass for BaseOxmlElement.clsnamer basestuple[type, ...] namespacedict[str, Any]cCs>tttttttf}|D]\}}t||r| ||q dSr)) OneAndOnlyOne OneOrMoreOptionalAttributeRequiredAttribute ZeroOrMore ZeroOrOneZeroOrOneChoiceitemsrpopulate_class_members)rCrMrNrPZ dispatchablekeyvaluerrr__init__`s  zMetaOxmlElement.__init__N)rMr rNrOrPrQ)rDrErFrGr]rrrrrL]srLcs\eZdZdZdfdd Zdd dZddZeddZedddZ edddZ Z S) BaseAttributezZBase class for OptionalAttribute and RequiredAttribute. Provides common methods. attr_namer simple_type(Type[BaseXmlEnum] | Type[BaseSimpleType]ctt|||_||_dSr))superr^r] _attr_name _simple_type)r%r_r` __class__rrr]u zBaseAttribute.__init__ element_clsrL prop_namerNonecCs||_||_|dSz-Add the appropriate methods to `element_cls`.N) _element_cls _prop_name_add_attr_propertyr%rirjrrrrZzs z$BaseAttribute.populate_class_memberscCs$t|j|jd}t|j|j|dS)zAdd a read/write `.{prop_name}` property to the element class. The property returns the interpreted value of this attribute on access and changes the attribute value to its ST_* counterpart on assignment. N)property_getter_settersetattrrmrnr% property_rrrrosz BaseAttribute._add_attr_propertycCsd|jvr t|jS|jS)N:)rdrr%rrr _clark_names  zBaseAttribute._clark_name'Callable[[BaseOxmlElement], Any | None]cCdSr)rrxrrrrrszBaseAttribute._getter-Callable[[BaseOxmlElement, Any | None], None]cCr{r)rrxrrrrsszBaseAttribute._setter)r_r r`rarirLrjr rrkrrz)rr|) rDrErFrGr]rZrorqryrrrs __classcell__rrrfrr^os   r^csNeZdZdZ ddfd d Zed d ZedddZedddZZ S)rTaDefines an optional attribute on a custom element class. An optional attribute returns a default value when not present for reading. When assigned |None|, the attribute is removed, but still returns the default value when one is specified. Nr_r r`radefault0BaseXmlEnum | BaseSimpleType | str | bool | Nonecstt|||||_dSr))rcrTr]_default)r%r_r`rrfrrr]s zOptionalAttribute.__init__cCs|jjd|jdS)z;String to use as `__doc__` attribute of attribute property.z type-converted value of ``z`` attribute, or |None| (or specified default value) if not present. Assigning the default value causes the attribute to be removed from the element.rerDrdrxrrr _docstrings zOptionalAttribute._docstringrrzcdfdd }j|_|S) zJFunction suitable for `__get__()` method on attribute property descriptor.objBaseOxmlElementr Any | Nonecs&|j}|dur jSj|Sr))getryrrefrom_xmlrZattr_str_valuerxrrget_attr_values  z1OptionalAttribute._getter..get_attr_valueNrrrrrrGr%rrrxrrrszOptionalAttribute._getter&Callable[[BaseOxmlElement, Any], None]cdfdd }|S) zJFunction suitable for `__set__()` method on attribute property descriptor.rrr\rcsl|dus |jkrj|jvr|jj=dSj|}|dur-j|jvr+|jj=dS|j|dSr))rryZattribreto_xmlsetrr\Z str_valuerxrrset_attr_values     z1OptionalAttribute._setter..set_attr_valueN)rrr\rrr%rrrxrrss zOptionalAttribute._setterr))r_r r`rarrr~rr) rDrErFrGr]rqrrrrsrrrrfrrTs   rTc@s8eZdZdZeddZed ddZed d d Zd S)rUaDefines a required attribute on a custom element class. A required attribute is assumed to be present for reading, so does not have a default value; its actual value is always used. If missing on read, an |InvalidXmlError| is raised. It also does not remove the attribute if |None| is assigned. Assigning |None| raises |TypeError| or |ValueError|, depending on the simple type of the attribute. cCsd|jj|jfS)zaReturn the string to use as the ``__doc__`` attribute of the property for this attribute.z,%s type-converted value of ``%s`` attribute.rrxrrrrszRequiredAttribute._docstringr Callable[[BaseOxmlElement], Any]cr) zDfunction object suitable for "get" side of attr property descriptor.rrrrcs4|j}|durtdj|jfj|S)Nz1required '%s' attribute not present on element %s)rryr rdtagrerrrxrrrs  z1RequiredAttribute._getter..get_attr_valueNrrrrrxrrrszRequiredAttribute._getterrcr) zIfunction object suitable for "set" side of attribute property descriptor.rrr\rcs6j|}|durtd|d|j|dS)Nzcannot assign z to this required attribute)rer ValueErrorrryrrxrrrs z1RequiredAttribute._setter..set_attr_valueN)rrr\rrrrrxrrsszRequiredAttribute._setterN)rrr)rDrErFrGrqrrrrsrrrrrUs  rUcseZdZdZd2d3fdd Zd4ddZddZddZddZddZ ddZ e ddZ ddZ d5d!d"Zed6d$d%Zed&d'Ze d(d)Zed*d+Ze d,d-Ze d.d/Ze d0d1ZZS)7_BaseChildElementzBase class for the child-element classes. The child-element sub-classes correspond to varying cardinalities, such as ZeroOrOne and ZeroOrMore. r nsptagnamer successorstuple[str, ...]crbr))rcrr] _nsptagname _successors)r%rrrfrrr]rhz_BaseChildElement.__init__rirLrjrrkcCs||_||_dS)zFBaseline behavior for adding the appropriate methods to `element_cls`.N)rmrnrprrrrZs z(_BaseChildElement.populate_class_memberscs,d fdd }dj|_j|dS) zGAdd an ``_add_x()`` method to the element class for this child element.rrr,rcsHt|j}|}|D] \}}t|||q t|j}|||Sr))getattr_new_method_namerYrt_insert_method_name)rr,Z new_methodchildr[r\Z insert_methodrxrr _add_childs  z0_BaseChildElement._add_adder.._add_childSAdd a new ``<%s>`` child element unconditionally, inserted in the correct sequence.N)rrr,r)rrG _add_to_class_add_method_name)r%rrrxr _add_adders  z_BaseChildElement._add_addercCs$|j}d|j|_||j|dS)zAdd a ``_new_{prop_name}()`` method to the element class that creates a new, empty element of the correct type, having no attributes.zYReturn a "loose", newly created ``<%s>`` element having no attributes, text, or children.N)_creatorrrGrr)r%Zcreatorrrr _add_creator+s z_BaseChildElement._add_creatorcC"t|jdd}t|j|j|dS)z]Add a read-only ``{prop_name}`` property to the element class for this child element.N)rqrrrtrmrnrurrr _add_getter5z_BaseChildElement._add_gettercs,dfdd }dj|_j|dS) zJAdd an ``_insert_x()`` method to the element class for this child element.rrrcs|j|gjR|Sr))insert_element_beforerrrrxrr _insert_child?sz6_BaseChildElement._add_inserter.._insert_childzYReturn the passed ``<%s>`` element after inserting it as a child in the correct sequence.N)rrrr)rrGrr)r%rrrxr _add_inserter<s z_BaseChildElement._add_insertercCs*d|j}t|jdd}t|j||dS)zAdd a read-only ``{prop_name}_lst`` property to the element class to retrieve a list of child elements matching this type.z%s_lstN)rnrq _list_getterrtrm)r%rjrvrrr_add_list_getterIs z"_BaseChildElement._add_list_gettercC d|jS)Nz_add_%srnrxrrrrP z"_BaseChildElement._add_method_namec,dfdd }dj|_j|dS)z.add_childrNrr)rrGr_public_add_method_name)r%rrrxr_add_public_adderTs z#_BaseChildElement._add_public_addernamemethodCallable[..., Any]cCs"t|j|rdSt|j||dS)zbAdd `method` to the target class as `name`, unless `name` is already defined on the class.N)hasattrrmrt)r%rrrrrrbs z_BaseChildElement._add_to_class,Callable[[BaseOxmlElement], BaseOxmlElement]cs ddlmdfdd }|S) zHCallable that creates an empty element of the right type, with no attrs.r) OxmlElementrrcs jSr)rrrr%rrnew_child_elementns z5_BaseChildElement._creator..new_child_elementNr)Zdocx.oxml.parserr)r%rrrrris z_BaseChildElement._creatorcdfdd }dj|_|S)zReturn a function object suitable for the "get" side of the property descriptor. This default getter returns the child element with matching tag name or |None| if not present. rrc|tjSr))findrrrrxrrget_child_element|z4_BaseChildElement._getter..get_child_elementz0``<%s>`` child element or |None| if not present.NrrrGr%rrrxrrrss z_BaseChildElement._gettercCr)Nz _insert_%srrxrrrrrz%_BaseChildElement._insert_method_namecr)z[Return a function object suitable for the "get" side of a list property descriptor.rrcrr))findallrrrrxrrget_child_element_listrz>_BaseChildElement._list_getter..get_child_element_listzPA list containing each of the ``<%s>`` child elements, in the order they appear.Nrr)r%rrrxrrs z_BaseChildElement._list_gettercCr)a add_childElement() is public API for a repeating element, allowing new elements to be added to the sequence. May be overridden to provide a friendlier API to clients having domain appropriate parameter names for required attributes. zadd_%srrxrrrrs z)_BaseChildElement._public_add_method_namecCrNz _remove_%srrxrrr_remove_method_namerz%_BaseChildElement._remove_method_namecCr)Nz_new_%srrxrrrrrz"_BaseChildElement._new_method_namer)rr rrr})rr rr)rr)rDrErFrGr]rZrrrrrrrrrrqrrrrrrrrrrrrfrrs6           rc@sReZdZdZeddZdd d ZddZeddZe ddZ e ddZ dS)ChoicezVDefines a child element belonging to a group, only one of which may appear as a child.cCs|jSr)rrxrrrrszChoice.nsptagnamerirLgroup_prop_namer rrrrkcCs>||_||_||_|||||dSrl)rm_group_prop_namerrrrr_add_get_or_change_to_method)r%rirrrrrrZs zChoice.populate_class_memberscr)zZAdd a ``get_or_change_to_x()`` method to the element class for this child element.rrcs@t|j}|dur |St|j}|t|j}|}|Sr))rrn_remove_group_method_namer)rrZremove_group_method add_methodrxrrget_or_change_to_childs   zCChoice._add_get_or_change_to_method..get_or_change_to_childzFReturn the ``<%s>`` child, replacing any other group element if found.Nr)rrGr_get_or_change_to_method_name)r%rrrxrrs  z#Choice._add_get_or_change_to_methodcCs,d|jvr |jddnd}|j|dS)zDProperty name computed from tag name, e.g. a:schemeClr -> schemeClr.rwr?rN)rindex)r%startrrrrnszChoice._prop_namecCr)Nzget_or_change_to_%srrxrrrrrz$Choice._get_or_change_to_method_namecCrr)rrxrrrrrz Choice._remove_group_method_nameN)rirLrr rrrrk) rDrErFrGrqrrZrrnrrrrrrrrs    rcs<eZdZdZdfdd Zdfd d Zed dZZS)rRz5Defines a required child element for MetaOxmlElement.rr cstt||ddS)Nr)rcrRr])r%rrfrrr]szOneAndOnlyOne.__init__rirLrjrrkcstt||||dSrl)rcrRrZrrprfrrrZs z$OneAndOnlyOne.populate_class_memberscr)XReturn a function object suitable for the "get" side of the property descriptor.rrcs*|tj}|durtdj|S)Nz+required ``<%s>`` child element not present)rrrr rrxrrrs z0OneAndOnlyOne._getter..get_child_elementz Required ``<%s>`` child element.Nrrrrrxrrrs zOneAndOnlyOne._getter)rr r}) rDrErFrGr]rZrqrrrrrrfrrRs rRc"eZdZdZd fdd ZZS) rSzYDefines a repeating child element for MetaOxmlElement that must appear at least once.rirLrjr rrkcHtt||||||||t||dSrl) rcrSrZrrrrrdelattrrprfrrrZz OneOrMore.populate_class_membersr}rDrErFrGrZrrrrfrrSsrScr) rVz@Defines an optional repeating child element for MetaOxmlElement.rirLrjr rrkcrrl) rcrVrZrrrrrrrprfrrrZrz!ZeroOrMore.populate_class_membersr}rrrrfrrVsrVcs>eZdZdZdfdd Zd d Zd d ZeddZZ S)rWz6Defines an optional child element for MetaOxmlElement.rirLrjr rrkcsFtt|||||||||dSrl) rcrWrZrrrr_add_get_or_adder _add_removerrprfrrrZs z ZeroOrOne.populate_class_memberscr)zTAdd a ``get_or_add_x()`` method to the element class for this child element.rrcs*t|j}|durt|j}|}|Sr))rrnr)rrrrxrrget_or_add_child-s  z5ZeroOrOne._add_get_or_adder..get_or_add_childz>Return the ``<%s>`` child element, newly added if not present.Nr)rrGr_get_or_add_method_name)r%rrrxrr)s zZeroOrOne._add_get_or_addercr)zIAdd a ``_remove_x()`` method to the element class for this child element.rrcs|jdSr)) remove_allrrrxrr _remove_child<rz-ZeroOrOne._add_remover.._remove_childz#Remove all ``<%s>`` child elements.Nr)rrGrr)r%rrrxrr9s zZeroOrOne._add_removercCr)Nz get_or_add_%srrxrrrrBrz!ZeroOrOne._get_or_add_method_namer}) rDrErFrGrZrrrrrrrrfrrWs  rWcsbeZdZdZddddZdfdd ZddZddZeddZ e ddZ e ddZ Z S)rXzeCorrespondes to an ``EG_*`` element group where at most one of its members may appear as a child.rchoicesSequence[Choice]rrcCs||_||_dSr))_choicesr)r%rrrrrr]Ks zZeroOrOneChoice.__init__rirLrjr rrkcsDtt|||||jD] }|||j|jq|dSrl)rcrXrZ_add_choice_getterrrnr_add_group_remover)r%rirjchoicerfrrrZOs   z&ZeroOrOneChoice.populate_class_memberscCr)zAdd a read-only ``{prop_name}`` property to the element class that returns the present member of this group, or |None| if none are present.N)rq_choice_getterrtrmrnrurrrrWrz"ZeroOrOneChoice._add_choice_gettercs&dfdd }d|_j|dS)zSAdd a ``_remove_eg_x()`` method to the element class for this choice group.rrcsjD]}||qdSr))_member_nsptagnamesr)rtagnamerxrr_remove_choice_groupbs  z@ZeroOrOneChoice._add_group_remover.._remove_choice_groupz9Remove the current choice group child element if present.Nr)rGr _remove_choice_group_method_name)r%rrrxrr^sz"ZeroOrOneChoice._add_group_removercsdfdd }d|_|S)rrrcs |jjSr))first_child_found_inrrrxrrget_group_member_elementnr+z@ZeroOrOneChoice._choice_getter..get_group_member_elementzbReturn the child element belonging to this element group, or |None| if no member child is present.Nr)rG)r%rrrxrriszZeroOrOneChoice._choice_gettercCsdd|jDS)zjSequence of namespace-prefixed tagnames, one for each of the member elements of this choice group.cSsg|]}|jqSr)r)r:rrrrr>{sz7ZeroOrOneChoice._member_nsptagnames..)rrxrrrrwsz#ZeroOrOneChoice._member_nsptagnamescCrrrrxrrrr}rz0ZeroOrOneChoice._remove_choice_group_method_namer)rrrrr})rDrErFrGr]rZrrrqrrrrrrrrfrrXGs   rXcsdeZdZdZddZddd Zdd d ZdddZedddZ dfdd Z edddZ Z S)rzvEffective base class for all custom element classes. Adds standardized behavior to all classes in one place. cCsd|jj|jt|fS)Nz<%s '<%s>' at 0x%0x>)rgrD_nsptagidrxrrr__repr__s zBaseOxmlElement.__repr__tagnamesr r_Element | NonecGs,|D]}|t|}|dur|SqdS)z9First child with tag in `tagnames`, or None if not found.N)rr)r%rrrrrrrs z$BaseOxmlElement.first_child_found_inelmr cGs.|j|}|dur|||S|||Sr))rZ addpreviousappend)r%rr successorrrrrs   z%BaseOxmlElement.insert_element_beforerkcGs0|D]}|t|}|D]}||q qdS)z>Remove child elements with tagname (e.g. "a:p") in `tagnames`.N)rrremove)r%rrZmatchingrrrrrs  zBaseOxmlElement.remove_allcCst|S)zXML string for this element, suitable for testing purposes. Pretty printed for readability and without an XML declaration at the top. )rrxrrrrszBaseOxmlElement.xml xpath_strrcstj|tdS)zOverride of `lxml` _Element.xpath() method. Provides standard Open XML namespace mapping (`nsmap`) in centralized location. ) namespaces)rcxpathr)r%rrfrrrszBaseOxmlElement.xpathcCs t|jSr))r Zfrom_clark_namerrxrrrrs zBaseOxmlElement._nsptag)rr rr)rr rr )rr rrk)rr )rr rr) rDrErFrGrrrrrqrrrrrrrfrrs    r) metaclass)rr )-rG __future__rrHtypingrrrrrrZlxmlr Z lxml.etreer r Zdocx.oxml.exceptionsr Z docx.oxml.nsr rrZ docx.sharedrZdocx.enum.baserZdocx.oxml.simpletypesrrr rrKtyperLr^rTrUrrrRrSrVrWrXrrrrrs8         ;+?/":+<