*hrcSrSSKJr SSKrSSKJrJrJrJrJ r J r SSK J r SSK JrJr 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_CHECKINGAnyCallableSequenceTypeTypeVar)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 O/home/mande/repo/quber/.venv/lib/python3.13/site-packages/docx/oxml/xmlchemy.pyserialize_for_readingrs ..94 HC S>cx\rSrSrSr\R "S5rS SjrS Sjr S Sjr S Sjr \ SSj5r S rg )rzYProvides 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__+sk%%%!&&( u:[) ) #E 7 D$$T66!8rc.URU5(+$N)r.)r(r)s r__ne__XmlString.__ne__7s;;u%%%rcXUR5nUR5n[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_seq:s%  ;;=hrcURU5up4pVURU5upxpX7:wagURU5URU5:wagXY:wagXj:H$)zRReturn True if the element in `line_2` is XML equivalent to the element in `line`.F) _parse_liner:) r(r,line_2frontr8closetextfront_2attrs_2close_2text_2s rr'XmlString._eq_elm_strsCse%)$4$4T$:!e,0,<,>% DNN7$; ;  ~rcURRU5nUcg[SS5Vs/sHo2RU5PM snupEpgXEXg4$s snf)zI(front, attrs, close, text) 4-tuple result of parsing XML element `line`.)rHrHrH)_xml_elm_line_pattmatchrangegroup)clsr,rLnr?r8r@rAs rr=XmlString._parse_linePsX&&,,T2 =!=B1a[$I[[[^[$I!eU((%JsAN)r)objectreturnbool)r8r#rTz list[str])r,r#r>r#)r,r#rTztuple[str, str, str, str])__name__ __module__ __qualname____firstlineno____doc__recompilerKr.r2r:r' classmethodr=__static_attributes__rRrrrrsA$PQ &  ))rr_Tc"\rSrSrSrSSjrSrg)MetaOxmlElement]zMetaclass for BaseOxmlElement.c[[[[[[ [ 4nUR5H(upV[Xd5(dMURX5 M* gr1) OneAndOnlyOne OneOrMoreOptionalAttributeRequiredAttribute ZeroOrMore ZeroOrOneZeroOrOneChoiceitemsr"populate_class_members)rOclsnamebases namespace dispatchablekeyvalues r__init__MetaOxmlElement.__init__`sL        $//+JC%..,,S6,rrRN)rmr#rnztuple[type, ...]rozdict[str, Any])rVrWrXrYrZrsr^rRrrrara]s ( 7rrac|^\rSrSrSrS U4SjjrS SjrSr\S5r \S Sj5r \S Sj5r S r U=r $) BaseAttributeozRBase class for OptionalAttribute and RequiredAttribute. Provides common methods. cB>[[U] 5 XlX lgr1)superrvrs _attr_name _simple_type)r( attr_name simple_type __class__s rrsBaseAttribute.__init__us mT+-#'rc<XlX lUR5 gz-Add the appropriate methods to `element_cls`.N) _element_cls _prop_name_add_attr_propertyr( element_cls prop_names rrl$BaseAttribute.populate_class_memberszs'# !rc[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>rcdSUR;a[UR5$UR$)N:)rzrr(s r _clark_nameBaseAttribute._clark_names' $// !doo& &rcgr1rRrs rrBaseAttribute._gettersBErcgr1rRrs rrBaseAttribute._setters9[[U] X5 X0lgr1)ryrfrs_default)r(r|r}defaultr~s rrsOptionalAttribute.__init__s / G rcNURRSURS3$)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{rVrzrs r _docstringOptionalAttribute._docstrings4  ))*+//"#9 : rcB^SU4SjjnTRUlU$)zJFunction suitable for `__get__()` method on attribute property descriptor.c>URTR5nUc TR$TRR U5$r1)getrrr{from_xmlobjattr_str_valuer(s rget_attr_value1OptionalAttribute._getter..get_attr_values@!WWT%5%56N%}}$$$--n= =rrBaseOxmlElementrT Any | NonerrZr(rs` rrOptionalAttribute._getters,  >  >  >"&rc^SU4SjjnU$)zJFunction suitable for `__set__()` method on attribute property descriptor.ch>UbUTR:Xa2TRUR;aURTR gTRR U5nUc2TRUR;aURTR gUR TRU5 gr1)rrattribr{to_xmlsetrrr str_valuer(s rset_attr_value1OptionalAttribute._setter..set_attr_values} 6##szz1 4#3#34))007I ##szz1 4#3#34 GGD$$i 0r)rrrrrrRr(rs` rrOptionalAttribute._setters 1r)rr1)r|r#r}rrz0BaseXmlEnum | BaseSimpleType | str | bool | NonerrTz&Callable[[BaseOxmlElement, Any], None]) rVrWrXrYrZrsrrrrr^rrs@rrfrfszEI   > B      0 rrfcP\rSrSrSr\S5r\SSj5r\S Sj5rSr g) rgaDefines 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  rc:^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 )rrr rztagr{rrs rr1RequiredAttribute._getter..get_attr_valuesV WWT%5%56N%%KO??\_\c\cd$$--n= =rrrrs` rrRequiredAttribute._getters >"&rc^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_valuesH))007I  >%8S!TUU GGD$$i 0r)rrrrrrRrs` rrRequiredAttribute._setters 1 rrRN)rTz Callable[[BaseOxmlElement], Any]r) rVrWrXrYrZrrrrr^rRrrrgrgsC      rrgc^\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 lgr1)ryrrs _nsptagname _successors)r( nsptagname successorsr~s rrs_BaseChildElement.__init__s /1%%rcXlX lg)zFBaseline behavior for adding the appropriate methods to `element_cls`.N)rrrs rrl(_BaseChildElement.populate_class_memberss '#rcv^SU4SjjnSTR-UlTRTRU5 g)zGAdd an ``_add_x()`` method to the element class for this child element.c>[UTR5nU"5nUR5HupE[X4U5 M [UTR5nU"U5 U$r1)getattr_new_method_namerkr_insert_method_name)rr8 new_methodchildrqrr insert_methodr(s r _add_child0_BaseChildElement._add_adder.._add_childsW d&;&;`` child element unconditionally, inserted in the correct sequence.N)rrr8r)rrZ _add_to_class_add_method_name)r(rs` r _add_adder_BaseChildElement._add_adders;  #%)%5%5 6  400*=rc|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)_creatorrrZrr)r(creators r _add_creator_BaseChildElement._add_creator+s?-- (*.*:*: ;  400':rct[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_getter5s,T\\46 !!4??I>rcv^SU4SjjnSTR-UlTRTRU5 g)zJAdd an ``_insert_x()`` method to the element class for this child element.cB>UR"U/TRQ76 U$r1)insert_element_beforerrrr(s r _insert_child6_BaseChildElement._add_inserter.._insert_child?s!  % %e ?d.>.> ?LrzYReturn the passed ``<%s>`` element after inserting it as a child in the correct sequence.N)rrrr)rrZrr)r(rs` r _add_inserter_BaseChildElement._add_inserter<s;   )+/+;+; <  433]Crc|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_getterIs6t. T..d; !!98rc SUR-$)Nz_add_%srrs rr"_BaseChildElement._add_method_nameP4??**rcv^SU4SjjnSTR-UlTRTRU5 g)z[UTR5nU"5nU$r1)rr)rprivate_add_methodrr(s r add_child6_BaseChildElement._add_public_adder..add_childWs#!(d.C.C!D &(ELrrNrr)rrZr_public_add_method_name)r(rs` r_add_public_adder#_BaseChildElement._add_public_adderTs;   #%)%5%5 6  477Crch[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_classbs* 4$$d + + !!40rc(^^SSKJm SUU4SjjnU$)zHCallable that creates an empty element of the right type, with no attrs.r) OxmlElementc(>T"TR5$r1r)rrr(s rnew_child_element5_BaseChildElement._creator..new_child_elementnst//0 0rr )docx.oxml.parserr)r(rrs` @rr_BaseChildElement._creatoris 1 1 1! rc@^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$r1)findrrrr(s rget_child_element4_BaseChildElement._getter..get_child_element|s88Bt//01 1rz0``<%s>`` child element or |None| if not present.r rrZr(rs` rr_BaseChildElement._getterss( 2 ?AQAQ Q !! rc SUR-$)Nz _insert_%srrs rr%_BaseChildElement._insert_method_namedoo--rc@^SU4SjjnSTR-UlU$)zSReturn a function object suitable for the "get" side of a list property descriptor.cL>UR[TR55$r1)findallrrrs rget_child_element_list>_BaseChildElement._list_getter..get_child_element_lists;;r$"2"234 4rzPA 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 &&%rc 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$//))rc SUR-$Nz _remove_%srrs r_remove_method_name%_BaseChildElement._remove_method_namer&rc SUR-$)Nz_new_%srrs rr"_BaseChildElement._new_method_namerr)rrrrrR)rr#rtuple[str, ...]r)rr#rzCallable[..., Any])rTz,Callable[[BaseOxmlElement], BaseOxmlElement])rVrWrXrYrZrsrlrrrrrrrr rrrrrrr r1rr^rrs@rrrs && $ >$;? D9++ D1!!!! .. & &**..++rrcx\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$r1rrs rrChoice.nsptagnamesrcXlX lX0lUR5 UR 5 UR 5 UR 5 UR5 gr)r_group_prop_namerrrrr_add_get_or_change_to_method)r(rgroup_prop_namers rrlChoice.populate_class_memberssP( /%     ))+rcv^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$r1)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 )rrZr_get_or_change_to_method_name)r(rEs` rr=#Choice._add_get_or_change_to_methods;  U   *& 4==?UVrcSUR;aURRS5S-OSnURUS$)zDProperty name computed from tag name, e.g. a:schemeClr -> schemeClr.rrIrN)rindex)r(starts rrChoice._prop_namesB47$:J:J3J  &&s+a/PQ''rc SUR-$)Nzget_or_change_to_%srrs rrG$Choice._get_or_change_to_method_names$t66rc SUR-$r0)r<rs rrB Choice._remove_group_method_namesd3333r)rr<rN)rrar>r#rr6rTr)rVrWrXrYrZrrrlr=rrrGrBr^rRrrr8r8s`   ,$,,$ ,  ,"W&(( 7744rr8cP^\rSrSrSrSU4SjjrSU4Sjjr\S5rSr U=r $) rdiz5Defines a required child element for MetaOxmlElement.c.>[[U] US5 g)NrR)ryrdrs)r(rr~s rrsOneAndOnlyOne.__init__s mT+J;rcL>[[U] X5 UR5 gr)ryrdrlrr(rrr~s rrl$OneAndOnlyOne.populate_class_memberss mT9+Q rc@^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)rrrr rs rr0OneAndOnlyOne._getter..get_child_elementsCHHR 0 012E}%ADDTDTTLrz Required ``<%s>`` child element.r r!r"s` rrOneAndOnlyOne._getters%  %GIYIY$Y!  rrR)rr#r) rVrWrXrYrZrsrlrrr^rrs@rrdrds$?<  ! !rrdc0^\rSrSrSrSU4SjjrSrU=r$)reizUDefines 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) ryrerlrrrrr delattrrUs rrl OneOrMore.populate_class_memberssT i5kM       'rrRrrVrWrXrYrZrlr^rrs@rreres ((rrec0^\rSrSrSrSU4SjjrSrU=r$)rhiz@Defines an optional repeating child element for MetaOxmlElement.c>[[U] X5 UR5 UR 5 UR 5 UR 5 UR5 [X5 gr) ryrhrlrrrrr r^rUs rrl!ZeroOrMore.populate_class_memberssT j$6{N       'rrRrr`rs@rrhrhsJ((rrhcL^\rSrSrSrSU4SjjrSrSr\S5r Sr U=r $) riiz6Defines an optional child element for MetaOxmlElement.c>[[U] X5 UR5 UR 5 UR 5 UR 5 UR5 UR5 gr) ryrirlrrrr_add_get_or_adder _add_removerrUs rrl ZeroOrOne.populate_class_memberssX i5kM       rcv^SU4SjjnSTR-UlTRTRU5 g)zLAdd a ``get_or_add_x()`` method to the element class for this child element.ct>[UTR5nUc[UTR5nU"5nU$r1)rrr)rrrDr(s rget_or_add_child5ZeroOrOne._add_get_or_adder..get_or_add_child-s6C1E}$S$*?*?@ " Lrz>Return the ``<%s>`` child element, newly added if not present.Nr )rrZr_get_or_add_method_name)r(rks` rrfZeroOrOne._add_get_or_adder)s;  M   $  4779IJrcv^SU4SjjnSTR-UlTRTRU5 g)zIAdd a ``_remove_x()`` method to the element class for this child element.c<>URTR5 gr1) remove_allrrs r _remove_child-ZeroOrOne._add_remover.._remove_child<s NN4++ ,rz#Remove all ``<%s>`` child elements.Nr )rrZrr1)r(rrs` rrgZeroOrOne._add_remover9s4 -"G$JZJZ Z  433]Crc SUR-$)Nz get_or_add_%srrs rrm!ZeroOrOne._get_or_add_method_nameBs00rrRr) rVrWrXrYrZrlrfrgrrmr^rrs@rriris+@K D11rricz^\rSrSrSrS S SjjrS U4SjjrSrSr\ S5r \ S5r \ S 5r S rU=r$)rjiGzaCorrespondes to an ``EG_*`` element group where at most one of its members may appear as a child.cXlX lgr1_choicesr)r(choicesrs rrsZeroOrOneChoice.__init__Ks  %rc>[[U] X5 UR5 URH)nURXR UR 5 M+ UR5 gr)ryrjrl_add_choice_getterrzrr_add_group_remover)r(rrchoicer~s rrl&ZeroOrOneChoice.populate_class_membersOsR ot;KS !mmF  ) )+HXHX Y$ !rct[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_getterWs.T00$= !!4??I>rc\^SU4SjjnSUlTRTRU5 g)zKAdd a ``_remove_eg_x()`` method to the element class for this choice group.cN>TRHnURU5 M gr1)_member_nsptagnamesrq)rtagnamer(s r_remove_choice_group@ZeroOrOneChoice._add_group_remover.._remove_choice_groupbs33w'4rz9Remove the current choice group child element if present.Nr )rZr _remove_choice_group_method_name)r(rs` rr"ZeroOrOneChoice._add_group_remover^s+ ((c$ 4@@BVWrc&^SU4SjjnSUlU$)rXc6>UR"TR6$r1)first_child_found_inrrs rget_group_member_element@ZeroOrOneChoice._choice_getter..get_group_member_elementns++T-E-EF FrzbReturn the child element belonging to this element group, or |None| if no member child is present.r )rZ)r(rs` rrZeroOrOneChoice._choice_getteris  G 4 !(('rcXURVs/sHoRPM sn$s snf)zbSequence of namespace-prefixed tagnames, one for each of the member elements of this choice group.)rzr)r(rs rr#ZeroOrOneChoice._member_nsptagnamesws$15 > f!! >>>s'c SUR-$r0rrs rr0ZeroOrOneChoice._remove_choice_group_method_name}r&rryr5)r{zSequence[Choice]rr6r)rVrWrXrYrZrsrlr~rrrrrrr^rrs@rrjrjGsY&"? X ( (?? ..rrjc|^\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>)r~rV_nsptagidrs r__repr__BaseOxmlElement.__repr__s/% NN # # LL tH)   rcXUH$nUR[U55nUcM"Us $ g)z9First child with tag in `tagnames`, or None if not found.N)rr)r(tagnamesrrs rr$BaseOxmlElement.first_child_found_ins.GIIbk*E   rcrUR"U6nUbURU5 U$URU5 U$r1)r addpreviousappend)r(elmr successors rr%BaseOxmlElement.insert_element_befores@--x8   ! !# &  KK  rc~UH7nUR[U55nUHnURU5 M M9 g)z>Remove child elements with tagname (e.g. "a:p") in `tagnames`.N)r)rremove)r(rrmatchingrs rrqBaseOxmlElement.remove_alls4G||BwK0H! E"" rc[U5$)zXML string for this element, suitable for testing purposes. Pretty printed for readability and without an XML declaration at the top. )rrs rrBaseOxmlElement.xmls %T**rc(>[TU]U[S9$)z}Override of `lxml` _Element.xpath() method. Provides standard Open XML namespace mapping (`nsmap`) in centralized location. ) namespaces)ryxpathr)r( xpath_strr~s rrBaseOxmlElement.xpaths w}Y5}99rcB[R"UR5$r1)rfrom_clark_namerrs rrBaseOxmlElement._nsptags#33DHH==rrR)rr#rTz_Element | None)rr rr#)rr#rTr)rTr#)rr#rTr)rVrWrXrYrZrrrrqrrrrr^rrs@rrrsI  #++:>>rr) metaclass)rr )-rZ __future__rr[typingrrrrrr lxmlr lxml.etreer r docx.oxml.exceptionsr docx.oxml.nsrrr docx.sharedrdocx.enum.baserdocx.oxml.simpletypesrrr#rr_typerarvrfrgrr8rdrerhrirjrrRrrrsF" HH,088$*48)8)v T]7d7$(<(e''?5>r