*h!iSrSSKJr SSKrSSKJrJrJrJrJ r J r J r SSK J r SSKJrJr SSKJr SSKJr SS KJrJrJr SS KJr "S S \5rS*S+SjjrS,Sjr"SS\5r"SS\ 5r!"SS5r""SS\"5r#"SS\"5r$"SS5r%"SS\%5r&"SS\%5r'"S S!\%5r("S"S#\%5r)"S$S%\%5r*"S&S'\%5r+"S(S \ R\!S)9r,g)-zPBase and meta classes enabling declarative definition of custom element classes.) annotationsN)AnyCallableIterableProtocolSequenceTypecast)etree) ElementBase_Element)InvalidXmlError) oxml_parser)NamespacePrefixedTag_nsmapqn) lazypropertyc@\rSrSrSr\SSj5r\SSj5rSrg) AttributeTypezInterface for an object that can act as an attribute type. An attribute-type specifies how values are transformed to and from the XML "string" value of the attribute. cg)z/Transform an attribute value to a Python value.N)cls xml_values O/home/mande/repo/quber/.venv/lib/python3.13/site-packages/pptx/oxml/xmlchemy.pyfrom_xmlAttributeType.from_xml cg)zGTransform a Python value to a str value suitable to this XML attribute.Nr)rvalues rto_xmlAttributeType.to_xmlrrrN)rstrreturnr)r!rr%r$) __name__ __module__ __qualname____firstlineno____doc__ classmethodrr"__static_attributes__rrrrrs/     rrBaseOxmlElementcx[U5nUbUO URn[R"URUS9$)zReturn a "loose" lxml element having the tag specified by `nsptag_str`. `nsptag_str` must contain the standard namespace prefix, e.g. 'a:tbl'. The resulting element is an instance of the custom element class for this tag name if one is defined. )nsmap)rr/r makeelement clark_name) nsptag_strr/nsptags r OxmlElementr4#s7 "* -F&EFLLE  " "6#4#4E BBrcD[R"USSS9n[U5$)zS Serialize *element* to human-readable XML suitable for tests. No XML declaration. unicodeT)encoding pretty_print)r tostring XmlString)elementxmls rserialize_for_readingr=.s ..94 HC S>rcn\rSrSrSr\R "S5rS SjrS Sjr S Sjr S Sjr SSjr S r g )r:7zRProvides string comparison override suitable for serialized XML; useful for tests.z(( *)([^<]*)?c[U[5(dgUR5nUR5n[U5[U5:wag[ X#5HupEUR XE5(aM g g)NFT) isinstancer$ splitlineslenzip _eq_elm_strs)selfotherlines lines_otherline line_others r__eq__XmlString.__eq__Bsk%%%!&&( u:[) ) #E 7 D$$T66!8rc.URU5(+$N)rL)rFrGs r__ne__XmlString.__ne__Ns;;u%%%rcXUR5nUR5n[U5$)z{Return a sequence of attribute strings parsed from *attrs*. Each attribute string is stripped of whitespace on both ends. )stripsplitsorted)rFattrsattr_lsts r _attr_seqXmlString._attr_seqQs%  ;;=hrcURU5up4pVURU5upxpX7:wagURU5URU5:wagXY:wagXj:wagg)zTrue if the element in `line_2` is XML-equivalent to the element in `line`. In particular, the order of attributes in XML is not significant. FT) _parse_linerX) rFrJline_2frontrVclosetextfront_2attrs_2close_2text_2s rrEXmlString._eq_elm_strsZsh %)$4$4T$:!e,0,<,>% DNN7$; ;   >rcURRU5nUc [S5e[SS5Vs/sHo2R U5PM snupEpgXEXg4$s snf)zUReturn front, attrs, close, text 4-tuple result of parsing XML element string `line`.z0`line` does not match pattern for an XML element)_xml_elm_line_pattmatch ValueErrorrangegroup)rFrJrinr]rVr^r_s rr[XmlString._parse_lineks_''--d3 =OP P=B1a[$I[[[^[$I!eU((%JsArN)rGobjectr%bool)rVr$r% list[str])rJr$r\r$r%rp)rJr$)r&r'r(r)r*recompilerhrLrPrXrEr[r,rrrr:r:7s0\$OP & ")rr:c"\rSrSrSrSSjrSrg)MetaOxmlElementtzMetaclass for BaseOxmlElement.c[[[[[[ [ 4nUR5H(upV[Xd5(dMURX5 M* grO) OneAndOnlyOne OneOrMoreOptionalAttributeRequiredAttribute ZeroOrMore ZeroOrOneZeroOrOneChoiceitemsrApopulate_class_members)rclsnamebasesclsdict dispatchablekeyr!s r__init__MetaOxmlElement.__init__wsK        "--/JC%..,,S6*rrN)rr$rztuple[type, ...]rzdict[str, Any])r&r'r(r)r*rr,rrrruruts ( 7rrucj\rSrSrSrS SjrS SjrSr\S5r \S Sj5r \SSj5r S r g ) BaseAttributezQBase class for OptionalAttribute and RequiredAttribute, providing common methods.cXlX lgrO) _attr_name _simple_type)rF attr_name simple_types rrBaseAttribute.__init__s #'rc<XlX lUR5 gz/ Add the appropriate methods to *element_cls*. N) _element_cls _prop_name_add_attr_propertyrF element_cls prop_names rr$BaseAttribute.populate_class_memberss(# !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_settersetattrrrrF property_s rr BaseAttribute._add_attr_propertys0 T\\4<<> !!4??I>rcdSUR;a[UR5$UR$)N:)rrrFs r _clark_nameBaseAttribute._clark_names' $// !doo& &rc[S5e)JCallable suitable for the "get" side of the attribute property descriptor.$must be implemented by each subclassNotImplementedErrorrs rrBaseAttribute._getter""HIIrc[S5e)JCallable suitable for the "set" side of the attribute property descriptor.rrrs rrBaseAttribute._setterrr)rrrrN)rr$rtype[AttributeType]rType[BaseOxmlElement]rr$r%z Callable[[BaseOxmlElement], Any]r%z&Callable[[BaseOxmlElement, Any], None]) r&r'r(r)r*rrrrrrrr,rrrrrsT[("? JJJJrrcl^\rSrSrSrSS U4Sjjjr\S5r\S Sj5r\S Sj5r Sr U=r $) rzzDefines 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. c8>[[U] X5 X0lgrO)superrzr_default)rFrrdefault __class__s rrOptionalAttribute.__init__s / G rcRURR<SUR<S3$)[ Return the string to use as the ``__doc__`` attribute of the property for this attribute.  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.rr&rrs r _docstringOptionalAttribute._docstrings#  ))4?? < rc:^SU4SjjnTRUlU$)rc>URTR5nUc TR$TRR U5$rO)getrrrrobjattr_str_valuerFs rget_attr_value1OptionalAttribute._getter..get_attr_values> WWT%5%56N%}}$$$--n= =rrr-r%rrr*rFrs` rrOptionalAttribute._getters > "&rc^SU4SjjnU$)rc>UTR:Xa2TRUR;aURTR gTRR U5nUR TRU5 grO)rrattribrr"setrr! str_valuerFs rset_attr_value1OptionalAttribute._setter..set_attr_valuesb %##szz1 4#3#34))007I GGD$$i 0rrr-r!rr%NonerrFrs` rrOptionalAttribute._setters 1r)rrO)rr$rrrrrr) r&r'r(r)r*rrrrrr, __classcell__rs@rrzrzsN           rrzcP\rSrSrSr\SSj5r\S5r\S Sj5rSr g) r{aDefines 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. c:^SU4SjjnTRUlU$)rc>URTR5nUc'[STR<SUR<35eTR R U5$)Nz required 'z#' attribute not present on element )rrrrtagrrrs rr1RequiredAttribute._getter..get_attr_valuesV WWT%5%56N%%KO??\_\c\cd$$--n= =rrrrs` rrRequiredAttribute._getters >"&rcRURR<SUR<S3$)rrz `` attribute.rrs rrRequiredAttribute._docstrings$    & & OO  rc^SU4SjjnU$)rct>TRRU5nURTRU5 grO)rr"rrrs rr1RequiredAttribute._setter..set_attr_values-))007I GGD$$i 0rrrrs` rrRequiredAttribute._setter s 1rrNrr) r&r'r(r)r*rrrrr,rrrr{r{sC    rr{c^\rSrSrSrSSU4SjjjrSSjrSrSrSr Sr S r \ S 5r SS jr\SS j5r\SS j5r\ S5r\SSj5r\ S5r\ S5rSrU=r$)_BaseChildElementizBase class for the child element classes corresponding to varying cardinalities. Subclasses include ZeroOrOne and ZeroOrMore. cB>[[U] 5 XlX lgrO)rrr _nsptagname _successors)rF nsptagname successorsrs rr_BaseChildElement.__init__s /1%%rcXlX lg)zFBaseline behavior for adding the appropriate methods to `element_cls`.N)rrrs rr(_BaseChildElement.populate_class_members s '#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$rO)getattr_new_method_namerr_insert_method_name)rrV new_methodchildrr! insert_methodrFs r _add_child0_BaseChildElement._add_adder.._add_child(sW d&;&;`` child element unconditionally, inserted in the correct sequence.N)rr-rVr)rr* _add_to_class_add_method_name)rFrs` r _add_adder_BaseChildElement._add_adder%s;  #%)%5%5 6  400*=rc|URnSUR-UlURURU5 g)zAdd a `_new_{prop_name}()` method to the element class. This method 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)rFcreators r _add_creator_BaseChildElement._add_creator7s? -- (*.*:*: ;  400':rct[URSS5n[URURU5 g)zAdd a read-only `{prop_name}` property to the parent element class. The property locates and returns this child element or `None` if not present. N)rrrrrrs r _add_getter_BaseChildElement._add_getterCs, 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$rO)insert_element_beforerrrrFs r _insert_child6_BaseChildElement._add_inserter.._insert_childOs!  % %e ?d.>.> ?LrzYReturn the passed ``<%s>`` element after inserting it as a child in the correct sequence.N)rr-rr-)rr*rr)rFrs` r _add_inserter_BaseChildElement._add_inserterLs;   )+/+;+; <  433]Crc|URS3n[URSS5n[URX5 g)z| Add a read-only ``{prop_name}_lst`` property to the element class to retrieve a list of child elements matching this type. _lstN)rr _list_getterrr)rFrrs r_add_list_getter"_BaseChildElement._add_list_getterYs9 't, T..d; !!98rc SUR-$)Nz_add_%srrs rr"_BaseChildElement._add_method_nameb4??**rch[URU5(ag[URX5 g)zSAdd `method` to the target class as `name`, unless `name` is already defined there.N)hasattrrr)rFnamemethods rr_BaseChildElement._add_to_classfs( 4$$d + + !!40rc^SU4SjjnU$)zSCallable that creates a new, empty element of the child type, having no attributes.c.>[TR5$rO)r4rrrFs rnew_child_element5_BaseChildElement._creator..new_child_elementpst//0 0rrr-r)rFr%s` rr_BaseChildElement._creatorls 1! rc@^SU4SjjnSTR-UlU$)zCallable 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$rO)findrrr$s rget_child_element4_BaseChildElement._getter..get_child_element}s88Bt//01 1rz0``<%s>`` child element or |None| if not present.rr-r%BaseOxmlElement | Nonerr*rFr,s` rr_BaseChildElement._getterus( 2 ?AQAQ Q !! rc SUR-$)Nz _insert_%srrs rr%_BaseChildElement._insert_method_namedoo--rc@^SU4SjjnSTR-UlU$)zCCallable suitable for the "get" side of a list property descriptor.c`>[SUR[TR555$)Nlist[BaseOxmlElement])r findallrrr$s rget_child_element_list>_BaseChildElement._list_getter..get_child_element_lists%/R@P@P=Q1RS SrzPA list containing each of the ``<%s>`` child elements, in the order they appear.)rr-r%r8r0)rFr:s` rr_BaseChildElement._list_getters, T "&"2"2 3 &&%rc SUR-$Nz _remove_%srrs r_remove_method_name%_BaseChildElement._remove_method_namer5rc SUR-$)Nz_new_%srrs rr"_BaseChildElement._new_method_namerr)rrrrr)rr$r Sequence[str]r)rr$r zCallable[..., Any]r%z,Callable[[BaseOxmlElement], BaseOxmlElement])r%z3Callable[[BaseOxmlElement], BaseOxmlElement | None])r%z2Callable[[BaseOxmlElement], list[BaseOxmlElement]])r&r'r(r)r*rrrrr rrrrrrrrrrr?rr,rrs@rrrs && $ >$ ;? D9++1 !! ! !.. & &..++rrcx\rSrSrSr\S5rS SjrS Sjr\S5r \ S5r \ S5r S r g ) ChoiceizVDefines a child element belonging to a group, only one of which may appear as a child.cUR$rO)rrs rrChoice.nsptagnamesrcXlX lX0lUR5 UR 5 UR 5 UR 5 UR5 gz-Add the appropriate methods to `element_cls`.N)r_group_prop_namerr rrr_add_get_or_change_to_method)rFrgroup_prop_namers rrChoice.populate_class_memberssP( /%     ))+rcv^SU4SjjnSTR-UlTRTRU5 g)zPAdd a `get_or_change_to_x()` method to the element class for this child element.c>[UTR5nUbU$[UTR5nU"5 [UTR5nU"5nU$rO)rr_remove_group_method_namer)rrremove_group_method add_methodrFs 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)rFrUs` rrM#Choice._add_get_or_change_to_methods;  X   *& 4==?UVrcSUR;aURRS5S-nOSnURUS$)zG Calculate property name from tag name, e.g. a:schemeClr -> schemeClr. rrfrN)rindex)rFstarts rrChoice._prop_namesE $"" "$$**3/!3EE''rc SUR-$)Nzget_or_change_to_%srrs rrW$Choice._get_or_change_to_method_names$t66rc SUR-$r>)rLrs rrR Choice._remove_group_method_namesd3333r)rrLrN)rrrNr$rrDr%r)r&r'r(r)r*rrrrMrrrWrRr,rrrrGrGsv`    ,0 ,CF ,Ta ,W$((7744rrGcT^\rSrSrSrSU4SjjrSU4Sjjr\S Sj5rSr U=r $) rxiz5Defines a required child element for MetaOxmlElement.c.>[[U] US5 g)Nr)rrxr)rFrrs rrOneAndOnlyOne.__init__s mT+J;rcL>[[U] X5 UR5 gr)rrxrr rFrrrs rr$OneAndOnlyOne.populate_class_memberss  mT9+Q rc@^SU4SjjnSTR-UlU$)z@Callable 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}%ADDTDTTLrz Required ``<%s>`` child element.rr-r%r-r0r1s` rrOneAndOnlyOne._getters% %GIYIY$Y!  rr)rr$rrE) r&r'r(r)r*rrrrr,rrs@rrxrxs$?< ! !rrxcJ^\rSrSrSrSU4SjjrSSjr\S5rSr U=r $) ryizUDefines a repeating child element for MetaOxmlElement that must appear at least once.c>[[U] X5 UR5 UR 5 UR 5 UR 5 UR5 [X5 g)z-Add the appropriate methods to *element_cls*.N) rryrrrrr_add_public_adderdelattrrfs rr OneOrMore.populate_class_memberssT i5kM       'rcv^SU4SjjnSTR-UlTRTRU5 g)z;Add a public `.add_x()` method to the parent element class.cB>[UTR5nU"5nU$rO)rr)rprivate_add_methodrrFs r add_child.OneOrMore._add_public_adder..add_childs#!(d.C.C!D &(ELrrNrk)rr*r_public_add_method_name)rFrus` rroOneOrMore._add_public_adders;   #%)%5%5 6  477Crc SUR-$)z 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_%srrs rrw!OneOrMore._public_add_method_names$//))rrrra) r&r'r(r)r*rrorrwr,rrs@rryrys%_( D**rryc0^\rSrSrSrSU4SjjrSrU=r$)r|izB Defines an optional repeating child element for MetaOxmlElement. c>[[U] X5 UR5 UR 5 UR 5 UR 5 [X5 gr)rr|rrrrrrprfs rr!ZeroOrMore.populate_class_members"sJ j$6{N     'rrr)r&r'r(r)r*rr,rrs@rr|r|s ( (rr|cL^\rSrSrSrSU4SjjrSrSr\S5r Sr U=r $) r}i.z6Defines an optional child element for MetaOxmlElement.c>[[U] X5 UR5 UR 5 UR 5 UR 5 UR5 UR5 grK) rr}rr rrr_add_get_or_adder _add_removerrfs rr ZeroOrOne.populate_class_members1sX i5kM       rcv^SU4SjjnSTR-UlTRTRU5 g)zKAdd a `.get_or_add_x()` method to the element class for this child element.ct>[UTR5nUc[UTR5nU"5nU$rO)rrr)rrrTrFs 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.Nrk)rr*r_get_or_add_method_name)rFrs` rrZeroOrOne._add_get_or_adder;s;  M   $  4779IJrcx^SU4SjjnSTRS3UlTRTRU5 g)zHAdd a `._remove_x()` method to the element class for this child element.c<>URTR5 grO) remove_allrr$s r _remove_child-ZeroOrOne._add_remover.._remove_childMs NN4++ ,rz Remove all `z` child elements.Nrr-r%r)rr*rr?)rFrs` rrZeroOrOne._add_removerJs9 -#/t/?/?.@@Q R  433]Crc SUR-$)Nz get_or_add_%srrs rr!ZeroOrOne._get_or_add_method_nameSs00rrr) r&r'r(r)r*rrrrrr,rrs@rr}r}.s+@ KD11rr}c~^\rSrSrSrS S SjjrS U4SjjrSrSr\ S5r \ SSj5r \ S 5r S rU=r$)r~iXzOAn `EG_*` element group where at most one of its members may appear as a child.cD[U5Ul[U5UlgrO)tuple_choicesr)rFchoicesrs rrZeroOrOneChoice.__init__[sg  ,rc>[[U] X5 UR5 URH)nURXR UR 5 M+ UR5 grK)rr~r_add_choice_getterrrr_add_group_remover)rFrrchoicers rr&ZeroOrOneChoice.populate_class_members_sR ot;KS !mmF  ) )+HXHX Y$ !rct[URSS5n[URURU5 g)zAdd a read-only `.{prop_name}` property to the element class. The property returns the present member of this group, or |None| if none are present. N)r_choice_getterrrrrs rr"ZeroOrOneChoice._add_choice_gettergs. T00$= !!4??I>rc\^SU4SjjnSUlTRTRU5 g)zJAdd a `._remove_eg_x()` method to the element class for this choice group.cN>TRHnURU5 M grO)_member_nsptagnamesr)rtagnamerFs r_remove_choice_group@ZeroOrOneChoice._add_group_remover.._remove_choice_groupss33w'4rz9Remove the current choice group child element if present.Nr)r*r _remove_choice_group_method_name)rFrs` rr"ZeroOrOneChoice._add_group_removerps+ ((c$ 4@@BVWrc&^SU4SjjnSUlU$)zR Return a function object suitable for the "get" side of the property descriptor. cJ>[SUR"TR65$)Nr/)r first_child_found_inrr$s rget_group_member_element@ZeroOrOneChoice._choice_getter..get_group_member_elements&(#*B*BDD\D\*] rzbReturn the child element belonging to this element group, or |None| if no member child is present.r.)r*)rFrs` rrZeroOrOneChoice._choice_getterzs   4 !(('rcXURVs/sHoRPM sn$s snf)zUSequence of namespace-prefixed tagnames, one for each member element of choice group.)rr)rFrs rr#ZeroOrOneChoice._member_nsptagnamess$15 > f!! >>>s'c SUR3$)z!Function-name for choice remover._remove_rrs rr0ZeroOrOneChoice._remove_choice_group_method_names$//*++r)rrrC)rzIterable[Choice]rz Iterable[str]r)r%rq)r&r'r(r)r*rrrrrrrrrr,rrs@rr~r~XsWY-"?X(("??,,rr~c|^\rSrSrSrSrS SjrS SjrS Sjr\ SSj5r SU4Sjjr \ SS j5r S r U=r$)r-iznEffective 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>)rr&_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)r+r)rFtagnamesrrs rr$BaseOxmlElement.first_child_found_ins.GIIbk*E   rcrUR"U6nUbURU5 U$URU5 U$rO)r addpreviousappend)rFelmr 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)r9rremove)rFrrmatchingrs rrBaseOxmlElement.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. )r=rs rr<BaseOxmlElement.xmls %T**rc(>[TU]U[S9$)z}Override of `lxml` _Element.xpath() method. Provides standard Open XML namespace mapping (`nsmap`) in centralized location. ) namespaces)rxpathr)rF xpath_strrs rrBaseOxmlElement.xpaths w}Y6}::rcB[R"UR5$rO)rfrom_clark_namerrs rrBaseOxmlElement._nsptags#33DHH==rr)rr$r%z_Element | None)rr rr$)rr$r%r)r%r$)rr$r%r)r&r'r(r)r*rrrrrr<rrr,rrs@rr-r-sI  #++;>>r) metaclassrO)r2r$r/zdict[str, str] | Noner%r-)r;r )-r* __future__rrrtypingrrrrrr r lxmlr lxml.etreer r pptx.excr pptx.oxmlr pptx.oxml.nsrrr pptx.utilrrr4r=r$r:typerurrzr{rrGrxryr|r}r~r-rrrrsV" JJJ,$!99" H $C:):)z7d7$(J(JV3 3l+ +\G+G+T84 84v!%!:#*!#*L("("'1!'1T<,'<,@5>e''?5>r