o P+ i"@sdZddlmZddlmZmZmZmZddlm Z ddl m Z m Z ddlmZddlmZddlmZdd lmZdd lmZdd lmZer`dd lmZdd lmZddlmZddlmZGdddZ GdddZ!dS)z8Objects that implement reading and writing OPC packages.) annotations)IO TYPE_CHECKINGIteratorcast)RELATIONSHIP_TYPE) PACKAGE_URIPackURI) PartFactory)CorePropertiesPart) PackageReader) PackageWriter) Relationships) lazyproperty)Self)CoreProperties)Part) _Relationshipc@seZdZdZddZed4ddZd5d d Zd6d d Zd7d8ddZ eddZ d9ddZ e d:d!d"Z d;d$d%Zedd.d/Zed?d1d2Zd3S)@ 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. cCsdS)zEntry point for any post-unmarshaling processing. May be overridden by subclasses without forwarding call to super. Nselfrr\/home/app/PaddleOCR-VL-test/.venv_paddleocr/lib/python3.10/site-packages/docx/opc/package.pyafter_unmarshalszOpcPackage.after_unmarshalreturnrcCs|jjS)zl|CoreProperties| object providing read/write access to the Dublin Core properties for this document.)_core_properties_partcore_propertiesrrrrr(szOpcPackage.core_propertiesIterator[_Relationship]c#s, d d fdd |D]}|VqdS) zGenerate exactly one reference to each relationship in the package by performing a depth-first traversal of the rels graph.NsourceOpcPackage | Partvisitedlist[Part] | Nonerrc3sh|durgn|}|jD]#}|V|jrq|j}||vrq|||}||D]}|Vq+qdSNrelsvalues is_externalZ target_partappendrr relpartZ new_source walk_relsrrr,2s z'OpcPackage.iter_rels..walk_relsr")rrr r!rrr)rr)rr+r iter_rels.s  zOpcPackage.iter_relsIterator[Part]c#s*gffdd |D]}|Vq dS)zGenerate 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#qdSr"r#r( walk_partsrrr0Is z)OpcPackage.iter_parts..walk_partsNr)rr*rr/r iter_partsEs  zOpcPackage.iter_partsFreltypestrtarget Part | strrIdr&boolcCs|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. )r$Zadd_relationship)rr2r4r6r&rrrload_relYszOpcPackage.load_relcCs |tjS)aReturn 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_partcs zOpcPackage.main_document_parttemplater cCsJdd|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 usz+OpcPackage.next_partname..N)r1rangelenr )rr<Z partnamesnZcandidate_partnamerrr next_partnamems zOpcPackage.next_partnamepkg_filestr | IO[bytes]rcCs"t|}|}t||t|S)zGReturn an |OpcPackage| instance loaded with the contents of `pkg_file`.)r from_file Unmarshaller unmarshalr )clsrF pkg_readerpackagerrropen{s zOpcPackage.openrcCs |j|S)zReturn 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. )r$Zpart_with_reltype)rr2rrrr9s zOpcPackage.part_related_by list[Part]cCs t|S)zJReturn a list containing a reference to each of the parts in this package.)listr1rrrrpartss zOpcPackage.partsr*cCs|j||}|jS)zReturn rId key of new or existing relationship to `part`. If a relationship of `reltype` to `part` already exists, its rId is returned. Otherwise a new relationship is created and that rId is returned. )r$Z get_or_addr6)rr*r2r)rrr relate_toszOpcPackage.relate_tocCs ttjS)ztReturn a reference to the |Relationships| instance holding the collection of relationships for this package.)rrZbaseURIrrrrr$s zOpcPackage.relscCs*|jD]}|qt||j|jdS)znSave this package to `pkg_file`. `pkg_file` can be either a file-path or a file-like object. N)rQZbefore_marshalr writer$)rrFr*rrrsaves  zOpcPackage.saver cCsDz tt|tjWSty!t|}||tj|YSw)z|CorePropertiesPart| object related to this package. Creates a default core properties part if one is not present (not common). )rr r9r:ZCORE_PROPERTIESKeyErrordefaultrR)rZcore_properties_partrrrrs  z OpcPackage._core_properties_partN)rr)rr)rr.)F)r2r3r4r5r6r3r&r7)r<r3rr )rFrGrr)r2r3rr)rrO)r*rr2r3)rFrG)rr )__name__ __module__ __qualname____doc__rpropertyrr-r1r8r;rE classmethodrNr9rQrRrr$rTrrrrrrs,             rc@s4eZdZdZeddZeddZeddZdS) rIzHHosts static methods for unmarshalling a package from a |PackageReader|.cCs>t|||}t||||D]}|q|dS)zConstruct 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)rI_unmarshal_parts_unmarshal_relationshipsr%r)rLrM part_factoryrQr*rrrrJs    zUnmarshaller.unmarshalcCs2i}|D]\}}}}||||||||<q|S)zReturn 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)rLrMr_rQr= content_typer2Zblobrrrr]szUnmarshaller._unmarshal_partscCsV|D]$\}}|dkr|n||}|jr|jn||j}||j||j|jqdS)zAdd 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_srelsr&Z target_refZtarget_partnamer8r2r6)rLrMrQZ source_uriZsrelrr4rrrr^s z%Unmarshaller._unmarshal_relationshipsN)rWrXrYrZ staticmethodrJr]r^rrrrrIs   rIN)"rZ __future__rtypingrrrrZdocx.opc.constantsrr:Zdocx.opc.packurirr Z docx.opc.partr Zdocx.opc.parts.corepropsr Zdocx.opc.pkgreaderr Zdocx.opc.pkgwriterr Z docx.opc.relrZ docx.sharedrZtyping_extensionsrZdocx.opc.corepropsrrrrrIrrrrs&