*ht%SrSSKJr SSKJr SSKJrJr SSK J r SSK J r "SS5r "S S 5r"S S 5r"S S5r"SS5rg)zQLow-level, read-only API to a serialized Open Packaging Convention (OPC) package.)RELATIONSHIP_TARGET_MODE) parse_xml) PACKAGE_URIPackURI) PhysPkgReader)CaseInsensitiveDictc|^\rSrSrSrU4Sjr\S5rSrSr \S5r \S5r \S S j5r S r U=r$) PackageReader z~Provides access to the contents of a zip-format OPC package via its :attr:`serialized_parts` and :attr:`pkg_srels` attributes.cB>[[U] 5 X lX0lgN)superr __init__ _pkg_srels_sparts)self content_types pkg_srelssparts __class__s O/home/mande/repo/quber/.venv/lib/python3.13/site-packages/docx/opc/pkgreader.pyrPackageReader.__init__s mT+-# c[U5n[RUR5n[R U[ 5n[RXU5nUR5 [ X#U5$)zEReturn a |PackageReader| instance loaded with contents of `pkg_file`.) r_ContentTypeMapfrom_xmlcontent_types_xmlr _srels_forr_load_serialized_partsclose)pkg_file phys_readerrrrs r from_filePackageReader.from_filesa$H- '001N1NO !,,[+F 55km\]v>>rc## URH3nURURURUR4v M5 g7f)zmGenerate a 4-tuple `(partname, content_type, reltype, blob)` for each of the serialized parts in the package.N)rpartname content_typereltypeblob)rss r iter_spartsPackageReader.iter_spartss4A::q~~qyy!&&A AsAAc## URH n[U4v M URH&nURHnURU4v M M( g7f)zUGenerate a 2-tuple `(source_uri, srel)` for each of the relationships in the package.N)rrrsrelsr&)rsrelsparts r iter_srelsPackageReader.iter_srels#sKOOD% %$\\E ~~t,,$"sAAc/n[RX5nUH(upVpxX%n [XYXvU5n URU 5 M* [ U5$)zReturn a list of |_SerializedPart| instances corresponding to the parts in `phys_reader` accessible by walking the relationship graph starting with `pkg_srels`.)r _walk_phys_parts_SerializedPartappendtuple) r"rrr part_walkerr&r)r(r.r'r0s rr$PackageReader._load_serialized_parts,sV #44[L .9 *HG(2L#HG5QE MM% /:V}rcdURU5n[RURU5$)znReturn |_SerializedRelationships| instance populated with relationships for source identified by `source_uri`.) rels_xml_for_SerializedRelationships load_from_xmlbaseURI)r" source_urirels_xmls rrPackageReader._srels_for9s-++J7'55j6H6H(SSrc#V# Uc/nUHnUR(aMURnXB;aM)URU5 URn[R X5nUR U5nXGXV4v [RXU5nUH upGpQXGXQ4v M M g7f)zGenerate a 4-tuple `(partname, blob, reltype, srels)` for each of the parts in `phys_reader` by walking the relationship graph rooted at srels.N) is_externaltarget_partnamer6r(r rblob_forr4) r"r.visited_partnamesr/r&r( part_srelsr) next_walkers rr4PackageReader._walk_phys_parts@s  $ " D++H,  $ $X .llG&11+HJ''1D77 7'88RcdK2=.w663>sB'B))rrr )__name__ __module__ __qualname____firstlineno____doc__r staticmethodr#r+r1rrr4__static_attributes__ __classcell__rs@rr r skB ??B -  TT 77rr cN^\rSrSrSrU4SjrSr\S5rSr Sr Sr U=r $) rVzValue type providing dictionary semantics for looking up content type by part name, e.g. ``content_type = cti['/ppt/presentation.xml']``.cf>[[U] 5 [5Ul[5Ulgr )rrrr _overrides _defaultsrrs rr_ContentTypeMap.__init__Zs$ ot-/-/,.rc[U[5(dSn[U[U5-5eXR;aURU$UR UR ;aUR UR $Sn[X!-5e)z6Return content type for part identified by `partname`.z4_ContentTypeMap key must be , got %sz8no content type for partname '%s' in [Content_Types].xml) isinstancerKeyErrortyperVextrW)rr&tmpls r __getitem___ContentTypeMap.__getitem___sv(G,,ID4$x.01 1  &??8, , <<4>> )>>(,,/ /It''rc[U5n[5nURH)nURURUR 5 M+ UR H)nURURUR 5 M+ U$)z[Return a new |_ContentTypeMap| instance populated with the contents of `content_types_xml`.) rr overrides _add_overrider&r'defaults _add_default extension)r types_elmct_mapods rr_ContentTypeMap.from_xmlksl/0  "$$A  Q^^ <%##A    Q^^ <$ rc X RU'g)zVAdd the default mapping of `extension` to `content_type` to this content type mapping.N)rW)rrgr's rrf_ContentTypeMap._add_defaultws%1y!rc X RU'g)zUAdd the default mapping of `partname` to `content_type` to this content type mapping.N)rV)rr&r's rrd_ContentTypeMap._add_override|s%1!r)rWrV) rJrKrLrMrNrr`rOrrfrdrPrQrRs@rrrVs6C/ (  1 11rrc|^\rSrSrSrU4Sjr\S5r\S5r\S5r \S5r \S5r S r U=r $) r5zValue object for an OPC package part. Provides access to the partname, content type, blob, and serialized relationships for the part. cf>[[U] 5 XlX lX0lX@lXPlgr )rr5r _partname _content_type_reltype_blob_srels)rr&r'r(r)r.rs rr_SerializedPart.__init__s* ot-/!)   rcUR$r )rtrs rr&_SerializedPart.partnames ~~rcUR$r )rur{s rr'_SerializedPart.content_types!!!rcUR$r )rwr{s rr)_SerializedPart.blobs zzrcUR$)z-The referring relationship type of this part.rvr{s rr(_SerializedPart.reltype}}rcUR$r rxr{s rr._SerializedPart.srelss {{r)rwrurtrvrx)rJrKrLrMrNrpropertyr&r'r)r(r.rPrQrRs@rr5r5sq ""rr5c^\rSrSrSrU4Sjr\S5r\S5r\S5r \S5r \S5r \S 5r S r U=r$) _SerializedRelationshipzValue object representing a serialized relationship in an OPC package. Serialized, in this case, means any target part is referred to via its partname rather than a direct link to an in-memory |Part| object. c>[[U] 5 XlURUlUR UlURUl URUl gr ) rrr_baseURIrId_rIdr(rv target_mode _target_mode target_ref _target_ref)rr>rel_elmrs rr _SerializedRelationship.__init__sH %t57 KK  #//"--rc<UR[R:H$)z'True if target_mode is ``RTM.EXTERNAL``)rRTMEXTERNALr{s rrC#_SerializedRelationship.is_externals  CLL00rcUR$)z.Relationship type, like ``RT.OFFICE_DOCUMENT``rr{s rr(_SerializedRelationship.reltyperrcUR$)zeRelationship id, like 'rId9', corresponds to the ``Id`` attribute on the ``CT_Relationship`` element.)rr{s rr_SerializedRelationship.rIdsyyrcUR$)zoString in ``TargetMode`` attribute of ``CT_Relationship`` element, one of ``RTM.INTERNAL`` or ``RTM.EXTERNAL``.)rr{s rr#_SerializedRelationship.target_modes   rcUR$)zString in ``Target`` attribute of ``CT_Relationship`` element, a relative part reference for internal target mode or an arbitrary URI, e.g. an HTTP URL, for external target mode.)rr{s rr"_SerializedRelationship.target_refs rcUR(a Sn[U5e[US5(d0[R"UR UR 5UlUR$)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. zUtarget_partname attribute on Relationship is undefined where TargetMode == "External"_target_partname)rC ValueErrorhasattrr from_rel_refrrr)rmsgs rrD'_SerializedRelationship.target_partnamesZ   0 S/ !t/00$+$8$8$XD !$$$r)rrrvrrr)rJrKrLrMrNrrrCr(rrrrDrPrQrRs@rrrs .11 !!   %%rrcB^\rSrSrSrU4SjrSr\S5rSr U=r $)r<z|Read-only sequence of |_SerializedRelationship| instances corresponding to the relationships item XML passed to constructor.c8>[[U] 5 /Ulgr )rr<rrxrXs rr!_SerializedRelationships.__init__s &68 rc6URR5$)z*Support iteration, e.g. 'for x in srels:'.)rx__iter__r{s rr!_SerializedRelationships.__iter__s{{##%%rc[5nUbB[U5nURH'nURR [ X55 M) U$)zReturn |_SerializedRelationships| instance loaded with the relationships contained in `rels_item_xml`. Returns an empty collection if `rels_item_xml` is |None|. )r<rRelationship_lstrxr6r)r> rels_item_xmlr.rels_elmrs rr=&_SerializedRelationships.load_from_xmlsI)*  $ /H#44 ##$;G$MN5 rr) rJrKrLrMrNrrrOr=rPrQrRs@rr<r<s&5&  rr<N)rNdocx.opc.constantsrr docx.opc.oxmlrdocx.opc.packurirrdocx.opc.phys_pkgrdocx.opc.sharedrr rr5rr<rrrsOW>#1+/I7I7X)1)1X""J<%<%~r