jdZddlmZddlmZmZddlmZddl m Z ddl m Z ddl mZddlmZdd lmZGd d ZGd d ZdS)z8Objects that implement reading and writing OPC packages.)RELATIONSHIP_TYPE) PACKAGE_URIPackURI) PartFactory)CorePropertiesPart) PackageReader) PackageWriter) Relationships) lazypropertyceZdZdZfdZdZedZdZdZ ddZ ed Z d Z e d Zd Zed ZdZedZdZedZxZS) 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. cVtt|dSN)superr __init__)self __class__s Z/lsinfo/ai/hellotax_ai/base_platform/venv/lib/python3.11/site-packages/docx/opc/package.pyrzOpcPackage.__init__s% j$((*****cdS)zEntry point for any post-unmarshaling processing. May be overridden by subclasses without forwarding call to super. Nrs rafter_unmarshalzOpcPackage.after_unmarshals  rc|jjS)zl|CoreProperties| object providing read/write access to the Dublin Core properties for this document.)_core_properties_partcore_propertiesrs rrzOpcPackage.core_properties s)99rc#<Kdfd |D]}|VdS)zGenerate exactly one reference to each relationship in the package by performing a depth-first traversal of the rels graph.Nc3K|gn|}|jD]D}|V|jr|j}||vr|||}||D]}|VEdSrrelsvalues is_external target_partappend)sourcevisitedrelpart new_source walk_relss rr*z'OpcPackage.iter_rels..walk_rels*s#ObbG{))++   ?7??t$$$! $9Z99CIIII  rrr)rr'r*s @r iter_relszOpcPackage.iter_rels&sS      9T??  CIIII  rc#>Kgffd |D]}|VdS)zGenerate exactly one reference to each of the parts in the package by performing a depth-first traversal of the rels graph.c3K|jD]D}|jr |j}||vr|||V|}||D]}|VEdSrr)r%r&r'r(r) walk_partss rr.z)OpcPackage.iter_parts..walk_parts?s{))++  ?7??t$$$ ! &Jz7;;DJJJJ  rNr)rr(r.s @r iter_partszOpcPackage.iter_parts;sZ(*      Jt$$  DJJJJ  rFc<|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 add_relationship)rreltypetargetrIdr"s rload_relzOpcPackage.load_relOs y))'63 LLLrc@|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_byRTOFFICE_DOCUMENTrs rmain_document_partzOpcPackage.main_document_partYs##B$6777rcd|D}tdt|dzD]}||z}||vrt|cSdS)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" ch|] }|j Sr)partname).0r(s r z+OpcPackage.next_partname..ksAAAtT]AAArN)r/rangelenr)rtemplate partnamesncandidate_partnames r next_partnamezOpcPackage.next_partnamecsBAt/@/@AAA q#i..1,-- 3 3A!)A !221222223 3 3rctj|}|}t||t|S)zGReturn an |OpcPackage| instance loaded with the contents of `pkg_file`.)r from_file Unmarshaller unmarshalr)clspkg_file pkg_readerpackages ropenzOpcPackage.openqs<#,X66 #%%z7K@@@rc6|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 part_with_reltype)rr2s rr7zOpcPackage.part_related_byys y**7333rcDt|S)zJReturn a list containing a reference to each of the parts in this package.)listr/rs rpartszOpcPackage.partssDOO%%&&&rcF|j||}|jS)zReturn rId key of relationship to `part`, from the existing relationship if there is one, otherwise a newly created one.)r get_or_addr4)rr(r2r's r relate_tozOpcPackage.relate_tos"i""7D11wrc4ttjS)ztReturn a reference to the |Relationships| instance holding the collection of relationships for this package.)r rbaseURIrs rr zOpcPackage.relss[0111rc|jD]}|tj||j|jdS)zvSave this package to `pkg_file`, where `file` can be either a path to a file (a string) or a file-like object.N)rVbefore_marshalr writer )rrNr(s rsavezOpcPackage.savesIJ " "D    ! ! ! !Hdi<<<<rs>>66666611111111%%%%%%777777,,,,,,,,,,,,&&&&&&((((((W(W(W(W(W(W(W(W(t)N)N)N)N)N)N)N)N)N)Nr