B 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|dS)N)superr__init__)self) __class__B/var/www/html/venv/lib/python3.7/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. Nr)rrrrafter_unmarshalszOpcPackage.after_unmarshalcCs|jjS)z~ |CoreProperties| object providing read/write access to the Dublin Core properties for this document. )_core_properties_partcore_properties)rrrrr$szOpcPackage.core_propertiesc#s*dfdd x|D] }|VqWdS)z Generate exactly one reference to each relationship in the package by performing a depth-first traversal of the rels graph. Nc3sn|dkr gn|}xX|jD]J}|V|jr.q|j}||kr>q|||}x||D] }|VqXWqWdS)N)relsvalues is_external target_partappend)sourcevisitedrelpart new_source) walk_relsrrr#1s z'OpcPackage.iter_rels..walk_rels)Nr)rr r)r#r iter_rels,szOpcPackage.iter_relsc#s.tffdd x|D] }|VqWdS)z Generate exactly one reference to each of the parts in the package by performing a depth-first traversal of the rels graph. c3s^xX|jD]J}|jrq |j}||kr(q |||V|}x||D] }|VqHWq WdS)N)rrrrr)rrr r!r") walk_partsrrr%Gs z)OpcPackage.iter_parts..walk_partsN)list)rr!r)r%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_DOCUMENT)rrrrmain_document_partbszOpcPackage.main_document_partcCsJdd|D}x2tdt|dD]}||}||kr&t|Sq&WdS)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(rrrr,szOpcPackage.part_related_bycCsdd|DS)zd Return a list containing a reference to each of the parts in this package. cSsg|]}|qSrr)r0r!rrr 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 rZbaseURI)rrrrrszOpcPackage.relscCs.x|jD] }|qWt||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)rBZbefore_marshalr writer)rr=r!rrrsaves  zOpcPackage.savecCs>y |tjStk r8t|}||tj|SXdS)z |CorePropertiesPart| object related to this package. Creates a default core properties part if one is not present (not common). N)r,r-ZCORE_PROPERTIESKeyErrorr defaultrC)rZcore_properties_partrrrrs   z OpcPackage._core_properties_part)F)__name__ __module__ __qualname____doc__rrpropertyrr$r'r+r.r8 classmethodr@r,rBrCrrrEr __classcell__rr)rrrs        rc@s4eZdZdZeddZeddZeddZdS) r:zHHosts static methods for unmarshalling a package from a |PackageReader|.cCsBt|||}t|||x|D] }|q&W|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)r>r? part_factoryrBr!rrrr;s   zUnmarshaller.unmarshalcCs6i}x,|D] \}}}}||||||||<qW|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)r>r?rQrBr/ content_typer(ZblobrrrrOs zUnmarshaller._unmarshal_partscCsZxT|D]H\}}|dkr|n||}|jr2|jn||j}||j||j|jq WdS)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_partnamer+r(r*)r>r?rBZ source_uriZsrelrr)rrrrPs   z%Unmarshaller._unmarshal_relationshipsN)rHrIrJrK staticmethodr;rOrPrrrrr:s  r:N)rK __future__rrrrZdocx.opc.constantsrr-Zdocx.opc.packurirrZ docx.opc.partr Zdocx.opc.parts.corepropsr Zdocx.opc.pkgreaderr Zdocx.opc.pkgwriterr Z docx.opc.relr Zdocx.opc.sharedrobjectrr:rrrrs       ,