,hkNdZddlZddlmZmZddlmZmZ ddl m Z m Z ddl mZmZmZddlmZmZddlmZdd lmZdd lmZGd d eZGd deZGddeZGddeZGddeZGddeZ GddeZ!GddeZ"GddeZ#y)zFundamental Open Packaging Convention (OPC) objects. The :mod:`pptx.packaging` module coheres around the concerns of reading and writing presentations to and from a .pptx file. N) is_stringMapping)RELATIONSHIP_TARGET_MODERELATIONSHIP_TYPE)CT_Relationshipsserialize_part_xml)CONTENT_TYPES_URI PACKAGE_URIPackURI) PackageReader PackageWriter)CaseInsensitiveDict parse_xml) lazypropertyc:eZdZdZdZddZdZdZedZ y) _RelatableMixinzHProvide relationship methods required by both the package and each part.c8|jj|S)zReturn (single) part having relationship to this package of `reltype`. Raises |KeyError| if no such relationship is found and |ValueError| if more than one such relationship is found. )_relspart_with_reltype)selfreltypes R/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/opc/package.pypart_related_byz_RelatableMixin.part_related_bys zz++G44cv|r|jj||S|jj||S)zReturn rId key of relationship of `reltype` to `target`. If such a relationship already exists, its rId is returned. Otherwise the relationship is added and its new rId returned. )rget_or_add_ext_rel get_or_add)rtargetr is_externals r relate_toz_RelatableMixin.relate_to s= JJ ) )'6 : &&w7 rc4|j|jS)z2Return related |Part| subtype identified by `rId`.)r target_partrrIds r related_partz_RelatableMixin.related_part,szz#***rc4|j|jS)zGReturn URL contained in target ref of relationship identified by `rId`.)r target_refr$s rr(z_RelatableMixin.target_ref0szz#)))rcDtdt|jz)I|Relationships| object containing relationships from this part to others.z`%s` must implement `.rels`)NotImplementedErrortype__name__rs rrz_RelatableMixin._rels4s#" )DJ,?,? ?  rNF) r- __module__ __qualname____doc__rr!r&r(rrrrrrs-R5  +*  rrcjeZdZdZdZedZdZdZdZ e dZ dZ d Z d Zed Zy ) OpcPackagezMain API class for |python-opc|. A new instance is constructed by calling the :meth:`open` classmethod with a path to a package file or file-like object containing a package (.pptx file). c||_yN) _pkg_filerpkg_files r__init__zOpcPackage.__init__C !rc.||jS)zGReturn an |OpcPackage| instance loaded with the contents of `pkg_file`._load)clsr:s ropenzOpcPackage.openFs8}""$$rc:|jj|y)z(Remove relationship identified by `rId`.Nrpopr$s rdrop_relzOpcPackage.drop_relKs src#Kt}|jD]5}|jr|j}||vr!||j |7yw)z;Generate exactly one reference to each part in the package.N)set iter_relsr r#add)rvisitedrelparts r iter_partszOpcPackage.iter_partsOsQ%>># C??DwJ KK  sAAc#fKtfd|jD]}|yw)zGenerate exactly one reference to each relationship in package. Performs a depth-first traversal of the rels graph. c3K|jD]P}||jr|j}|vr%j||jD]}|Rywr7)valuesr r#rIrels)rQrKrLrJ walk_relss rrRz'OpcPackage.iter_rels..walk_relsbsi{{}  ??7? D!$TYY/CI sA%A(N)rGr)rrKrJrRs @@rrHzOpcPackage.iter_rels[s4 % "TZZ( CI s-1c@|jtjS)zReturn |Part| subtype serving as the main document part for this package. In this case it will be a |Presentation| part. )rRTOFFICE_DOCUMENTr.s rmain_document_partzOpcPackage.main_document_partvs ##B$6$677rc|d|dzjdtfd|jD}tt |dzddD]}||z}||vs t |cSt d) aReturn |PackURI| next available partname matching `tmpl`. `tmpl` is a printf (%)-style template string containing a single replacement item, a '%d' to be used to insert the integer portion of the partname. Example: '/ppt/slides/slide%d.xml' N*42c3nK|],}|jjs|j.ywr7)partname startswith).0pprefixs r z+OpcPackage.next_partname..s+ QZZ5J5J65RAJJ s 55rz0ProgrammingError: ran out of candidate_partnames)findrGrMrangelenr Exception)rtmpl partnamesncandidate_partnamer_s @r next_partnamezOpcPackage.next_partname~s.((./ $ 1  s9~)1b1 3A!% !2122 3 >  rcttj||jt|j y)zzSave this package to `pkg_file`. `file` can be either a path to a file (a string) or a file-like object. N)r writertuplerMr9s rsavezOpcPackage.saves& Hdjj%8I2JKrctj|j|\}}|jj t |||S)z=Return the package after loading all parts and relationships.)_PackageLoaderloadr8r load_from_xmlr )r pkg_xml_relspartss rr?zOpcPackage._loads8,11$..$G e   lEB rc4ttjS)z@|Relationships| object containing relationships of this package.)_Relationshipsr baseURIr.s rrzOpcPackage._relssk1122rN)r-r0r1r2r; classmethodrArErMrHpropertyrVrkror?rrr3rrr5r5<sg "%% 688 ,L 33rr5creZdZdZdZedZdZedZ edZ edZ edZ d Z y ) rqz@Function-object that loads a package from disk (or other store).c ||_||_yr7)r8_package)rr:packages rr;z_PackageLoader.__init__s! rc0|||jS)aReturn (pkg_xml_rels, parts) pair resulting from loading `pkg_file`. The returned `parts` value is a {partname: part} mapping with each part in the package included and constructed complete with its relationships to other parts in the package. The returned `pkg_xml_rels` value is a `CT_Relationships` object containing the parsed package relationships. It is the caller's responsibility (the package object) to load those relationships into its |_Relationships| object. r>)r@r:r~s rrrz_PackageLoader.loads8W%++--rc|j|j}}|jD]\}}|j||||d|fS)zBReturn (pkg_xml_rels, parts) pair resulting from loading pkg_file./)_parts _xml_relsitemsload_rels_from_xml)rruxml_relsr[rLs rr?z_PackageLoader._loadsR++t~~x#kkm ?NHd  # #HX$6 > ?}e##rcNtj|jtS)z|_ContentTypeMap| object providing content-types for items of this package. Provides a content-type (MIME-type) for any given partname. )_ContentTypeMapfrom_xml_package_readerr r.s r_content_typesz_PackageLoader._content_typess! ''(<(<=N(OPPrc,t|jS)zE|PackageReader| object providing access to package-items in pkg_file.)r r8r.s rrz_PackageLoader._package_readersT^^,,rc |j}|j}|j}d|jj DDcic]}||vr|t ||||||c}Scc}w)a]dict {partname: Part} populated with parts loading from package. Among other duties, this collection is passed to each relationships collection so each relationship can resolve a reference to its target part when required. This reference can only be reliably carried out once the all parts have been loaded. c3,K|] }|dk7s |yw)rNr3)r]r^s rr`z(_PackageLoader._parts..sJ1cQJs )blob)rr}rrkeys PartFactory)r content_typesr~package_readerr[s rrz_PackageLoader._partss++ ----K(;(;(=J  >) kh'#H-     s!A,cvitfdtjtS)zdict {partname: xml_rels} for package and all package parts. This is used as the basis for other loading operations such as loading parts and populating their relationships. c||<j||j}|D]]}|jtjk(r!t j ||j}|vrF|j|_y)zAPopulate `xml_rels` dict by traversing relationships depth-first.N) rIrx targetModeRTMEXTERNALr from_rel_refr( _xml_rels_for) source_partnamerQbase_urirKtarget_partname load_relsrvisited_partnamesrs rrz+_PackageLoader._xml_rels..load_relss(,H_ %  ! !/ 2&..H P>>S\\1")"6"6x"P"&77/4+=+=o+NO  Pr)rGr r)rrrrs`@@@rrz_PackageLoader._xml_relss4E P +t11+>?rcz|jj|}|tjSt |S)aReturn CT_Relationships object formed by parsing rels XML for `partname`. A CT_Relationships object is returned in all cases. A part that has no relationships receives an "empty" CT_Relationships object, i.e. containing no `CT_Relationship` objects. )r rels_xml_forrnewr)rr[rels_xmls rrz_PackageLoader._xml_rels_fors9''44X>)1)9##%Ry?RRrN)r-r0r1r2r;ryrrr?rrrrrrr3rrrqrqs{J  . .$QQ--  26SrrqceZdZdZddZedZedZejdZe dZ dZ d Z e d Zed Zejd Ze d ZdZdZe dZy)PartaBase class for package parts. Provides common properties and methods, but intended to be subclassed in client code to implement specific part behaviors. Also serves as the default class for parts that are not yet given specific behaviors. Nc<||_||_||_||_yr7) _partname _content_typer}_blob)rr[ content_typer~rs rr;z Part.__init__s!)  rc|||||S)zReturn `cls` instance loaded from arguments. This one is a straight pass-through, but subtypes may do some pre-processing, see XmlPart for an example. r3r@r[rr~rs rrrz Part.load"s8\7D99rc|jS)aContents of this package part as a sequence of bytes. May be text (XML generally) or binary. Intended to be overridden by subclasses. Default behavior is to return the blob initial loaded during `Package.open()` operation. rr.s rrz Part.blob+szzrc||_y)zNote that not all subclasses use the part blob as their blob source. In particular, the |XmlPart| subclass uses its `self._element` to serialize a blob on demand. This works fine for binary parts though. Nr)rbytes_s rrz Part.blob5s  rc|jS)z&Content-type (MIME-type) of this part.)rr.s rrzPart.content_type>s!!!rcd|j|dkr|jj|yy)zRemove relationship identified by `rId` if its reference count is under 2. Relationships with a reference count of 0 are implicit relationships. Note that only XML parts can drop relationships. N)_rel_ref_countrrDr$s rrEz Part.drop_relCs,   s #a ' JJNN3  (rcf|jj|jj||y)a\load _Relationships for this part from `xml_rels`. Part references are resolved using the `parts` dict that maps each partname to the loaded part with that partname. These relationships are loaded from a serialized package and so already have assigned rIds. This method is only used during package loading. N)rrsrrx)rrrus rrzPart.load_rels_from_xmlLs$   !7!75Irc|jS)z+|OpcPackage| instance this part belongs to.)r}r.s rr~z Part.packageV}}rc|jS)z@|PackURI| partname for this part, e.g. "/ppt/slides/slide1.xml".)rr.s rr[z Part.partname[s~~rctt|ts!tdt|jz||_y)Nz.partname must be instance of PackURI, got '%s') isinstancer TypeErrorr,r-rrr[s rr[z Part.partname`s7(G,@x.))* "rc|jS)zJ|Relationships| collection of relationships from this part to other parts.rr.s rrQz Part.relsiszzrct|r&t|d5}|jcdddStt |dr|j d|jS#1swY?xYw)zIReturn bytes of `file`, which is either a str path or a file-like object.rbNseekr)rrAreadcallablegetattrr)rfilefs r_blob_from_filezPart._blob_from_fileosb T?dD! Qvvx  GD&) * IIaLyy{  s A((A1c|t|jjdDcgc] }||k(s | c}Scc}w)z;Return int count of references in this part's XML to `rId`.z//@r:id)re_elementxpath)rr%rs rrzPart._rel_ref_count|s0t}}229=J!cAJKKJs 99c@t|jjS)r*)rwrrxr.s rrz Part._relssdnn4455rr7)r-r0r1r2r;ryrrrzrsetterrrrErr~r[rQrrrr3rrrrs:: [["" J__"" L66rrcReZdZdZfdZedZedZedZ xZ S)XmlPartzBase class for package parts containing an XML payload, which is most of them. Provides additional methods to the |Part| base class that take care of parsing and reserializing the XML payload and managing relationships to other parts. c>tt| |||||_yr7)superrr;r)rr[rr~element __class__s rr;zXmlPart.__init__s gt%h gF rc,||||t|S)z, got %sz8no content-type for partname '%s' in [Content_Types].xml) rr rr,r-rextrKeyErrorrs r __getitem__z_ContentTypeMap.__getitem__s(G,Fx.))*  t &??8, , <<4>> )>>(,,/ / F Q  rct|}td|jD}td|jD}|||S)zEReturn |_ContentTypeMap| instance populated from `content_types_xml`.c3hK|]*}|jj|jf,ywr7)partNamelower contentType)r]os rr`z+_ContentTypeMap.from_xml..s+( 45QZZ    /( 02c3hK|]*}|jj|jf,ywr7) extensionrr)r]ds rr`z+_ContentTypeMap.from_xml..s+' 56Q[[   !-- 0' r)rr override_lst default_lst)r@content_types_xml types_elmrrs rrz_ContentTypeMap.from_xmlsZ/0 '( 9B9O9O(  '' :C:O:O'  9h''rN)r-r0r1r2r;rryrr3rrrrs#V" $ ( (rrceZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z ed Zdd ZddZedZedZedZy)rwaCollection of |_Relationship| instances having `dict` semantics. Relationships are keyed by their rId, but may also be found in other ways, such as by their relationship type. |Relationship| objects are keyed by their rId. Iterating this collection has normal mapping semantics, generating the keys (rIds) of the mapping. `rels.keys()`, `rels.values()`, and `rels.items() can be used as they would be for a `dict`. c||_yr7) _base_uri)rrs rr;z_Relationships.__init__r<rc||jvS)z9Implement 'in' operation, like `"rId7" in relationships`.rr$s r __contains__z_Relationships.__contains__sdjj  rcX |j|S#t$rtd|zwxYw)zJImplement relationship lookup by rId using indexed access, like rels[rId].zno relationship with key '%s')rrr$s rrz_Relationships.__getitem__s8 B::c? " B:S@A A Bs)c,t|jS)zDImplement iteration of rIds (iterating a mapping produces its keys).)iterrr.s r__iter__z_Relationships.__iter__sDJJrc,t|jS)z,Return count of relationships in collection.)rerr.s r__len__z_Relationships.__len__s4::rcR|j||}||j||S|S)zReturn str rId of `reltype` to `target_part`. The rId of an existing matching relationship is used if present. Otherwise, a new relationship is added and that rId is returned.  _get_matching_add_relationship)rrr# existing_rIds rrz_Relationships.get_or_adds? ))';? #  " "7K 8  rcZ|j||d}||j||dS|S)zReturn str rId of external relationship of `reltype` to `target_ref`. The rId of an existing matching relationship is used if present. Otherwise, a new relationship is added and that rId is returned. T)r r)rrr(rs rrz!_Relationships.get_or_add_ext_relsI ))':4)P #  " "7JD " I  rcfd}|jj|jjd|Dy)zHReplace any relationships in this collection with those from `xml_rels`.c3KjD]]}|jtjk(r%t j |j }|vrEtj|_yw)z?Filter out broken relationships such as those pointing to NULL.N) relationship_lstrrINTERNALr rr( _Relationshipr)rel_elmr[rrurs riter_valid_relsz5_Relationships.load_from_xml..iter_valid_rels"sj#44 G %%5&33Hg>P>PQHu, #,,XwFF GsA.A1c38K|]}|j|fywr7)r%)r]rKs rr`z/_Relationships.load_from_xml..0sFS377C.FsN)rclearupdate)rrrrurs ``` rrsz_Relationships.load_from_xmls6 G  FO4EFFrc|j|}t|dk(rtd|zt|dkDrtd|z|djS)zReturn target part of relationship with matching `reltype`. Raises |KeyError| if not found and |ValueError| if more than one matching relationship is found. rz*no relationship of type '%s' in collectionraz1multiple relationships of type '%s' in collection)_rels_by_reltyperer ValueErrorr#)rrrels_of_reltypes rrz _Relationships.part_with_reltype2sg //8  1 $G'QR R  ! #CgM q!---rc8|jj|S)zReturn |Relationship| identified by `rId` after removing it from collection. The caller is responsible for ensuring it is no longer required. rCr$s rrDz_Relationships.popDs zz~~c""rctj}fd}|D]>}|j|j|j|j |j @|jS)zbytes XML serialization of this relationship collection. This value is suitable for storage as a .rels file in an OPC package. Includes a `.iter_rels_in_numerical_order..WsI* %(NN5$9c!"goo>OCABLUV*sAAc3.K|] \}}|ywr7r3)r]_r%rs rr`zK_Relationships.xml..iter_rels_in_numerical_order..^sA&!SDIAs)sortedr)sorted_num_rId_pairsrs riter_rels_in_numerical_orderz8_Relationships.xml..iter_rels_in_numerical_orderVs2#)*  99; *$ B,@A Ar)rradd_relr%rr(r xml)rrels_elmr!rKs` rr#z_Relationships.xmlKs_$'') B01 TC   SWWckk3>>3?? S T||rc|j}t|j|||rtjntj ||j |<|S)z6Return str rId of |_Relationship| newly added to spec.) target_moder) _next_rIdr rrrr r)rrrr r%s rrz _Relationships._add_relationshipesCnn' NN  (3    3 rc|j|D]I}|j|k7r|jr |jn |j}||k7r=|jcSy)zReturn optional str rId of rel of `reltype`, `target`, and `is_external`. Returns `None` on no matching relationship N)rr r(r#r%)rrrr rK rel_targets rrz_Relationships._get_matchingqs[ ((1 C+-+.??JV#77N  rcntt|dzddD]}d|z}||jvs|cSy)zNext str rId available in collection. The next rId is the first unused key starting from "rId1" and making use of any gaps in numbering, e.g. 'rId2' for rIds ['rId1', 'rId3']. rarrbzrId%dN)rdrer)rri rId_candidates rr'z_Relationships._next_rIds?s4y1}a, %A#aKMDJJ.$$ %rctS)zFdict {rId: _Relationship} containing relationships of this collection.)dictr.s rrz_Relationships._relss v rctjt}|jD] }||jj |"|S)zBdefaultdict {reltype: [rels]} for all relationships in collection.) collections defaultdictlistrPrappend)rDrKs rrz_Relationships._rels_by_reltypesD  # #D );;= 'C ckkN ! !# & 'rNr/)r-r0r1r2r;rrrrrrrsrrDrzr#rrr'rrrr3rrrwrws"!B     G&.$#2   % %rrwceZdZdZdZedZedZedZ edZ edZ edZ ed Z y ) r zDValue object describing link from a part or package to another part.cJ||_||_||_||_||_yr7)r_rId_reltype _target_mode_target)rrr%rr&rs rr;z_Relationship.__init__s&!  ' rc|jtjk(r |jn"|t j ||j}|||j |j|j|S)zEReturn |_Relationship| object based on CT_Relationship element `rel`.)rrrr(r rr%r)r@rrKrurs rrz_Relationship.from_xmls\ ~~- NNw++HcnnEF  8SWWckk3>>6JJrc<|jtjk(S)zTrue if target_mode is `RTM.EXTERNAL`. An external relationship is a link to a resource outside the package, such as a web-resource (URL). )r8rrr.s rr z_Relationship.is_externals  CLL00rc|jS)zHMember of RELATIONSHIP_TYPE describing relationship of target to source.)r7r.s rrz_Relationship.reltyperrc|jS)zstr relationship-id, like 'rId9'. Corresponds to the `Id` attribute on the `CT_Relationship` element and uniquely identifies this relationship within its peers for the source-part or package. )r6r.s rr%z_Relationship.rIdsyyrcH|jr td|jS)z3|Part| or subtype referred to by this relationship.zR`.target_part` property on _Relationship is undefined when target-mode is external)r rr9r.s rr#z_Relationship.target_parts+   * ||rc\|jr td|jjS)z|PackURI| instance containing partname targeted by this relationship. Raises `ValueError` on reference if target_mode is external. Use :attr:`target_mode` to check before referencing. zV`.target_partname` property on _Relationship is undefined when target-mode is external)r rr9r[r.s rrz_Relationship.target_partnames1   * ||$$$rc||jr |jS|jj|jS)zstr reference to relationship target. For internal relationships this is the relative partname, suitable for serialization purposes. For an external relationship it is typically a URL. )r r9r relative_refrr.s rr(z_Relationship.target_refs: LL %%224>>B rN)r-r0r1r2r;ryrrr rr%r#rr(r3rrr r sNKK11 % %    rr )$r2r/ pptx.compatrrpptx.opc.constantsrrrrT pptx.opc.oxmlrrpptx.opc.packurir r r pptx.opc.serializedr r pptx.opc.sharedr pptx.oxmlr pptx.utilrobjectrr5rqrrrrrwr r3rrrKs *W>DD</"$ f$ Nh3h3ViSViSXp6?p6fd@&0#(f#(LvWvrO FO r