li!idZddlmZddlZddlmZmZmZmZm Z m Z m Z ddl m Z ddlmZmZddlmZddlmZdd lmZmZmZdd lmZGd d eZd*d+dZd,dZGddeZGdde Z!GddZ"Gdde"Z#Gdde"Z$GddZ%Gdde%Z&Gdde%Z'Gd d!e%Z(Gd"d#e%Z)Gd$d%e%Z*Gd&d'e%Z+Gd(d e je!)Z,y)-zPBase and meta classes enabling declarative definition of custom element classes.) annotationsN)AnyCallableIterableProtocolSequenceTypecast)etree) ElementBase_Element)InvalidXmlError) oxml_parser)NamespacePrefixedTag_nsmapqn) lazypropertyc4eZdZdZeddZeddZy) 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. cy)z/Transform an attribute value to a Python value.N)cls xml_values P/var/www/html/eduruby.in/venv/lib/python3.12/site-packages/pptx/oxml/xmlchemy.pyfrom_xmlzAttributeType.from_xml cy)zGTransform a Python value to a str value suitable to this XML attribute.Nr)rvalues rto_xmlzAttributeType.to_xmlrrN)rstrreturnr)rrr"r!)__name__ __module__ __qualname____doc__ classmethodrr rrrrrs/     rrBaseOxmlElementczt|}||n |j}tj|j|S)aReturn 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 OxmlElementr/#s7 "* -F&EFLLE  " "6#4#4E BBrcHtj|dd}t|S)z_ Serialize *element* to human-readable XML suitable for tests. No XML declaration. unicodeT)encoding pretty_print)r tostring XmlString)elementxmls rserialize_for_readingr8.s ..94 HC S>rc\eZdZdZej dZd dZd dZd dZ d dZ d dZ y) r5zRProvides string comparison override suitable for serialized XML; useful for tests.z(( *)([^<]*)?ct|tsy|j}|j}t|t|k7ryt ||D]\}}|j ||ryy)NFT) isinstancer! splitlineslenzip _eq_elm_strs)selfotherlines lines_otherline line_others r__eq__zXmlString.__eq__Bsp%%!&&( u:[) ) #E; 7  D*$$T:6 rc&|j| SN)rF)r@rAs r__ne__zXmlString.__ne__Ns;;u%%%rcX|j}|j}t|S)zReturn a sequence of attribute strings parsed from *attrs*. Each attribute string is stripped of whitespace on both ends. )stripsplitsorted)r@attrsattr_lsts r _attr_seqzXmlString._attr_seqQs%  ;;=hrc|j|\}}}}|j|\}}} } ||k7ry|j||j|k7ry|| k7ry|| k7ryy)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_linerP) r@rDline_2frontrNclosetextfront_2attrs_2close_2text_2s rr?zXmlString._eq_elm_strsZsv %)$4$4T$:!ueT,0,<,>% DNN7$; ; G  6>rc|jj|}| tdtddDcgc]}|j |c}\}}}}||||fScc}w)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)r@rDr_nrTrNrUrVs rrRzXmlString._parse_linekse''--d3 =OP P=B1a[$IU[[^$I!ueTeUD((%JsAN)rAobjectr"bool)rNr!r" list[str])rDr!rSr!r"re)rDr!) r#r$r%r&recompiler^rFrIrPr?rRrrrr5r57s2\$$OP & ")rr5ceZdZdZddZy)MetaOxmlElementzMetaclass for BaseOxmlElement.ctttttt t f}|jD]$\}}t||s|j||&yrH) OneAndOnlyOne OneOrMoreOptionalAttributeRequiredAttribute ZeroOrMore ZeroOrOneZeroOrOneChoiceitemsr;populate_class_members)rclsnamebasesclsdict dispatchablekeyrs r__init__zMetaOxmlElement.__init__wsS        "--/ 7JC%.,,S#6 7rN)rur!rvztuple[type, ...]rwzdict[str, Any])r#r$r%r&rzrrrrjrjts ( 7rrjcZeZdZdZd dZd dZdZedZed dZ ed dZ y) BaseAttributezQBase class for OptionalAttribute and RequiredAttribute, providing common methods.c ||_||_yrH) _attr_name _simple_type)r@ attr_name simple_types rrzzBaseAttribute.__init__s#'rc@||_||_|jyz? Add the appropriate methods to *element_cls*. N) _element_cls _prop_name_add_attr_propertyr@ element_cls prop_names rrtz$BaseAttribute.populate_class_memberss(# !rct|j|jd}t|j|j |y)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 rrz BaseAttribute._add_attr_propertys0 T\\4<<> !!4??I>rc`d|jvrt|jS|jS)N:)r~rr@s r _clark_namezBaseAttribute._clark_names' $// !doo& &rctd)JCallable suitable for the "get" side of the attribute property descriptor.$must be implemented by each subclassNotImplementedErrorrs rrzBaseAttribute._getter""HIIrctd)JCallable suitable for the "set" side of the attribute property descriptor.rrrs rrzBaseAttribute._setterrrN)rr!rtype[AttributeType]rType[BaseOxmlElement]rr!r"z Callable[[BaseOxmlElement], Any]r"z&Callable[[BaseOxmlElement, Any], None]) r#r$r%r&rzrtrrrrrrrrr|r|sT[("? JJJJrr|cZeZdZdZddfd ZedZeddZed dZxZ S) rnzDefines 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. c<tt| ||||_yrH)superrnrz_default)r@rrdefault __class__s rrzzOptionalAttribute.__init__s / ;G rcN|jjd|jdS)s 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#r~rs r _docstringzOptionalAttribute._docstrings#  ))4?? < rc6dfd }j|_|S)rc|jj}| jSjj |SrH)getrrrrobjattr_str_valuer@s rget_attr_valuez1OptionalAttribute._getter..get_attr_values> WWT%5%56N%}}$$$--n= =rrr(r"rrr&r@rs` rrzOptionalAttribute._getters > "&rcdfd }|S)rc|jk(r0j|jvr|jj=yjj |}|j j|yrH)rrattribrr setrr str_valuer@s rset_attr_valuez1OptionalAttribute._setter..set_attr_valuesb %##szz1 4#3#34))007I GGD$$i 0rrr(rrr"Nonerr@rs` rrzOptionalAttribute._setters 1rrH)rr!rrrrrr) r#r$r%r&rzrrrr __classcell__rs@rrnrnsI          rrncDeZdZdZeddZedZeddZy)roaDefines 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. c6dfd }j|_|S)rc|jj}|%tdjd|jj j |S)Nz required 'z#' attribute not present on element )rrrr~tagrrrs rrz1RequiredAttribute._getter..get_attr_valuesV WWT%5%56N%%KO??\_\c\cd$$--n= =rrrrs` rrzRequiredAttribute._getters >"&rcN|jjd|jdS)rrz `` attribute.rrs rrzRequiredAttribute._docstrings$    & & OO  rcdfd }|S)rctjj|}|jj|yrH)rr rrrs rrz1RequiredAttribute._setter..set_attr_values-))007I GGD$$i 0rrrrs` rrzRequiredAttribute._setter s 1rNrr)r#r$r%r&rrrrrrrrorosC    rroceZdZdZddfd ZddZdZdZdZdZ dZ e d Z dd Z edd Zedd Ze d ZeddZe dZe dZxZS)_BaseChildElementzBase class for the child element classes corresponding to varying cardinalities. Subclasses include ZeroOrOne and ZeroOrMore. cFtt| ||_||_yrH)rrrz _nsptagname _successors)r@ nsptagname successorsrs rrzz_BaseChildElement.__init__s! /1%%rc ||_||_y)zFBaseline behavior for adding the appropriate methods to `element_cls`.N)rrrs rrtz(_BaseChildElement.populate_class_members s'#rcrdfd }djz|_jj|y)zGAdd an ``_add_x()`` method to the element class for this child element.ct|j}|}|jD]\}}t|||t|j}|||SrH)getattr_new_method_namersr_insert_method_name)rrN new_methodchildryr insert_methodr@s r _add_childz0_BaseChildElement._add_adder.._add_child(s` d&;&;`` child element unconditionally, inserted in the correct sequence.N)rr(rNr)rr& _add_to_class_add_method_name)r@rs` r _add_adderz_BaseChildElement._add_adder%s;  #%)%5%5 6  400*=rc||j}d|jz|_|j|j|y)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)r@creators r _add_creatorz_BaseChildElement._add_creator7s? -- (*.*:*: ;  400':rctt|jdd}t|j|j|y)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_getterz_BaseChildElement._add_getterCs, T\\46 !!4??I>rcrdfd }djz|_jj|y)zJAdd an ``_insert_x()`` method to the element class for this child element.cB|j|gj|SrH)insert_element_beforerrrr@s r _insert_childz6_BaseChildElement._add_inserter.._insert_childOs# %C % %e ?d.>.> ?LrzYReturn the passed ``<%s>`` element after inserting it as a child in the correct sequence.N)rr(rr()rr&rr)r@rs` r _add_inserterz_BaseChildElement._add_inserterLs;   )+/+;+; <  433]Crc~|jd}t|jdd}t|j||y)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)r@rrs r_add_list_getterz"_BaseChildElement._add_list_getterYs; 't, T..d; !!9i8rc d|jzS)Nz_add_%srrs rrz"_BaseChildElement._add_method_nameb4??**rc`t|j|ryt|j||y)zSAdd `method` to the target class as `name`, unless `name` is already defined there.N)hasattrrr)r@namemethods rrz_BaseChildElement._add_to_classfs' 4$$d + !!40rcdfd }|S)zSCallable that creates a new, empty element of the child type, having no attributes.c.tjSrH)r/rrr@s rnew_child_elementz5_BaseChildElement._creator..new_child_elementpst//0 0rrr(r)r@rs` rrz_BaseChildElement._creatorls 1! rc<dfd }djz|_|S)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|jtjSrH)findrrrs rget_child_elementz4_BaseChildElement._getter..get_child_element}s88Bt//01 1rz0``<%s>`` child element or |None| if not present.rr(r"BaseOxmlElement | Nonerr&r@rs` rrz_BaseChildElement._getterus( 2 ?AQAQ Q !! rc d|jzS)Nz _insert_%srrs rrz%_BaseChildElement._insert_method_namedoo--rc<dfd }djz|_|S)zCCallable suitable for the "get" side of a list property descriptor.c`td|jtjS)Nlist[BaseOxmlElement])r findallrrrs rget_child_element_listz>_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"rr)r@r s` rrz_BaseChildElement._list_getters, T "&"2"2 3 &&%rc d|jzSNz _remove_%srrs r_remove_method_namez%_BaseChildElement._remove_method_namerrc d|jzS)Nz_new_%srrs rrz"_BaseChildElement._new_method_namerrr)rr!r Sequence[str]r)rr!rzCallable[..., Any]r"z,Callable[[BaseOxmlElement], BaseOxmlElement])r"z3Callable[[BaseOxmlElement], BaseOxmlElement | None])r"z2Callable[[BaseOxmlElement], list[BaseOxmlElement]])r#r$r%r&rzrtrrrrrrrrrrrrrr rrrs@rrrs & $ >$ ;? D9++1 !! ! !.. & &..++rrcleZdZdZedZ d dZd dZedZe dZ e dZ y) ChoicezVDefines a child element belonging to a group, only one of which may appear as a child.c|jSrH)rrs rrzChoice.nsptagnamesrc||_||_||_|j|j |j |j |jyz-Add the appropriate methods to `element_cls`.N)r_group_prop_namerrrrr_add_get_or_change_to_method)r@rgroup_prop_namers rrtzChoice.populate_class_memberssV( /%     ))+rcrdfd }djz|_jj|y)zPAdd a `get_or_change_to_x()` method to the element class for this child element.ct|j}||St|j}|t|j}|}|SrH)rr_remove_group_method_namer)rrremove_group_method add_methodr@s rget_or_change_to_childzCChoice._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@rs` rrz#Choice._add_get_or_change_to_methods;  X   *& 4==?UVrc~d|jvr|jjddz}nd}|j|dS)zW Calculate property name from tag name, e.g. a:schemeClr -> schemeClr. rr\rN)rindex)r@starts rrzChoice._prop_namesE $"" "$$**3/!3EE''rc d|jzS)Nzget_or_change_to_%srrs rrz$Choice._get_or_change_to_method_names$t66rc d|jzSr )rrs rrz Choice._remove_group_method_namesd3333rN)rrrr!rrr"r) r#r$r%r&rrrtrrrrrrrrrrsv`    ,0 ,CF ,Ta ,W$((7744rrcBeZdZdZdfd Zdfd ZeddZxZS)rlz5Defines a required child element for MetaOxmlElement.c.tt| |dy)Nr)rrlrz)r@rrs rrzzOneAndOnlyOne.__init__s mT+J;rcNtt| |||jyr)rrlrtrr@rrrs rrtz$OneAndOnlyOne.populate_class_memberss" mT9+yQ rc<dfd }djz|_|S)z@Callable suitable for the "get" side of the property descriptor.c|jtj}|tdjz|S)Nz+required ``<%s>`` child element not present)rrrrrs rrz0OneAndOnlyOne._getter..get_child_elementsCHHR 0 012E}%ADDTDTTLrz Required ``<%s>`` child element.rr(r"r(rrs` rrzOneAndOnlyOne._getters% %GIYIY$Y!  r)rr!rr) r#r$r%r&rzrtrrrrs@rrlrls$?< ! !rrlc<eZdZdZdfd ZddZedZxZS)rmzUDefines a repeating child element for MetaOxmlElement that must appear at least once.ctt| |||j|j |j |j |jt||y)z-Add the appropriate methods to *element_cls*.N) rrmrtrrrr_add_public_adderdelattrr)s rrtz OneOrMore.populate_class_memberssX i5k9M       Y'rcrdfd }djz|_jj|y)z;Add a public `.add_x()` method to the parent element class.cBt|j}|}|SrH)rr)rprivate_add_methodrr@s r add_childz.OneOrMore._add_public_adder..add_childs#!(d.C.C!D &(ELrrNr,)rr&r_public_add_method_name)r@r4s` rr/zOneOrMore._add_public_adders;   #%)%5%5 6  477Crc d|jzS)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_%srrs rr5z!OneOrMore._public_add_method_names$//))rrr%) r#r$r%r&rtr/rr5rrs@rrmrms%_( D**rrmc$eZdZdZdfd ZxZS)rpzJ Defines an optional repeating child element for MetaOxmlElement. ctt| |||j|j |j |j t||yr)rrprtrrrrr0r)s rrtz!ZeroOrMore.populate_class_members"sN j$6{IN     Y'rr)r#r$r%r&rtrrs@rrprps ( (rrpc@eZdZdZdfd ZdZdZedZxZ S)rqz6Defines an optional child element for MetaOxmlElement.ctt| |||j|j |j |j |j|jyr) rrqrtrrrr_add_get_or_adder _add_removerr)s rrtz ZeroOrOne.populate_class_members1sZ i5k9M       rcrdfd }djz|_jj|y)zKAdd a `.get_or_add_x()` method to the element class for this child element.crt|j}|t|j}|}|SrH)rrr)rrrr@s rget_or_add_childz5ZeroOrOne._add_get_or_adder..get_or_add_child>s6C1E}$S$*?*?@ " Lrz>Return the ``<%s>`` child element, newly added if not present.Nr,)rr&r_get_or_add_method_name)r@r?s` rr;zZeroOrOne._add_get_or_adder;s;  M   $  4779IJrctdfd }djd|_jj|y)zHAdd a `._remove_x()` method to the element class for this child element.c<|jjyrH) remove_allrrs r _remove_childz-ZeroOrOne._add_remover.._remove_childMs NN4++ ,rz Remove all `z` child elements.Nrr(r"r)rr&rr )r@rDs` rr<zZeroOrOne._add_removerJs9 -#/t/?/?.@@Q R  433]Crc d|jzS)Nz get_or_add_%srrs rr@z!ZeroOrOne._get_or_add_method_nameSs00rr) r#r$r%r&rtr;r<rr@rrs@rrqrq.s+@ KD11rrqcleZdZdZd d dZd fd ZdZdZedZ e d dZ e dZ xZ S) rrzOAn `EG_*` element group where at most one of its members may appear as a child.cDt||_t||_yrH)tuple_choicesr)r@choicesrs rrzzZeroOrOneChoice.__init__[sg  ,rctt| |||j|jD])}|j||j |j +|jyr)rrrrt_add_choice_getterrJrr_add_group_remover)r@rrchoicers rrtz&ZeroOrOneChoice.populate_class_members_s] ot;KS !mm ZF  ) )+tHXHX Y Z !rctt|jdd}t|j|j|y)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 rrMz"ZeroOrOneChoice._add_choice_gettergs. T00$= !!4??I>rcXdfd }d|_jj|y)zJAdd a `._remove_eg_x()` method to the element class for this choice group.cJjD]}|j|yrH)_member_nsptagnamesrC)rtagnamer@s r_remove_choice_groupz@ZeroOrOneChoice._add_group_remover.._remove_choice_groupss$33 (w' (rz9Remove the current choice group child element if present.NrE)r&r _remove_choice_group_method_name)r@rVs` rrNz"ZeroOrOneChoice._add_group_removerps+ ((c$ 4@@BVWrc"dfd }d|_|S)zj Return a function object suitable for the "get" side of the property descriptor. cJtd|jjS)Nr)r first_child_found_inrTrs rget_group_member_elementz@ZeroOrOneChoice._choice_getter..get_group_member_elements)(*B#*B*BDD\D\*] rzbReturn the child element belonging to this element group, or |None| if no member child is present.r)r&)r@r[s` rrQzZeroOrOneChoice._choice_getterzs   4 !(('rcT|jDcgc]}|jc}Scc}w)zUSequence of namespace-prefixed tagnames, one for each member element of choice group.)rJr)r@rOs rrTz#ZeroOrOneChoice._member_nsptagnamess"15 >f!!>>>s%c d|jS)z!Function-name for choice remover._remove_rrs rrWz0ZeroOrOneChoice._remove_choice_group_method_names$//*++rr)rKzIterable[Choice]rz Iterable[str]r)r"rf)r#r$r%r&rzrtrMrNrrQrrTrWrrs@rrrrrXsWY-"?X(("??,,rrrcfeZdZdZdZd dZd dZd dZed dZ d fd Z ed dZ xZ S)r(zvEffective base class for all custom element classes. Adds standardized behavior to all classes in one place. c`d|jj|jt|fzS)Nz<%s '<%s>' at 0x%0x>)rr#_nsptagidrs r__repr__zBaseOxmlElement.__repr__s/% NN # # LL tH)   rcR|D]"}|jt|}| |cSy)z9First child with tag in `tagnames`, or None if not found.N)rr)r@tagnamesrUrs rrZz$BaseOxmlElement.first_child_found_ins3 GIIbk*E   rcp|j|}||j||S|j||SrH)rZ addpreviousappend)r@elmre successors rrz%BaseOxmlElement.insert_element_beforesB-D--x8   ! !# &  KK  rcv|D]4}|jt|}|D]}|j|6y)z>Remove child elements with tagname (e.g. "a:p") in `tagnames`.N)rrremove)r@rerUmatchingrs rrCzBaseOxmlElement.remove_alls> #G||BwK0H! # E" # #rct|S)zXML string for this element, suitable for testing purposes. Pretty printed for readability and without an XML declaration at the top. )r8rs rr7zBaseOxmlElement.xmls %T**rc.t||tS)zOverride of `lxml` _Element.xpath() method. Provides standard Open XML namespace mapping (`nsmap`) in centralized location. ) namespaces)rxpathr)r@ xpath_strrs rrqzBaseOxmlElement.xpaths w}Y6}::rc@tj|jSrH)rfrom_clark_namerrs rrazBaseOxmlElement._nsptags#33DHH==r)rer!r"z_Element | None)rir rer!)rer!r"r)r"r!)rrr!r"r) r#r$r%r&rcrZrrCrr7rqrarrs@rr(r(sI  #++;>>r) metaclassrH)r-r!r*zdict[str, str] | Noner"r()r6r )-r& __future__rrgtypingrrrrrr r lxmlr lxml.etreer r pptx.excr pptx.oxmlr pptx.oxml.nsrrr pptx.utilrrr/r8r!r5typerjr|rnrorrrlrmrprqrrr(rrrrsV" JJJ,$!99" H $C:):)z7d7$(J(JV3 3l+ +\G+G+T84 84v!%!:#*!#*L("("'1!'1T<,'<,@5>e''?5>r