,hadZddlmZmZddlZddlmZddlmZddl m Z dd l m Z dd l mZmZmZdd lmZd)d Zd ZGdde ZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGd d!eZ Gd"d#eZ!Gd$d%eZ"Gd&d'ejFZ$ed(ejFfe%e$jLZ'y)*zU Base and meta classes that enable declarative definition of custom element classes. )absolute_importprint_functionN)etree) oxml_parser)Unicode)InvalidXmlError)NamespacePrefixedTag_nsmapqn) lazypropertyczt|}||n |j}tj|j|S)a  Return 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)r rr makeelement clark_name) nsptag_strrnsptags T/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/oxml/xmlchemy.py OxmlElementrs7"* -F&EFLLE  " "6#4#4E BBcHtj|dd}t|S)z_ Serialize *element* to human-readable XML suitable for tests. No XML declaration. unicodeT)encoding pretty_print)rtostring XmlString)elementxmls rserialize_for_readingr !s ..94 HC S>rcReZdZdZej dZdZdZdZ dZ dZ y) rzg Provides string comparison override suitable for serialized XML that is useful for tests. z(( *)([^<]*)?c|j}|j}t|t|k7ryt||D]\}}|j||ryy)NFT) splitlineslenzip _eq_elm_strs)selfotherlines lines_otherline line_others r__eq__zXmlString.__eq__8sc!&&( u:[) ) #E; 7  D*$$T:6 rc&|j| SN)r-)r'r(s r__ne__zXmlString.__ne__Bs;;u%%%rcX|j}|j}t|S)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_seqzXmlString._attr_seqEs%  ;;=hrc|j|\}}}}|j|\}}} } ||k7ry|j||j|k7ry|| k7ry|| k7ryy)zl Return True if the element in *line_2* is XML equivalent to the element in *line*. FT) _parse_liner7) r'r+line_2frontr5closetextfront_2attrs_2close_2text_2s rr&zXmlString._eq_elm_strsNsv %)$4$4T$:!ueT,0,<,>% DNN7$; ; G  6>rc|jj|}tddDcgc]}|j|c}\}}}}||||fScc}w)zo Return front, attrs, close, text 4-tuple result of parsing XML element string *line*. r)_xml_elm_line_pattmatchrangegroup)r'r+rEnr;r5r<r=s rr9zXmlString._parse_line_sV ''--d3=B1a[$IU[[^$I!ueTeUD((%JsAN) __name__ __module__ __qualname____doc__recompilerDr-r0r7r&r9rrrr*s4$$OP& ")rrceZdZdZdZy)MetaOxmlElementz' Metaclass for BaseOxmlElement ctttttt t f}|jD]$\}}t||s|j||&yr/) OneAndOnlyOne OneOrMoreOptionalAttributeRequiredAttribute ZeroOrMore ZeroOrOneZeroOrOneChoiceitems isinstancepopulate_class_members)clsclsnamebasesclsdict dispatchablekeyvalues r__init__zMetaOxmlElement.__init__nsS        "--/ 7JC%.,,S#6 7rN)rIrJrKrLrdrOrrrQrQis  7rrQc>eZdZdZfdZdZdZedZxZ S) BaseAttributez_ Base class for OptionalAttribute and RequiredAttribute, providing common methods. cFtt| ||_||_yr/)superrfrd _attr_name _simple_type)r' attr_name simple_type __class__s rrdzBaseAttribute.__init__s mT+-#'rc@||_||_|jyz? Add the appropriate methods to *element_cls*. N) _element_cls _prop_name_add_attr_propertyr' element_cls prop_names rr\z$BaseAttribute.populate_class_memberss(# !rct|j|jd}t|j|j |y)z Add a read/write ``{prop_name}`` property to the element class that returns the interpreted value of this attribute on access and changes the attribute value to its ST_* counterpart on assignment. N)property_getter_settersetattrrprqr' property_s rrrz BaseAttribute._add_attr_propertys0 T\\4<<> !!4??I>rc`d|jvrt|jS|jS)N:)rir r's r _clark_namezBaseAttribute._clark_names' $// !doo& &r) rIrJrKrLrdr\rrrwr __classcell__rms@rrfrf}s+ ( "?rrfcTeZdZdZdfd ZedZedZedZxZ S)rUz Defines 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| ||||_yr/)rhrUrd_default)r'rkrldefaultrms rrdzOptionalAttribute.__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.rjrIrirs r _docstringzOptionalAttribute._docstrings#  ))4?? < rc4fd}j|_|S)t Return a function object suitable for the "get" side of the attribute property descriptor. c|jj}| jSjj |Sr/)getrrrjfrom_xmlobjattr_str_valuer's rget_attr_valuez1OptionalAttribute._getter..get_attr_values> WWT%5%56N%}}$$$--n= =rrrLr'rs` rrxzOptionalAttribute._getters > "&rcfd}|S)t Return a function object suitable for the "set" side of the attribute property descriptor. c|jk(r0j|jvr|jj=yjj |}|j j|yr/)rrattribrjto_xmlsetrrc str_valuer's rset_attr_valuez1OptionalAttribute._setter..set_attr_values` %##szz1 4#3#34))007I GGD$$i 0rrOr'rs` rryzOptionalAttribute._setters 1rr/) rIrJrKrLrdrwrrxryrrs@rrUrUsI        rrUc@eZdZdZedZedZedZy)rVa Defines 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. c4fd}j|_|S)rc|jj}|%tdjd|jj j |S)Nz required 'z#' attribute not present on element )rrr ritagrjrrs rrz1RequiredAttribute._getter..get_attr_valuesU WWT%5%56N%%1$$--n= =rrrs` rrxzRequiredAttribute._getters >"&rcN|jjd|jdS)rrz `` attribute.rrs rrzRequiredAttribute._docstrings$    & & OO  rcfd}|S)rctjj|}|jj|yr/)rjrrrrs rrz1RequiredAttribute._setter..set_attr_value s-))007I GGD$$i 0rrOrs` rryzRequiredAttribute._setters 1rN)rIrJrKrLrwrxrryrOrrrVrVsC$    rrVceZdZdZdfd ZdZdZdZdZdZ dZ e d Z d Z ed Zed Ze d ZedZe dZe dZxZS)_BaseChildElementz Base class for the child element classes corresponding to varying cardinalities, such as ZeroOrOne and ZeroOrMore. cFtt| ||_||_yr/)rhrrd _nsptagname _successors)r' nsptagname successorsrms rrdz_BaseChildElement.__init__s! /1%%rc ||_||_y)z` Baseline behavior for adding the appropriate methods to *element_cls*. N)rprqrss rr\z(_BaseChildElement.populate_class_memberss (#rcpfd}djz|_jj|y)za Add an ``_add_x()`` method to the element class for this child element. ct|j}|}|jD]\}}t|||t|j}|||Sr/)getattr_new_method_namerZrz_insert_method_name)rr5 new_methodchildrbrc insert_methodr's r _add_childz0_BaseChildElement._add_adder.._add_child+s` d&;&;`` child element unconditionally, inserted in the correct sequence.N)rrL _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)z Add 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)_creatorrrLrr)r'creators r _add_creatorz_BaseChildElement._add_creator:s? -- (*.*:*: ;  400':rctt|jdd}t|j|j|y)zo Add a read-only ``{prop_name}`` property to the element class for this child element. N)rwrxrzrprqr{s r _add_getterz_BaseChildElement._add_getterFs, T\\46 !!4??I>rcpfd}djz|_jj|y)zd Add an ``_insert_x()`` method to the element class for this child element. cB|j|gj|Sr/)insert_element_beforerrrr's r _insert_childz6_BaseChildElement._add_inserter.._insert_childUs# %C % %e ?d.>.> ?LrzYReturn the passed ``<%s>`` element after inserting it as a child in the correct sequence.N)rrLrr)r'rs` r _add_inserterz_BaseChildElement._add_inserterOs;    )+/+;+; <  433]Crc~d|jz}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. z%s_lstN)rqrw _list_getterrzrp)r'rur|s r_add_list_getterz"_BaseChildElement._add_list_getter_s8 t. T..d; !!9i8rc d|jzS)Nz_add_%srqrs rrz"_BaseChildElement._add_method_nameh4??**rc`t|j|ryt|j||y)zt Add *method* to the target class as *name*, unless *name* is already defined on the class. N)hasattrrprz)r'namemethods rrz_BaseChildElement._add_to_classls) 4$$d + !!40rcfd}|S)z} Return a function object that creates a new, empty element of the right type, having no attributes. c.tjSr/)rrrr's rnew_child_elementz5_BaseChildElement._creator..new_child_element|st//0 0rrO)r'rs` rrz_BaseChildElement._creatorus 1! rc:fd}djz|_|S)z Return 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|jtjSr/)findr rrs rget_child_elementz4_BaseChildElement._getter..get_child_elements88Bt//01 1rz0``<%s>`` child element or |None| if not present.rrLr'rs` rrxz_BaseChildElement._getters( 2 ?AQAQ Q !! rc d|jzS)Nz _insert_%srrs rrz%_BaseChildElement._insert_method_namedoo--rc:fd}djz|_|S)zm Return a function object suitable for the "get" side of a list property descriptor. cL|jtjSr/)findallr rrs rget_child_element_listz>_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'rs` rrz_BaseChildElement._list_getters+ 5 "&"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_namerrrO)rIrJrKrLrdr\rrrrrrrrrwrrxrrrrrrs@rrrs & $>* ;?D 9++1 ! ! ! !.. & &..++rrc\eZdZdZedZdZdZedZe dZ e dZ y) Choicezd Defines a child element belonging to a group, only one of which may appear as a child. c|jSr/)rrs rrzChoice.nsptagnamesrc||_||_||_|j|j |j |j |jyro)rp_group_prop_namerrrrr_add_get_or_change_to_method)r'rtgroup_prop_namers rr\zChoice.populate_class_memberssV( /%     ))+rcpfd}djz|_jj|y)zl Add a ``get_or_change_to_x()`` method to the element class for this child element. ct|j}||St|j}|t|j}|}|Sr/)rrq_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.N)rrLr_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. r~rrN)rindex)r'starts rrqzChoice._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) rIrJrKrLrwrr\rrqrrrrOrrrrsb    ,W*((7744rrc<eZdZdZfdZfdZedZxZS)rSz? Defines a required child element for MetaOxmlElement. c.tt| |dyr/)rhrSrd)r'rrms rrdzOneAndOnlyOne.__init__s mT+J=rcNtt| |||jyro)rhrSr\rr'rtrurms rr\z$OneAndOnlyOne.populate_class_memberss" mT9+yQ rc:fd}djz|_|S)j Return a function object suitable for the "get" side of the property descriptor. c|jtj}|tdjz|S)Nz+required ``<%s>`` child element not present)rr rr rs rrz0OneAndOnlyOne._getter..get_child_elementsCHHR 0 012E}%ADDTDTTLrz Required ``<%s>`` child element.rrs` rrxzOneAndOnlyOne._getters(  /1A1A A !! r) rIrJrKrLrdr\rwrxrrs@rrSrSs&>!!rrSc8eZdZdZfdZdZedZxZS)rTzc Defines a repeating child element for MetaOxmlElement that must appear at least once. ctt| |||j|j |j |j |jt||yro) rhrTr\rrrr_add_public_adderdelattrrs rr\z OneOrMore.populate_class_memberssZ i5k9M       Y'rcpfd}djz|_jj|y)zN Add a public ``add_x()`` method to the parent element class. cBt|j}|}|Sr/)rr)rprivate_add_methodrr's r add_childz.OneOrMore._add_public_adder..add_child*s#!(d.C.C!D &(ELrrN)rrLr_public_add_method_name)r'r s` rrzOneOrMore._add_public_adder%s;    #%)%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 rr z!OneOrMore._public_add_method_name5s$//))r) rIrJrKrLr\rrr rrs@rrTrTs' (D **rrTc"eZdZdZfdZxZS)rWzJ Defines an optional repeating child element for MetaOxmlElement. ctt| |||j|j |j |j t||yro)rhrWr\rrrrrrs rr\z!ZeroOrMore.populate_class_membersEsN j$6{IN     Y'r)rIrJrKrLr\rrs@rrWrW@s ( (rrWc>eZdZdZfdZdZdZedZxZ S)rXz@ Defines an optional child element for MetaOxmlElement. ctt| |||j|j |j |j |j|jyro) rhrXr\rrrr_add_get_or_adder _add_removerrs rr\z ZeroOrOne.populate_class_membersVs\ i5k9M       rcpfd}djz|_jj|y)zf Add a ``get_or_add_x()`` method to the element class for this child element. crt|j}|t|j}|}|Sr/)rrqr)rrrr's rget_or_add_childz5ZeroOrOne._add_get_or_adder..get_or_add_childhs6C1E}$S$*?*?@ " Lrz>Return the ``<%s>`` child element, newly added if not present.N)rrLr_get_or_add_method_name)r'rs` rrzZeroOrOne._add_get_or_adderbs;   M   $  4779IJrcpfd}djz|_jj|y)zc Add a ``_remove_x()`` method to the element class for this child element. c<|jjyr/) remove_allrrs r _remove_childz-ZeroOrOne._add_remover.._remove_childzs NN4++ ,rz#Remove all ``<%s>`` child elements.N)rrLrr)r'rs` rrzZeroOrOne._add_removerts8  - 2   !  433]Crc d|jzS)Nz get_or_add_%srrs rrz!ZeroOrOne._get_or_add_method_names00r) rIrJrKrLr\rrrrrrs@rrXrXQs- K$ D11rrXcfeZdZdZd dZfdZdZdZedZ e dZ e dZ xZ S) rYzo Correspondes to an ``EG_*`` element group where at most one of its members may appear as a child. c ||_||_yr/)_choicesr)r'choicesrs rrdzZeroOrOneChoice.__init__s %rctt| |||j|jD])}|j||j |j +|jyro)rhrYr\_add_choice_getterrrqr_add_group_remover)r'rtruchoicerms rr\z&ZeroOrOneChoice.populate_class_memberssb ot;KS !mm F  ) )T__d.>.>   !rctt|jdd}t|j|j|y)z Add 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)rw_choice_getterrzrprqr{s rr z"ZeroOrOneChoice._add_choice_getters. T00$= !!4??I>rcVfd}d|_jj|y)ze Add a ``_remove_eg_x()`` method to the element class for this choice group. cJjD]}|j|yr/)_member_nsptagnamesr)rtagnamer's r_remove_choice_groupz@ZeroOrOneChoice._add_group_remover.._remove_choice_groups$33 (w' (rz9Remove the current choice group child element if present.N)rLr _remove_choice_group_method_name)r'r)s` rr!z"ZeroOrOneChoice._add_group_removers/  ( H $ 4@@BVWrc fd}d|_|S)rc6|jjSr/)first_child_found_inr'rs rget_group_member_elementz@ZeroOrOneChoice._choice_getter..get_group_member_elements+3++T-E-EF FrzbReturn the child element belonging to this element group, or |None| if no member child is present.)rL)r'r.s` rr$zZeroOrOneChoice._choice_getters G 4 !(('rcT|jDcgc]}|jc}Scc}w)z| Sequence of namespace-prefixed tagnames, one for each of the member elements of this choice group. )rr)r'r"s rr'z#ZeroOrOneChoice._member_nsptagnamess" 15 >f!!>>>s%c d|jzSrrrs rr*z0ZeroOrOneChoice._remove_choice_group_method_namerrr)rIrJrKrLrdr\r r!rwr$rr'r*rrs@rrYrYsY & "? X ( (??..rrYc`eZdZdZedZdZdZdZdZ dZ e dZ fd Z xZS) _OxmlElementBasez; Provides common behavior for oxml element classes c8|jj|S)z Return a sequence containing the namespace prefixed child tagnames, e.g. 'a:prstGeom', that occur after *tagname* in this element. )child_tagnamestagnames_after)r]r(s rchild_tagnames_afterz%_OxmlElementBase.child_tagnames_afters !!0099rcB|jj|y)z8 Remove this element from the XML tree. N) getparentremovers rdeletez_OxmlElementBase.deletes %rcR|D]"}|jt|}| |cSy)zd Return the first child found with tag in *tagnames*, or None if not found. N)rr )r'tagnamesr(rs rr-z%_OxmlElementBase.first_child_found_ins5   GIIbk*E   rcp|j|}||j||S|j||Sr/)r- addpreviousappend)r'elmr< successors rrz&_OxmlElementBase.insert_element_beforesB-D--x8   ! !# &  KK  rch|jt|}|D]}|j|y)z= Remove all child elements having *tagname*. N)rr r9)r'r(matchingrs rrz_OxmlElementBase.remove_alls1<<7 , E KK  rcn|D]0}|jt|}| |j|2y)zI Remove all child elements having tagname in *tagnames*. N)rr r9)r'r<r(rs rremove_if_presentz"_OxmlElementBase.remove_if_presents7  %Gii7 ,G" G$ %rct|S)z Return XML string for this element, suitable for testing purposes. Pretty printed for readability and without an XML declaration at the top. )r rs rrz_OxmlElementBase.xml s%T**rc6tt| |tS)z Override of ``lxml`` _Element.xpath() method to provide standard Open XML namespace mapping in centralized location. ) namespaces)rhBaseOxmlElementxpathr )r' xpath_strrms rrJz_OxmlElementBase.xpaths _d1)1OOr)rIrJrKrL classmethodr6r:r-rrrErwrrJrrs@rr2r2sU::& %++PPrr2rIr/)(rL __future__rrrMlxmlrrcompatr excr nsr r r utilrrr rtyperQobjectrfrUrVrrrSrTrWrXrY ElementBaser2dict__dict__rIrOrrrYs 7 !00 C<)<)~7d7("F"J7 7t3 3lY+Y+x>4 >4B!!%!!H**!**Z("("31!31lI.'I.XEPu((EPP"))+T2B2K2K-Lr