h9"SrSSKJr SSKJrJrJrJr SSKJ r SSK J r J r SSKJr SSKJr SSKJr SS KJr SS KJr SS KJr \(aSS KJr SS KJr SSKJr "SS5r"SS5rg)z8Objects that implement reading and writing OPC packages.) annotations)IO TYPE_CHECKINGIteratorcast)RELATIONSHIP_TYPE) PACKAGE_URIPackURI) PartFactory)CorePropertiesPart) PackageReader) PackageWriter) Relationships) lazyproperty)CoreProperties)Part) _Relationshipc^\rSrSrSrU4SjrSr\SSj5rSSjr SSjr SSSjjr \S 5r SS jr \SS j5rSS jr\SS j5rSSjr\S5rSSjr\SSj5rSrU=r$) OpcPackagezMain API class for |python-opc|. A new instance is constructed by calling the :meth:`open` class method with a path to a package file or file-like object containing one. c*>[[U] 5 gN)superr__init__)self __class__s B/var/www/html/env/lib/python3.13/site-packages/docx/opc/package.pyrOpcPackage.__init__s j$(*cg)zuEntry point for any post-unmarshaling processing. May be overridden by subclasses without forwarding call to super. Nrs rafter_unmarshalOpcPackage.after_unmarshal s rc.URR$)zd|CoreProperties| object providing read/write access to the Dublin Core properties for this document.)_core_properties_partcore_propertiesr"s rr'OpcPackage.core_properties)s))999rc#T^# SSU4SjjjmT"U5HnUv M g7f)z{Generate exactly one reference to each relationship in the package by performing a depth-first traversal of the rels graph.Nc3># Uc/OUnURR5HSnUv UR(aMURnX1;aM-UR U5 UnT"XA5HnUv M MU g7frrelsvalues is_external target_partappend)sourcevisitedrelpart new_source walk_relss rr6'OpcPackage.iter_rels..walk_rels3so$ObG{{))+ ???t$! $Z9CI:,sA:A=r)r1zOpcPackage | Partr2zlist[Part] | NonereturnIterator[_Relationship]r!)rr3r6s @r iter_relsOpcPackage.iter_rels/sD EI % 0A  $   T?CI#s%(c#F^# /4U4SjjmT"U5HnUv M g7f)z{Generate exactly one reference to each of the parts in the package by performing a depth-first traversal of the rels graph.c3># URR5HSnUR(aMURnX1;aM)UR U5 Uv UnT"XA5HnUv M MU g7frr+)r1r2r3r4r5 walk_partss rr>)OpcPackage.iter_parts..walk_partsJsb{{))+???t$ ! &z;DJ<,sA3A6Nr!)rr4r>s @r iter_partsOpcPackage.iter_partsFs&(* t$DJ%s!c:URRXX45$)aUReturn newly added |_Relationship| instance of `reltype` between this part and `target` with key `rId`. Target mode is set to ``RTM.EXTERNAL`` if `is_external` is |True|. Intended for use during load from a serialized package, where the rId is well known. Other methods exist for adding a new relationship to the package during processing. )r,add_relationship)rreltypetargetrIdr.s rload_relOpcPackage.load_relZsyy))'3LLrc@UR[R5$)zReturn a reference to the main document part for this package. Examples include a document part for a WordprocessingML package, a presentation part for a PresentationML package, or a workbook part for a SpreadsheetML package. )part_related_byRTOFFICE_DOCUMENTr"s rmain_document_partOpcPackage.main_document_partds##B$6$677rcUR5Vs1sHo"RiM nn[S[U5S-5HnX-nXS;dM[ U5s $ gs snf)akReturn a |PackURI| instance representing partname matching `template`. The returned part-name has the next available numeric suffix to distinguish it from other parts of its type. `template` 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: "/word/header%d.xml" N)r@partnamerangelenr )rtemplater4 partnamesncandidate_partnames r next_partnameOpcPackage.next_partnamens]04/@A/@t]]/@ Aq#i.1,-A!) !2122.BsA ct[R"U5nU"5n[RX#[5 U$)zGReturn an |OpcPackage| instance loaded with the contents of `pkg_file`.)r from_file Unmarshaller unmarshalr )clspkg_file pkg_readerpackages ropenOpcPackage.open|s0#,,X6 %zK@rc8URRU5$)zReturn part to which this package has a relationship of `reltype`. Raises |KeyError| if no such relationship is found and |ValueError| if more than one such relationship is found. )r,part_with_reltype)rrDs rrJOpcPackage.part_related_bys yy**733rc4[UR55$)zJReturn a list containing a reference to each of the parts in this package.)listr@r"s rpartsOpcPackage.partssDOO%&&rcPURRX!5nUR$)zReturn rId key of new or existing relationship to `part`. If a relationship of `reltype` to `part` already exists, its rId is returned. Otherwise a new relationship is created and that rId is returned. )r, get_or_addrF)rr4rDr3s r relate_toOpcPackage.relate_tos! ii""71wwrc4[[R5$)zlReturn a reference to the |Relationships| instance holding the collection of relationships for this package.)rr baseURIr"s rr,OpcPackage.relss[0011rcURHnUR5 M [R"XRUR5 g)z^Save this package to `pkg_file`. `pkg_file` can be either a file-path or a file-like object. N)rjbefore_marshalrwriter,)rr`r4s rsaveOpcPackage.saves6 JJD    !HiiYF OODLL&((DrsN>"4461%7,,&$1"*^(^(B%N%Nr