hcSrSSKJr SSKrSSKJrJrJrJrJ r J r J r J r J r SSKJr SSKJrJr SSKJr SSKJrJrJr SS KJr \(a SS KJr SS KJr S)S jr"S S\ 5r!\ "S5r""SS\#5r$"SS5r%"SS\%5r&"SS\%5r'"SS5r("SS\(5r)"SS\(5r*"SS\(5r+"S S!\(5r,"S"S#\(5r-"S$S%\(5r."S&S'\R"\$S(9r/g)*z?Enabling declarative definition of lxml custom element classes.) annotationsN) TYPE_CHECKINGAnyCallableDictListSequenceTupleTypeTypeVar)etree) ElementBase_Element)InvalidXmlError)NamespacePrefixedTagnsmapqn) lazyproperty) BaseXmlEnum)BaseSimpleTypecD[R"USSS9n[U5$)zSSerialize `element` to human-readable XML suitable for tests. No XML declaration. unicodeT)encoding pretty_print)r tostring XmlString)elementxmls D/var/www/html/env/lib/python3.13/site-packages/docx/oxml/xmlchemy.pyserialize_for_readingr s ..94 HC S>cx\rSrSrSr\R "S5rS SjrS Sjr S Sjr S Sjr \ SSj5r S rg )r)zYProvides string comparison override suitable for serialized XML that is useful for tests.z)( *)([^<]*)?$c[U[5(dgUR5nUR5n[U5[U5:wag[ X#5HupEUR XE5(aM g g)NFT) isinstancestr splitlineslenzip _eq_elm_strs)selfotherlines lines_otherline line_others r__eq__XmlString.__eq__5sk%%%!&&( u:[) ) #E 7 D$$T66!8r!c.URU5(+$N)r1)r+r,s r__ne__XmlString.__ne__As;;u%%%r!cXUR5nUR5n[U5$)z{Return a sequence of attribute strings parsed from `attrs`. Each attribute string is stripped of whitespace on both ends. )stripsplitsorted)r+attrsattr_lsts r _attr_seqXmlString._attr_seqDs%  ;;=hr!cURU5up4pVURU5upxpX7:wagURU5URU5:wagXY:wagXj:wagg)zRReturn True if the element in `line_2` is XML equivalent to the element in `line`.FT) _parse_liner=) r+r/line_2frontr;closetextfront_2attrs_2close_2text_2s rr*XmlString._eq_elm_strsMsh%)$4$4T$:!e,0,<,>% DNN7$; ;   >r!cURRU5nUcg[SS5Vs/sHo2RU5PM snupEpgXEXg4$s snf)zI(front, attrs, close, text) 4-tuple result of parsing XML element `line`.)rKrKrK)_xml_elm_line_pattmatchrangegroup)clsr/rOnrBr;rCrDs rr@XmlString._parse_line\sX&&,,T2 =!=B1a[$I[[[^[$I!eU((%JsAN)r,objectreturnbool)r;r&rWz List[str])r/r&rAr&)r/r&rWzTuple[str, str, str, str])__name__ __module__ __qualname____firstlineno____doc__recompilerNr1r5r=r* classmethodr@__static_attributes__rUr!rrr)sA$PQ &  ))r!r_Tc"\rSrSrSrSSjrSrg)MetaOxmlElementizMetaclass for BaseOxmlElement.c[[[[[[ [ 4nUR5H(upV[Xd5(dMURX5 M* gr4) OneAndOnlyOne OneOrMoreOptionalAttributeRequiredAttribute ZeroOrMore ZeroOrOneZeroOrOneChoiceitemsr%populate_class_members)rRclsnamebases namespace dispatchablekeyvalues r__init__MetaOxmlElement.__init__lsL        $//+JC%..,,S6,r!rUN)rpr&rqzTuple[type, ...]rrzDict[str, Any])rYrZr[r\r]rvrarUr!rrdrdis ( 7r!rdc|^\rSrSrSrS U4SjjrS SjrSr\S5r \S Sj5r \S Sj5r S r U=r $) BaseAttribute{zRBase class for OptionalAttribute and RequiredAttribute. Provides common methods. cB>[[U] 5 XlX lgr4)superryrv _attr_name _simple_type)r+ attr_name simple_type __class__s rrvBaseAttribute.__init__s mT+-#'r!c<XlX lUR5 gz-Add the appropriate methods to `element_cls`.N) _element_cls _prop_name_add_attr_propertyr+ element_cls prop_names rro$BaseAttribute.populate_class_memberss'# !r!c[URURS5n[URUR U5 g)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_settersetattrrrr+ property_s rr BaseAttribute._add_attr_propertys0 T\\4<<> !!4??I>r!cdSUR;a[UR5$UR$)N:)r}rr+s r _clark_nameBaseAttribute._clark_names' $// !doo& &r!cgr4rUrs rrBaseAttribute._gettersBEr!cgr4rUrs rrBaseAttribute._setters9[[U] X5 X0lgr4)r|rirv_default)r+rrdefaultrs rrvOptionalAttribute.__init__s / G r!cNURRSURS3$)z;String to use as `__doc__` attribute of attribute property. 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.r~rYr}rs r _docstringOptionalAttribute._docstrings4  ))*+//"#9 : r!cB^SU4SjjnTRUlU$)zJFunction suitable for `__get__()` method on attribute property descriptor.c>URTR5nUc TR$TRR U5$r4)getrrr~from_xmlobjattr_str_valuer+s rget_attr_value1OptionalAttribute._getter..get_attr_values@!WWT%5%56N%}}$$$--n= =r!rBaseOxmlElementrW Any | Nonerr]r+rs` rrOptionalAttribute._getters,  >  >  >"&r!c^SU4SjjnU$)zJFunction suitable for `__set__()` method on attribute property descriptor.ch>UbUTR:Xa2TRUR;aURTR gTRR U5nUc2TRUR;aURTR gUR TRU5 gr4)rrattribr~to_xmlsetrru str_valuer+s rset_attr_value1OptionalAttribute._setter..set_attr_values} 6##szz1 4#3#34))007I ##szz1 4#3#34 GGD$$i 0r!)rrrurrUr+rs` rrOptionalAttribute._setters 1r!)rr4)rr&rrrz0BaseXmlEnum | BaseSimpleType | str | bool | NonerrWz&Callable[[BaseOxmlElement, Any], None]) rYrZr[r\r]rvrrrrrarrs@rririszEI   > B      0 r!ricP\rSrSrSr\S5r\SSj5r\S Sj5rSr g) rjaDefines 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. cRURR<SUR<S3$)zYReturn the string to use as the ``__doc__`` attribute of the property for this attribute.rz `` attribute.rrs rrRequiredAttribute._docstrings$    & & OO  r!c:^SU4SjjnTRUlU$)zDfunction object suitable for "get" side of attr property descriptor.c>URTR5nUc'[STR<SUR<35eTR R U5$)Nz required 'z#' attribute not present on element )rrrr}tagr~rrs rr1RequiredAttribute._getter..get_attr_valuesV WWT%5%56N%%KO??\_\c\cd$$--n= =r!rrrs` rrRequiredAttribute._getters >"&r!c^SU4SjjnU$)zIfunction object suitable for "set" side of attribute property descriptor.c>TRRU5nUc[SUS35eURTRU5 g)Nzcannot assign z to this required attribute)r~r ValueErrorrrrs rr1RequiredAttribute._setter..set_attr_value sH))007I  >%8S!TUU GGD$$i 0r!)rrrurrUrs` rrRequiredAttribute._setters 1 r!rUN)rWz Callable[[BaseOxmlElement], Any]r) rYrZr[r\r]rrrrrarUr!rrjrjsC      r!rjc^\rSrSrSrSSU4SjjjrSSjrSrSrSr Sr S r \ S 5r S rSS jr\SS j5r\S5r\ S5r\S5r\ S5r\ S5r\ S5rSrU=r$)_BaseChildElementizBase class for the child-element classes. The child-element sub-classes correspond to varying cardinalities, such as ZeroOrOne and ZeroOrMore. cB>[[U] 5 XlX lgr4)r|rrv _nsptagname _successors)r+ nsptagname successorsrs rrv_BaseChildElement.__init__s /1%%r!cXlX lg)zFBaseline behavior for adding the appropriate methods to `element_cls`.N)rrrs rro(_BaseChildElement.populate_class_members s '#r!cv^SU4SjjnSTR-UlTRTRU5 g)zGAdd an ``_add_x()`` method to the element class for this child element.c>[UTR5nU"5nUR5HupE[X4U5 M [UTR5nU"U5 U$r4)getattr_new_method_namernr_insert_method_name)rr; new_methodchildrtru insert_methodr+s r _add_child0_BaseChildElement._add_adder.._add_child(sW d&;&;`` child element unconditionally, inserted in the correct sequence.N)rrr;r)rr] _add_to_class_add_method_name)r+rs` r _add_adder_BaseChildElement._add_adder%s;  #%)%5%5 6  400*=r!c|URnSUR-UlURURU5 g)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)_creatorrr]rr)r+creators r _add_creator_BaseChildElement._add_creator7s?-- (*.*:*: ;  400':r!ct[URSS5n[URURU5 g)zUAdd a read-only ``{prop_name}`` property to the element class for this child element.N)rrrrrrs r _add_getter_BaseChildElement._add_getterAs,T\\46 !!4??I>r!cv^SU4SjjnSTR-UlTRTRU5 g)zJAdd an ``_insert_x()`` method to the element class for this child element.cB>UR"U/TRQ76 U$r4)insert_element_beforerrrr+s r _insert_child6_BaseChildElement._add_inserter.._insert_childKs!  % %e ?d.>.> ?Lr!zYReturn the passed ``<%s>`` element after inserting it as a child in the correct sequence.N)rrrr)rr]rr)r+rs` r _add_inserter_BaseChildElement._add_inserterHs;   )+/+;+; <  433]Cr!c|SUR-n[URSS5n[URX5 g)zzAdd a read-only ``{prop_name}_lst`` property to the element class to retrieve a list of child elements matching this type.z%s_lstN)rr _list_getterrr)r+rrs r_add_list_getter"_BaseChildElement._add_list_getterUs6t. T..d; !!98r!c SUR-$)Nz_add_%srrs rr"_BaseChildElement._add_method_name\4??**r!cv^SU4SjjnSTR-UlTRTRU5 g)z[UTR5nU"5nU$r4)rr)rprivate_add_methodrr+s r add_child6_BaseChildElement._add_public_adder..add_childcs#!(d.C.C!D &(ELr!rNrr)rr]r_public_add_method_name)r+r s` r_add_public_adder#_BaseChildElement._add_public_adder`s;   #%)%5%5 6  477Cr!ch[URU5(ag[URX5 g)zZAdd `method` to the target class as `name`, unless `name` is already defined on the class.N)hasattrrr)r+namemethods rr_BaseChildElement._add_to_classns* 4$$d + + !!40r!c(^^SSKJm SUU4SjjnU$)zHCallable that creates an empty element of the right type, with no attrs.r) OxmlElementc(>T"TR5$r4r)rrr+s rnew_child_element5_BaseChildElement._creator..new_child_elementzst//0 0r!r )docx.oxml.parserr)r+rrs` @rr_BaseChildElement._creatorus 1 1 1! r!c@^SU4SjjnSTR-UlU$)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. cL>UR[TR55$r4)findrrrr+s rget_child_element4_BaseChildElement._getter..get_child_elements88Bt//01 1r!z0``<%s>`` child element or |None| if not present.r rr]r+r"s` rr_BaseChildElement._getters( 2 ?AQAQ Q !! r!c SUR-$)Nz _insert_%srrs rr%_BaseChildElement._insert_method_namedoo--r!c@^SU4SjjnSTR-UlU$)zSReturn a function object suitable for the "get" side of a list property descriptor.cL>UR[TR55$r4)findallrrr!s rget_child_element_list>_BaseChildElement._list_getter..get_child_element_lists;;r$"2"234 4r!zPA list containing each of the ``<%s>`` child elements, in the order they appear.r r$)r+r-s` rr_BaseChildElement._list_getters+  5 "&"2"2 3 &&%r!c SUR-$)zadd_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_%srrs rr)_BaseChildElement._public_add_method_names$//))r!c SUR-$Nz _remove_%srrs r_remove_method_name%_BaseChildElement._remove_method_namer)r!c SUR-$)Nz_new_%srrs rr"_BaseChildElement._new_method_namerr!)rrrrrU)rr&rTuple[str, ...]r)rr&rzCallable[..., Any])rWz,Callable[[BaseOxmlElement], BaseOxmlElement])rYrZr[r\r]rvrorrrrrrrrrrrrrrrr4rrarrs@rrrs && $ >$;? D9++ D1!!!! .. & &**..++r!rcx\rSrSrSr\S5rS SjrSr\S5r \ S5r \ S5r S r g ) ChoiceizVDefines a child element belonging to a group, only one of which may appear as a child.cUR$r4rrs rrChoice.nsptagnamesr!cXlX lX0lUR5 UR 5 UR 5 UR 5 UR5 gr)r_group_prop_namerrrrr_add_get_or_change_to_method)r+rgroup_prop_namers rroChoice.populate_class_memberssP( /%     ))+r!cv^SU4SjjnSTR-UlTRTRU5 g)zRAdd a ``get_or_change_to_x()`` method to the element class for this child element.c>[UTR5nUbU$[UTR5nU"5 [UTR5nU"5nU$r4)rr_remove_group_method_namer)rrremove_group_method add_methodr+s rget_or_change_to_childCChoice._add_get_or_change_to_method..get_or_change_to_childsUC1E  ")#t/M/M"N   ! d&;&;`` child, replacing any other group element if found.Nr )rr]r_get_or_change_to_method_name)r+rHs` rr@#Choice._add_get_or_change_to_methods;  X   *& 4==?UVr!cSUR;aURRS5S-OSnURUS$)zDProperty name computed from tag name, e.g. a:schemeClr -> schemeClr.rrLrN)rindex)r+starts rrChoice._prop_namesB47$:J:J3J  &&s+a/PQ''r!c SUR-$)Nzget_or_change_to_%srrs rrJ$Choice._get_or_change_to_method_names$t66r!c SUR-$r3)r?rs rrE Choice._remove_group_method_namesd3333r!)rr?rN)rrdrAr&rr9rWr)rYrZr[r\r]rrror@rrrJrErarUr!rr;r;s  ,$,,$ ,  ,"W&(( 7744r!r;cP^\rSrSrSrSU4SjjrSU4Sjjr\S5rSr U=r $) rgiz5Defines a required child element for MetaOxmlElement.c.>[[U] US5 g)NrU)r|rgrv)r+rrs rrvOneAndOnlyOne.__init__s mT+J;r!cL>[[U] X5 UR5 gr)r|rgrorr+rrrs rro$OneAndOnlyOne.populate_class_memberss mT9+Q r!c@^SU4SjjnSTR-UlU$)PReturn a function object suitable for the "get" side of the property descriptor.c>UR[TR55nUc[STR-5eU$)Nz+required ``<%s>`` child element not present)r rrrrs rr"0OneAndOnlyOne._getter..get_child_elementsCHHR 0 012E}%ADDTDTTLr!z Required ``<%s>`` child element.r r$r%s` rrOneAndOnlyOne._getters%  %GIYIY$Y!  r!rU)rr&r) rYrZr[r\r]rvrorrrarrs@rrgrgs$?<  ! !r!rgc0^\rSrSrSrSU4SjjrSrU=r$)rhi zUDefines a repeating child element for MetaOxmlElement that must appear at least once.c>[[U] X5 UR5 UR 5 UR 5 UR 5 UR5 [X5 gr) r|rhrorrrrrdelattrrXs rro OneOrMore.populate_class_memberssT i5kM       'r!rUrrYrZr[r\r]rorarrs@rrhrh s ((r!rhc0^\rSrSrSrSU4SjjrSrU=r$)rkiz@Defines an optional repeating child element for MetaOxmlElement.c>[[U] X5 UR5 UR 5 UR 5 UR 5 UR5 [X5 gr) r|rkrorrrrrrarXs rro!ZeroOrMore.populate_class_memberssT j$6{N       'r!rUrrcrs@rrkrksJ((r!rkcL^\rSrSrSrSU4SjjrSrSr\S5r Sr U=r $) rli)z6Defines an optional child element for MetaOxmlElement.c>[[U] X5 UR5 UR 5 UR 5 UR 5 UR5 UR5 gr) r|rlrorrrr_add_get_or_adder _add_removerrXs rro ZeroOrOne.populate_class_members,sX i5kM       r!cv^SU4SjjnSTR-UlTRTRU5 g)zLAdd a ``get_or_add_x()`` method to the element class for this child element.ct>[UTR5nUc[UTR5nU"5nU$r4)rrr)rrrGr+s rget_or_add_child5ZeroOrOne._add_get_or_adder..get_or_add_child:s6C1E}$S$*?*?@ " Lr!z>Return the ``<%s>`` child element, newly added if not present.Nr )rr]r_get_or_add_method_name)r+rns` rriZeroOrOne._add_get_or_adder6s;  M   $  4779IJr!cv^SU4SjjnSTR-UlTRTRU5 g)zIAdd a ``_remove_x()`` method to the element class for this child element.c<>URTR5 gr4) remove_allrr!s r _remove_child-ZeroOrOne._add_remover.._remove_childIs NN4++ ,r!z#Remove all ``<%s>`` child elements.Nr )rr]rr4)r+rus` rrjZeroOrOne._add_removerFs4 -"G$JZJZ Z  433]Cr!c SUR-$)Nz get_or_add_%srrs rrp!ZeroOrOne._get_or_add_method_nameOs00r!rUr) rYrZr[r\r]rorirjrrprarrs@rrlrl)s+@K D11r!rlcz^\rSrSrSrS S SjjrS U4SjjrSrSr\ S5r \ S5r \ S 5r S rU=r$)rmiTzaCorrespondes to an ``EG_*`` element group where at most one of its members may appear as a child.cXlX lgr4_choicesr)r+choicesrs rrvZeroOrOneChoice.__init__Xs  %r!c>[[U] X5 UR5 URH)nURXR UR 5 M+ UR5 gr)r|rmro_add_choice_getterr}rr_add_group_remover)r+rrchoicers rro&ZeroOrOneChoice.populate_class_members\sR ot;KS !mmF  ) )+HXHX Y$ !r!ct[URSS5n[URURU5 g)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)r_choice_getterrrrrs rr"ZeroOrOneChoice._add_choice_getterds.T00$= !!4??I>r!c\^SU4SjjnSUlTRTRU5 g)zKAdd a ``_remove_eg_x()`` method to the element class for this choice group.cN>TRHnURU5 M gr4)_member_nsptagnamesrt)rtagnamer+s r_remove_choice_group@ZeroOrOneChoice._add_group_remover.._remove_choice_groupos33w'4r!z9Remove the current choice group child element if present.Nr )r]r _remove_choice_group_method_name)r+rs` rr"ZeroOrOneChoice._add_group_removerks+ ((c$ 4@@BVWr!c&^SU4SjjnSUlU$)r[c6>UR"TR6$r4)first_child_found_inrr!s rget_group_member_element@ZeroOrOneChoice._choice_getter..get_group_member_element{s++T-E-EF Fr!zbReturn the child element belonging to this element group, or |None| if no member child is present.r )r])r+rs` rrZeroOrOneChoice._choice_gettervs  G 4 !(('r!cXURVs/sHoRPM sn$s snf)zbSequence of namespace-prefixed tagnames, one for each of the member elements of this choice group.)r}r)r+rs rr#ZeroOrOneChoice._member_nsptagnamess$15 > f!! >>>s'c SUR-$r3rrs rr0ZeroOrOneChoice._remove_choice_group_method_namer)r!r|r8)r~zSequence[Choice]rr9r)rYrZr[r\r]rvrorrrrrrrrarrs@rrmrmTsY&"? X ( (?? ..r!rmc|^\rSrSrSrSrS SjrS SjrS Sjr\ SSj5r SU4Sjjr \ SS j5r S r U=r$)riznEffective base class for all custom element classes. Adds standardized behavior to all classes in one place. c`SURRUR[U54-$)Nz<%s '<%s>' at 0x%0x>)rrY_nsptagidrs r__repr__BaseOxmlElement.__repr__s/% NN # # LL tH)   r!cXUH$nUR[U55nUcM"Us $ g)z9First child with tag in `tagnames`, or None if not found.N)r r)r+tagnamesrrs rr$BaseOxmlElement.first_child_found_ins.GIIbk*E   r!crUR"U6nUbURU5 U$URU5 U$r4)r addpreviousappend)r+elmr successors rr%BaseOxmlElement.insert_element_befores@--x8   ! !# &  KK  r!c~UH7nUR[U55nUHnURU5 M M9 g)z>Remove child elements with tagname (e.g. "a:p") in `tagnames`.N)r,rremove)r+rrmatchingrs rrtBaseOxmlElement.remove_alls4G||BwK0H! E"" r!c[U5$)zXML string for this element, suitable for testing purposes. Pretty printed for readability and without an XML declaration at the top. )r rs rrBaseOxmlElement.xmls %T**r!c(>[TU]U[S9$)z}Override of `lxml` _Element.xpath() method. Provides standard Open XML namespace mapping (`nsmap`) in centralized location. ) namespaces)r|xpathr)r+ xpath_strrs rrBaseOxmlElement.xpaths w}Y5}99r!cB[R"UR5$r4)rfrom_clark_namerrs rrBaseOxmlElement._nsptags#33DHH==r!rU)rr&rWz_Element | None)rrrr&)rr&rWr)rWr&)rr&rWr)rYrZr[r\r]rrrrtrrrrrarrs@rrrsI  #++:>>r!r) metaclass)rr)0r] __future__rr^typingrrrrrr r r r lxmlr lxml.etreerrdocx.oxml.exceptionsr docx.oxml.nsrrr docx.sharedrdocx.enum.baserdocx.oxml.simpletypesrr r&rrbtyperdryrirjrr;rgrhrkrlrmrrUr!rrsF"    ,088$*4:):)z T]7d7$(<(e''?5>r!