a ]jt%@sdZddlmZddlmZddlmZmZddl m Z ddl m Z GdddZ Gd d d ZGd d d ZGd ddZGdddZdS)zQLow-level, read-only API to a serialized Open Packaging Convention (OPC) package.)RELATIONSHIP_TARGET_MODE) parse_xml) PACKAGE_URIPackURI) PhysPkgReader)CaseInsensitiveDictcsbeZdZdZfddZeddZddZdd Zed d Z ed d Z edddZ Z S) PackageReaderzProvides access to the contents of a zip-format OPC package via its :attr:`serialized_parts` and :attr:`pkg_srels` attributes.cstt|||_||_dSN)superr__init__ _pkg_srels_sparts)self content_types pkg_srelssparts __class__N/var/www/html/assistant/venv/lib/python3.9/site-packages/docx/opc/pkgreader.pyr szPackageReader.__init__cCsBt|}t|j}t|t}t|||}|t|||S)zEReturn a |PackageReader| instance loaded with contents of `pkg_file`.) r_ContentTypeMapfrom_xmlcontent_types_xmlr _srels_forr_load_serialized_partsclose)Zpkg_file phys_readerrrrrrr from_files   zPackageReader.from_fileccs&|jD]}|j|j|j|jfVqdS)zuGenerate a 4-tuple `(partname, content_type, reltype, blob)` for each of the serialized parts in the package.N)r partname content_typereltypeblob)rsrrr iter_spartss zPackageReader.iter_spartsccs>|jD]}t|fVq|jD]}|jD]}|j|fVq&qdS)z]Generate a 2-tuple `(source_uri, srel)` for each of the relationships in the package.N)r rr srelsr)rsrelspartrrr iter_srels#s     zPackageReader.iter_srelsc CsLg}t||}|D].\}}}}||} t|| |||} || qt|S)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) rrrrZ part_walkerrr!r r$rr&rrrr,s  z$PackageReader._load_serialized_partscCs||}t|j|S)zvReturn |_SerializedRelationships| instance populated with relationships for source identified by `source_uri`.)Z rels_xml_for_SerializedRelationships load_from_xmlbaseURI)rZ source_uriZrels_xmlrrrr9s zPackageReader._srels_forNc cs|dur g}|D]~}|jrq|j}||vr,q|||j}t||}||}||||fVt|||}|D]\}}}}||||fVqrqdS)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_partnamer*r rrZblob_forr() rr$Zvisited_partnamesr%rr Z part_srelsr!Z next_walkerrrrr(@s    zPackageReader._walk_phys_parts)N) __name__ __module__ __qualname____doc__r staticmethodrr#r'rrr( __classcell__rrrrr s     rcsDeZdZdZfddZddZeddZdd Zd d Z Z S) rzValue type providing dictionary semantics for looking up content type by part name, e.g. ``content_type = cti['/ppt/presentation.xml']``.cs"tt|t|_t|_dSr )r rr r _overrides _defaultsrrrrr Zsz_ContentTypeMap.__init__cCs^t|tsd}t|t|||jvr2|j|S|j|jvrJ|j|jSd}t||dS)z6Return content type for part identified by `partname`.z4_ContentTypeMap key must be , got %sz8no content type for partname '%s' in [Content_Types].xmlN) isinstancerKeyErrortyper7extr8)rrtmplrrr __getitem___s     z_ContentTypeMap.__getitem__cCsJt|}t}|jD]}||j|jq|jD]}||j|jq0|S)zcReturn a new |_ContentTypeMap| instance populated with the contents of `content_types_xml`.) rrZ overrides _add_overriderrdefaults _add_default extension)rZ types_elmZct_mapodrrrrks  z_ContentTypeMap.from_xmlcCs||j|<dS)z^Add the default mapping of `extension` to `content_type` to this content type mapping.N)r8)rrCrrrrrBwsz_ContentTypeMap._add_defaultcCs||j|<dS)z]Add the default mapping of `partname` to `content_type` to this content type mapping.N)r7)rrrrrrr@|sz_ContentTypeMap._add_override) r1r2r3r4r r?r5rrBr@r6rrrrrVs   rcs\eZdZdZfddZeddZeddZedd Zed d Z ed d Z Z S)r)zValue object for an OPC package part. Provides access to the partname, content type, blob, and serialized relationships for the part. cs0tt|||_||_||_||_||_dSr )r r)r _partname _content_type_reltype_blob_srels)rrrr r!r$rrrr s z_SerializedPart.__init__cCs|jSr )rFr9rrrrsz_SerializedPart.partnamecCs|jSr )rGr9rrrrsz_SerializedPart.content_typecCs|jSr )rIr9rrrr!sz_SerializedPart.blobcCs|jS)z-The referring relationship type of this part.rHr9rrrr sz_SerializedPart.reltypecCs|jSr )rJr9rrrr$sz_SerializedPart.srels) r1r2r3r4r propertyrrr!r r$r6rrrrr)s     r)csheZdZdZfddZeddZeddZedd Zed d Z ed d Z eddZ Z S)_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. cs8tt|||_|j|_|j|_|j|_ |j |_ dSr ) r rMr _baseURIrId_rIdr rH target_mode _target_mode target_ref _target_ref)rr.rel_elmrrrr s z _SerializedRelationship.__init__cCs |jtjkS)z'True if target_mode is ``RTM.EXTERNAL``)rRRTMZEXTERNALr9rrrr/sz#_SerializedRelationship.is_externalcCs|jS)z.Relationship type, like ``RT.OFFICE_DOCUMENT``rKr9rrrr sz_SerializedRelationship.reltypecCs|jS)zmRelationship id, like 'rId9', corresponds to the ``Id`` attribute on the ``CT_Relationship`` element.)rPr9rrrrOsz_SerializedRelationship.rIdcCs|jS)zwString in ``TargetMode`` attribute of ``CT_Relationship`` element, one of ``RTM.INTERNAL`` or ``RTM.EXTERNAL``.)rRr9rrrrQsz#_SerializedRelationship.target_modecCs|jS)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.)rTr9rrrrSsz"_SerializedRelationship.target_refcCs4|jrd}t|t|ds.t|j|j|_|jS)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)r/ ValueErrorhasattrrZ from_rel_refrNrSrW)rmsgrrrr0s z'_SerializedRelationship.target_partname) r1r2r3r4r rLr/r rOrQrSr0r6rrrrrMs      rMcs4eZdZdZfddZddZeddZZS)r,zRead-only sequence of |_SerializedRelationship| instances corresponding to the relationships item XML passed to constructor.cstt|g|_dSr )r r,r rJr9rrrr sz!_SerializedRelationships.__init__cCs |jS)z*Support iteration, e.g. 'for x in srels:'.)rJ__iter__r9rrrr[sz!_SerializedRelationships.__iter__cCs8t}|dur4t|}|jD]}|jt||q|S)zReturn |_SerializedRelationships| instance loaded with the relationships contained in `rels_item_xml`. Returns an empty collection if `rels_item_xml` is |None|. N)r,rZRelationship_lstrJr*rM)r.Z rels_item_xmlr$Zrels_elmrUrrrr-s  z&_SerializedRelationships.load_from_xml) r1r2r3r4r r[r5r-r6rrrrr,s  r,N)r4Zdocx.opc.constantsrrVZ docx.opc.oxmlrZdocx.opc.packurirrZdocx.opc.phys_pkgrZdocx.opc.sharedrrrr)rMr,rrrrs    L,%?