*h"SrSSKJr SSKJrJrJrJr SSKJ r SSK J r J r SSKJr SSKJr SSKJr SS KJr SS KJr SS KJr \(aSS KJr SS KJr SSKJr SSKJr "SS5r "SS5r!g)z8Objects that implement reading and writing OPC packages.) annotations)IO TYPE_CHECKINGIteratorcast)RELATIONSHIP_TYPE) PACKAGE_URIPackURI) PartFactory)CorePropertiesPart) PackageReader) PackageWriter) Relationships) lazyproperty)Self)CoreProperties)Part) _Relationshipc\rSrSrSrSr\SSj5rSSjrSSjr SSSjjr \S5r SS jr \ SS j5rSS jr\SS j5rSS jr\S5rSSjr\SSj5rSrg) 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. cg)zuEntry point for any post-unmarshaling processing. May be overridden by subclasses without forwarding call to super. Nselfs M/home/mande/repo/quber/.venv/lib/python3.13/site-packages/docx/opc/package.pyafter_unmarshalOpcPackage.after_unmarshals c.URR$)zd|CoreProperties| object providing read/write access to the Dublin Core properties for this document.)_core_properties_partcore_propertiesrs 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 g7fNrelsvalues is_external target_partappend)sourcevisitedrelpart new_source walk_relss rr2'OpcPackage.iter_rels..walk_rels2so$ObG{{))+ ???t$! $Z9CI:,sA:A=r&)r-zOpcPackage | Partr.zlist[Part] | NonereturnIterator[_Relationship]r)rr/r2s @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 g7fr&r')r-r.r/r0r1 walk_partss rr:)OpcPackage.iter_parts..walk_partsIsb{{))+???t$ ! &z;DJ<,sA3A6Nr)rr0r:s @r iter_partsOpcPackage.iter_partsEs&(* 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_relYsyy))'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_DOCUMENTrs rmain_document_partOpcPackage.main_document_partcs##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 )rtemplater0 partnamesncandidate_partnames r next_partnameOpcPackage.next_partnamems]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)rr@s rrFOpcPackage.part_related_bys yy**733rc4[UR55$)zJReturn a list containing a reference to each of the parts in this package.)listr<rs 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_addrB)rr0r@r/s r relate_toOpcPackage.relate_tos! ii""71wwrc4[[R5$)zlReturn a reference to the |Relationships| instance holding the collection of relationships for this package.)rr baseURIrs 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)rfbefore_marshalrwriter()rr\r0s rsaveOpcPackage.saves6 JJD    !HiiYF OODLL&((DrsQ>"4461%7,,&$&1"*[([(|%N%Nr