o 4\>!@sdZddlmZmZmZmZddlmZddl m Z m Z ddl m Z ddlmZddlmZddlmZdd lmZdd lmZGd d d eZGd ddeZdS)z8Objects that implement reading and writing OPC packages.)absolute_importdivisionprint_functionunicode_literals)RELATIONSHIP_TYPE) PACKAGE_URIPackURI) PartFactory)CorePropertiesPart) PackageReader) PackageWriter) Relationships) lazypropertycseZdZdZfddZddZeddZdd Zd d Z d!d dZ eddZ ddZ e ddZddZeddZddZeddZddZedd ZZS)" 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. cstt|dSN)superr__init__self __class__@D:\Projects\ConvertPro\env\Lib\site-packages\docx\opc\package.pyrszOpcPackage.__init__cCsdS)z Entry point for any post-unmarshaling processing. May be overridden by subclasses without forwarding call to super. Nrrrrrafter_unmarshalszOpcPackage.after_unmarshalcCs|jjS)z~ |CoreProperties| object providing read/write access to the Dublin Core properties for this document. )_core_properties_partcore_propertiesrrrrr$szOpcPackage.core_propertiesc#s(dfdd |D]}|Vq dS)z Generate exactly one reference to each relationship in the package by performing a depth-first traversal of the rels graph. Nc3sh|durgn|}|jD]#}|V|jrq|j}||vrq|||}||D]}|Vq+qdSrrelsvalues is_externalZ target_partappendsourcevisitedrelpartZ new_source walk_relsrrr'1s z'OpcPackage.iter_rels..walk_relsrr)rr$rr&r iter_rels,s  zOpcPackage.iter_relsc#s,tffdd |D]}|VqdS)z Generate exactly one reference to each of the parts in the package by performing a depth-first traversal of the rels graph. c3sX|jD]#}|jr q|j}||vrq|||V|}||D]}|Vq#qdSrrr! walk_partsrrr*Gs z)OpcPackage.iter_parts..walk_partsN)list)rr%rr)r iter_partsBs  zOpcPackage.iter_partsFcCs|j||||S)a Return 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. )rZadd_relationship)rreltypetargetrIdrrrrload_relWs zOpcPackage.load_relcCs |tjS)a  Return 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_byRTZOFFICE_DOCUMENTrrrrmain_document_partbs zOpcPackage.main_document_partcCsJdd|D}tdt|dD]}||}||vr"t|SqdS)aReturn 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" cSsh|]}|jqSr)partname.0r%rrr tsz+OpcPackage.next_partname..N)r,rangelenr)rtemplateZ partnamesnZcandidate_partnamerrr next_partnamels zOpcPackage.next_partnamecCs"t|}|}t||t|S)za Return an |OpcPackage| instance loaded with the contents of *pkg_file*. )r from_file Unmarshaller unmarshalr )clspkg_file pkg_readerpackagerrropenzs zOpcPackage.opencCs |j|S)z Return 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. )rZpart_with_reltype)rr-rrrr1s zOpcPackage.part_related_bycCsdd|DS)zd Return a list containing a reference to each of the parts in this package. cSsg|]}|qSrrr5rrr sz$OpcPackage.parts..)r,rrrrpartsszOpcPackage.partscCs|j||}|jS)z Return rId key of relationship to *part*, from the existing relationship if there is one, otherwise a newly created one. )rZ get_or_addr/)rr%r-r$rrr relate_toszOpcPackage.relate_tocCs ttjS)z Return a reference to the |Relationships| instance holding the collection of relationships for this package. )r rZbaseURIrrrrrs zOpcPackage.relscCs*|jD]}|qt||j|jdS)z Save this package to *pkg_file*, where *file* can be either a path to a file (a string) or a file-like object. N)rHZbefore_marshalr writer)rrCr%rrrsaves  zOpcPackage.savecCs>z|tjWStyt|}||tj|YSw)z |CorePropertiesPart| object related to this package. Creates a default core properties part if one is not present (not common). )r1r2ZCORE_PROPERTIESKeyErrorr defaultrI)rZcore_properties_partrrrrs  z OpcPackage._core_properties_part)F)__name__ __module__ __qualname____doc__rrpropertyrr(r,r0r3r> classmethodrFr1rHrIrrrKr __classcell__rrrrrs.          rc@s4eZdZdZeddZeddZeddZdS) r@zHHosts static methods for unmarshalling a package from a |PackageReader|.cCs>t|||}t||||D]}|q|dS)z Construct graph of parts and realized relationships based on the contents of *pkg_reader*, delegating construction of each part to *part_factory*. Package relationships are added to *pkg*. N)r@_unmarshal_parts_unmarshal_relationshipsrr)rDrE part_factoryrHr%rrrrAs   zUnmarshaller.unmarshalcCs2i}|D]\}}}}||||||||<q|S)z Return a dictionary of |Part| instances unmarshalled from *pkg_reader*, keyed by partname. Side-effect is that each part in *pkg_reader* is constructed using *part_factory*. )Z iter_sparts)rDrErWrHr4 content_typer-ZblobrrrrUs   zUnmarshaller._unmarshal_partscCsV|D]$\}}|dkr|n||}|jr|jn||j}||j||j|jqdS)z Add a relationship to the source object corresponding to each of the relationships in *pkg_reader* with its target_part set to the actual target part in *parts*. /N)Z iter_srelsrZ target_refZtarget_partnamer0r-r/)rDrErHZ source_uriZsrelr"r.rrrrVs z%Unmarshaller._unmarshal_relationshipsN)rNrOrPrQ staticmethodrArUrVrrrrr@s   r@N)rQZ __future__rrrrZdocx.opc.constantsrr2Zdocx.opc.packurirrZ docx.opc.partr Zdocx.opc.parts.corepropsr Zdocx.opc.pkgreaderr Zdocx.opc.pkgwriterr Z docx.opc.relr Zdocx.opc.sharedrobjectrr@rrrrs       ,