PqhdZddlmZddlmZmZddlmZddl m Z ddl m Z ddl mZddlmZdd lmZGd d ZGd d Zy)z8Objects that implement reading and writing OPC packages.)RELATIONSHIP_TYPE) PACKAGE_URIPackURI) PartFactory)CorePropertiesPart) PackageReader) PackageWriter) Relationships) lazypropertyceZdZdZfdZdZedZdZdZ ddZ edZ d Z e d Zd Zed Zd ZedZdZedZxZS) 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. c*tt| yN)superr __init__)self __class__s Q/srv/www/ollama/chat-ollama/venv/lib/python3.12/site-packages/docx/opc/package.pyrzOpcPackage.__init__s j$(*cy)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))999rc#<Kdfd |D]}|yw)zGenerate exactly one reference to each relationship in the package by performing a depth-first traversal of the rels graph.Nc3K|gn|}|jjD]I}||jr|j}||vr%|j ||}||D]}|Kywrrelsvalues is_external target_partappend)sourcevisitedrelpart new_source walk_relss rr*z'OpcPackage.iter_rels..walk_rels*s|#ObG{{))+  ??7?t$! $Z9CI sA.A1rr)rr'r*s @r iter_relszOpcPackage.iter_rels&s& T? CI sc#>Kgffd |D]}|yw)zGenerate exactly one reference to each of the parts in the package by performing a depth-first traversal of the rels graph.c3K|jjD]I}|jr|j}||vr!|j |||}||D]}|Kywrr)r%r&r'r(r) walk_partss rr.z)OpcPackage.iter_parts..walk_parts?sq{{))+ ??7?t$ ! &z7;DJ sA(A+Nr)rr(r.s @r iter_partszOpcPackage.iter_parts;s,(* t$ DJ sc>|jj||||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_relOsyy))'63 LLrc@|jtjS)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$6$677rc|jDchc]}|j}}tdt|dzD]}||z}||vs t |cSycc}w)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" N)r/partnamerangelenr)rtemplater( partnamesncandidate_partnames r next_partnamezOpcPackage.next_partnamecse04/@AtT]]A Aq#i.1,- 3A!)A !2122 3BsActtj|}|}tj||t|S)zGReturn an |OpcPackage| instance loaded with the contents of `pkg_file`.)r from_file Unmarshaller unmarshalr)clspkg_file pkg_readerpackages ropenzOpcPackage.openqs2#,,X6 %z7K@rc8|jj|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 yy**733rc4t|jS)zJReturn a list containing a reference to each of the parts in this package.)listr/rs rpartszOpcPackage.partssDOO%&&rcR|jj||}|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#ii""7D1wwrc4ttjS)ztReturn a reference to the |Relationships| instance holding the collection of relationships for this package.)r rbaseURIrs rr zOpcPackage.relss[0011rc|jD]}|jtj||j|jy)zvSave this package to `pkg_file`, where `file` can be either a path to a file (a string) or a file-like object.N)rSbefore_marshalr writer )rrKr(s rsavezOpcPackage.saves=JJ "D    ! "Hdii content_typer2blobs rrkzUnmarshaller._unmarshal_partssJ5?5K5K5M  1HlGT*,wE(O  rc|jD]j\}}|dk(r|n||}|jr |jn||j}|j |j ||j |jly)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) iter_srelsr" target_reftarget_partnamer5r2r4)rLrMrS source_urisrelr%r3s rrlz%Unmarshaller._unmarshal_relationshipssy !+ 5 5 7 N J *c 1WuZ7HF#'#3#3t?S?S9T  OODLL&$((Drs9>61%7,,&(W(W(t)N)Nr