o US{'@sdZddlmZddlmZddlmZddlm Z m Z ddl m Z ddl mZGd d d eZGd d d eZGd ddeZGdddeZGdddeZdS)z^ Provides a low-level, read-only API to a serialized Open Packaging Convention (OPC) package. )absolute_import)RELATIONSHIP_TARGET_MODE) parse_xml) PACKAGE_URIPackURI) PhysPkgReader)CaseInsensitiveDictcsbeZdZdZfddZeddZddZdd Zed d Z ed d Z edddZ Z S) PackageReaderz Provides 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__BD:\Projects\ConvertPro\env\Lib\site-packages\docx\opc\pkgreader.pyr s zPackageReader.__init__cCsBt|}t|j}t|t}t|||}|t|||S)zW Return 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)z Generate a 4-tuple `(partname, content_type, reltype, blob)` for each of the serialized parts in the package. N)rpartname content_typereltypeblob)rsrrr iter_sparts)s zPackageReader.iter_spartsccs@|jD]}t|fVq|jD]}|jD]}|j|fVqqdS)zo Generate a 2-tuple `(source_uri, srel)` for each of the relationships in the package. N)rrrsrelsr )rsrelspartrrr iter_srels1s    zPackageReader.iter_srelsc CsLg}t||}|D]\}}}}||} t|| |||} || q t|S)z Return 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_walkerr r#r"r&r!r(rrrr<s   z$PackageReader._load_serialized_partscCs||}t|j|S)z Return |_SerializedRelationships| instance populated with relationships for source identified by *source_uri*. )Z rels_xml_for_SerializedRelationships load_from_xmlbaseURI)rZ source_uriZrels_xmlrrrrMs zPackageReader._srels_forNc cs|durg}|D]?}|jrq |j}||vrq |||j}t||}||}||||fVt|||}|D] \}}}}||||fVq:q dS)z Generate 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"r rZblob_forr*) rr&Zvisited_partnamesr'r r"Z part_srelsr#Z next_walkerrrrr*Ws*   zPackageReader._walk_phys_partsr ) __name__ __module__ __qualname____doc__r staticmethodrr%r)rrr* __classcell__rrrrr s      r csDeZdZdZfddZddZeddZdd Zd d Z Z S) rz Value 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 ws z_ContentTypeMap.__init__cCsZt|tsd}t|t|||jvr|j|S|j|jvr%|j|jSd}t||)zH Return content type for part identified by *partname*. z4_ContentTypeMap key must be , got %sz8no content type for partname '%s' in [Content_Types].xml) isinstancerKeyErrortyper9extr:)rr tmplrrr __getitem__|s      z_ContentTypeMap.__getitem__cCsJt|}t}|jD] }||j|jq |jD] }||j|jq|S)zu Return a new |_ContentTypeMap| instance populated with the contents of *content_types_xml*. ) rrZ overrides _add_overrider r!defaults _add_default extension)rZ types_elmZct_mapodrrrrs  z_ContentTypeMap.from_xmlcC||j|<dS)zp Add the default mapping of *extension* to *content_type* to this content type mapping. N)r:)rrEr!rrrrDz_ContentTypeMap._add_defaultcCrH)zo Add the default mapping of *partname* to *content_type* to this content type mapping. N)r9)rr r!rrrrBrIz_ContentTypeMap._add_override) r3r4r5r6r rAr7rrDrBr8rrrrrrs   rcs\eZdZdZfddZeddZeddZedd Zed d Z ed d Z Z S)r+z Value 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)rr r!r"r#r&rrrr s  z_SerializedPart.__init__cC|jSr )rJr;rrrr z_SerializedPart.partnamecCrOr )rKr;rrrr!rPz_SerializedPart.content_typecCrOr )rMr;rrrr#rPz_SerializedPart.blobcCrO)z? The referring relationship type of this part. rLr;rrrr"sz_SerializedPart.reltypecCrOr )rNr;rrrr&rPz_SerializedPart.srels) r3r4r5r6r propertyr r!r#r"r&r8rrrrr+s     r+csheZdZdZfddZeddZeddZedd Zed d Z ed d Z eddZ Z S)_SerializedRelationshipz Value 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 rSr _baseURIrId_rIdr"rL target_mode _target_mode target_ref _target_ref)rr0rel_elmrrrr s  z _SerializedRelationship.__init__cCs |jtjkS)z9 True if target_mode is ``RTM.EXTERNAL`` )rXRTMZEXTERNALr;rrrr1s z#_SerializedRelationship.is_externalcCrO)z.Relationship type, like ``RT.OFFICE_DOCUMENT``rQr;rrrr"sz_SerializedRelationship.reltypecCrO)z Relationship id, like 'rId9', corresponds to the ``Id`` attribute on the ``CT_Relationship`` element. )rVr;rrrrUz_SerializedRelationship.rIdcCrO)z String in ``TargetMode`` attribute of ``CT_Relationship`` element, one of ``RTM.INTERNAL`` or ``RTM.EXTERNAL``. )rXr;rrrrWr]z#_SerializedRelationship.target_modecCrO)z String 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. )rZr;rrrrYsz"_SerializedRelationship.target_refcCs4|jr d}t|t|dst|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)r1 ValueErrorhasattrrZ from_rel_refrTrYr^)rmsgrrrr2s z'_SerializedRelationship.target_partname) r3r4r5r6r rRr1r"rUrWrYr2r8rrrrrSs      rScs4eZdZdZfddZddZeddZZS)r.z Read-only sequence of |_SerializedRelationship| instances corresponding to the relationships item XML passed to constructor. cstt|g|_dSr )r r.r rNr;rrrr s z!_SerializedRelationships.__init__cCs |jS)z)Support iteration, e.g. 'for x in srels:')rN__iter__r;rrrrbs z!_SerializedRelationships.__iter__cCs8t}|durt|}|jD] }|jt||q|S)z Return |_SerializedRelationships| instance loaded with the relationships contained in *rels_item_xml*. Returns an empty collection if *rels_item_xml* is |None|. N)r.rZRelationship_lstrNr,rS)r0Z rels_item_xmlr&Zrels_elmr[rrrr/s  z&_SerializedRelationships.load_from_xml) r3r4r5r6r rbr7r/r8rrrrr.s  r.N)r6Z __future__r constantsrr\ZoxmlrZpackurirrZphys_pkgrsharedr objectr rr+rSr.rrrrs     a5%E