o 7h,@s>dZddlmZddlZddlZddlZddlmZmZm Z m Z m Z ddl m Z ddlmZddlmZmZddlmZmZmZdd lmZdd lmZdd lmZer\dd lmZm Z Gd dde e!Z"GdddZ#Gddde eZ$Gddde$Z%Gddde$Z&GdddZ'Gddde'Z(GdddZ)dS)zKAPI for reading/writing serialized Open Packaging Convention (OPC) package.) annotationsN)IO TYPE_CHECKINGAny ContainerSequence)PackageNotFoundError) CONTENT_TYPE)CT_Typesserialize_part_xml)CONTENT_TYPES_URI PACKAGE_URIPackURI)CaseInsensitiveDict)default_content_types) lazyproperty)Part_Relationshipsc@sFeZdZdZdddZdd d ZdddZdddZedddZ dS) PackageReaderzProvides access to package-parts of an OPC package with dict semantics. The package may be in zip-format (a .pptx file) or expanded into a directory structure, perhaps by unzipping a .pptx file. pkg_filestr | IO[bytes]cC ||_dSN _pkg_fileselfrr[/var/www/html/figdemos/bartoux_crm/venv/lib/python3.10/site-packages/pptx/opc/serialized.py__init__ zPackageReader.__init__pack_uriobjectreturnboolcC ||jvS)zEReturn True when part identified by `pack_uri` is present in package. _blob_readerrr!rrr __contains__  zPackageReader.__contains__rbytescCs |j|S)z2Return bytes for part corresponding to `pack_uri`.r&r(rrr __getitem__$r*zPackageReader.__getitem__partname bytes | NonecCs"|j|j}}||vr||SdS)zReturn optional rels item XML for `partname`. Returns `None` if no rels item is present for `partname`. `partname` is a |PackURI| instance. N)r'rels_uri)rr-Z blob_readerurirrr rels_xml_for(szPackageReader.rels_xml_for_PhysPkgReadercCs t|jS)zC|_PhysPkgReader| subtype providing read access to the package file.)r2factoryrrrrrr'1s zPackageReader._blob_readerNrrr!r"r#r$r!rr#r+)r-rr#r.)r#r2) __name__ __module__ __qualname____doc__rr)r,r1rr'rrrrrs     rc@sPeZdZdZddd Zedd d ZdddZdddZdddZ dddZ dS) PackageWriteraWrites a zip-format OPC package to `pkg_file`. `pkg_file` can be either a path to a zip file (a string) or a file-like object. `pkg_rels` is the |_Relationships| object containing relationships for the package. `parts` is a sequence of |Part| subtype instance to be written to the package. Its single API classmethod is :meth:`write`. This class is not intended to be instantiated. rrpkg_relsrpartsSequence[Part]cCs||_||_||_dSr)r _pkg_rels_parts)rrr=r>rrrrAs zPackageWriter.__init__r#NonecCs||||dS)zWrite a physical package (.pptx file) to `pkg_file`. The serialized package contains `pkg_rels` and `parts`, a content-types stream based on the content type of each part, and a .rels file for each part that has relationships. N)_write)clsrr=r>rrrwriteFs zPackageWriter.writecCsPt|j}||||||WddS1s!wYdS)z$Write physical package (.pptx file).N)_PhysPkgWriterr3r_write_content_types_stream_write_pkg_rels _write_partsr phys_writerrrrrCQs    "zPackageWriter._writerKrFcCs|ttt|jdS)zWrite `[Content_Types].xml` part to the physical package. This part must contain an appropriate content type lookup target for each part in the package. N)rEr r _ContentTypesItemxml_forrArJrrrrGXsz)PackageWriter._write_content_types_streamcCs:|jD]}||j|j|jr||jj|jjqdS)zWrite blob of each part in `parts` to the package. A rels item for each part is also written when the part has relationships. N)rArEr-blob_relsr/relsxml)rrKpartrrrrIcs zPackageWriter._write_partscCs|tj|jjdS)zGWrite the XML rels item for `pkg_rels` ('/_rels/.rels') to the package.N)rEr r/r@rQrJrrrrHmszPackageWriter._write_pkg_relsN)rrr=rr>r?)rrr=rr>r?r#rB)r#rB)rKrFr#rB) r8r9r:r;r classmethodrErCrGrIrHrrrrr<7s     r<c@s2eZdZdZdddZdd d ZedddZdS)r2z/Base class for physical package reader objects.itemr"r#r$cCstdt|j)z%Must be implemented by each subclass.z%`%s` must implement `.__contains__()`NotImplementedErrortyper8)rrTrrrr)us z_PhysPkgReader.__contains__r!rr+cCtdt|jd)z*Blob for part corresponding to `pack_uri`.`z"` must implement `.__contains__()`rUr(rrrr,{z_PhysPkgReader.__getitem__rrcCsDt|ts t|Stj|rt|St|rt|St d|)zDReturn |_PhysPkgReader| subtype instance appropriage for `pkg_file`.zPackage not found at '%s') isinstancestr _ZipPkgReaderospathisdir _DirPkgReaderzipfile is_zipfilerrDrrrrr3s    z_PhysPkgReader.factoryN)rTr"r#r$r7)rrr#r2)r8r9r:r;r)r,rSr3rrrrr2rs   r2c@s.eZdZdZdddZdd d ZdddZdS)razImplements |PhysPkgReader| interface for OPC package extracted into directory. `path` is the path to a directory containing an expanded package. r_r\cCstj||_dSr)r^r_abspath_path)rr_rrrrsz_DirPkgReader.__init__r!r"r#r$cCs&t|tsdStjt|j|jS)IReturn True when part identified by `pack_uri` is present in zip archive.F) r[rr^r_exists posixpathjoinrf membernamer(rrrr)s z_DirPkgReader.__contains__rr+cCshtj|j|j}zt|d }|WdWS1swYWdSty3td|w)zFReturn bytes of file corresponding to `pack_uri` in package directory.rbNno member '%s' in package) r^r_rjrfrkopenreadIOErrorKeyError)rr!r_frrrr,s (  z_DirPkgReader.__getitem__N)r_r\r6r7)r8r9r:r;rr)r,rrrrras   rac@s<eZdZdZdddZdd d ZdddZedddZdS)r]z@Implements |PhysPkgReader| interface for a zip-file OPC package.rrcCrrrrrrrrr z_ZipPkgReader.__init__r!r"r#r$cCr%)rg)_blobsr(rrrr)r*z_ZipPkgReader.__contains__rr+cCs ||jvr td||j|S)zReturn bytes for part corresponding to `pack_uri`. Raises |KeyError| if no matching member is present in zip archive. rm)rsrqr(rrrr,s   z_ZipPkgReader.__getitem__dict[PackURI, bytes]csHt|jdfddDWdS1swYdS)z/dict mapping partname to package part binaries.rcs i|] }td||qS)z/%s)rro).0namezrr s z(_ZipPkgReader._blobs..N)rbZipFilernamelistr4rrxrrss$z_ZipPkgReader._blobsNr5r6r7)r#rt) r8r9r:r;rr)r,rrsrrrrr]s    r]c@s(eZdZdZedddZdd dZdS)rFz/Base class for physical package writer objects.rrr# _ZipPkgWritercCst|S)zReturn |_PhysPkgWriter| subtype instance appropriage for `pkg_file`. Currently the only subtype is `_ZipPkgWriter`, but a `_DirPkgWriter` could be implemented or even a `_StreamPkgWriter`. )r}rdrrrr3sz_PhysPkgWriter.factoryr!rrNr+rBcCrX)zDWrite `blob` to package with membername corresponding to `pack_uri`.rYz` must implement `.write()`rUrr!rNrrrrErZz_PhysPkgWriter.writeN)rrr#r}r!rrNr+r#rB)r8r9r:r;rSr3rErrrrrFs  rFc@sFeZdZdZdddZdddZdd d ZdddZedddZ dS)r}zMImplements |PhysPkgWriter| interface for a zip-file (.pptx file) OPC package.rrcCrrrrrrrrr z_ZipPkgWriter.__init__r#cCs|S)zFEnable use as a context-manager. Opening zip for writing happens here.rr4rrr __enter__sz_ZipPkgWriter.__enter__exc list[Any]rBcGs|jdS)zClose the zip archive on exit from context. Closing flushes any pending physical writes and releasing any resources it's using. N)_zipfclose)rrrrr__exit__sz_ZipPkgWriter.__exit__r!rrNr+cCs|j|j|dS)zHWrite `blob` to zip package with membername corresponding to `pack_uri`.N)rwritestrrkr~rrrrEsz_ZipPkgWriter.writezipfile.ZipFilecCstj|jdtjddS)z$`ZipFile` instance open for writing.wF) compressionstrict_timestamps)rbr{r ZIP_DEFLATEDr4rrrrs z_ZipPkgWriter._zipfNr5)r#r})rrr#rBr)r#r) r8r9r:r;rrrrErrrrrrr}s    r}c@sDeZdZdZdddZeddd Zedd d Zedd dZ dS)rLzNComposes content-types "part" ([Content_Types].xml) for a collection of parts.r>r?cCrr)rA)rr>rrrrr z_ContentTypesItem.__init__r#r cCs ||jS)zReturn content-types XML mapping each part in `parts` to a content-type. The resulting XML is suitable for storage as `[Content_Types].xml` in an OPC package. )_xml)rDr>rrrrMs z_ContentTypesItem.xml_forcCsZ|j\}}t}t|D] \}}|||qt|D] \}}|||q |S)alxml.etree._Element containing the content-types item. This XML object is suitable for serialization to the `[Content_Types].xml` item for an OPC package. Although the sequence of elements is not strictly significant, as an aid to testing and readability Default elements are sorted by extension and Override elements are sorted by partname. )_defaults_and_overridesr newsorteditems add_default add_override)rdefaults overridesZ _types_elmext content_typer-rrrrs z_ContentTypesItem._xml)tuple[dict[str, str], dict[PackURI, str]]cCs^ttjtjd}i}|jD]}|j|j}}|j}||ft vr&|||<q |||<q ||fS)zpair of dict (defaults, overrides) accounting for all parts. `defaults` is {ext: content_type} and overrides is {partname: content_type}. )rPrQ) rCTOPC_RELATIONSHIPSXMLrAr-rrlowerr)rrrrRr-rrrrrrs   z)_ContentTypesItem._defaults_and_overridesN)r>r?)r>r?r#r )r#r )r#r) r8r9r:r;rrSrMrrrrrrrrLs   rL)*r; __future__rr^rirbtypingrrrrrpptx.excrpptx.opc.constantsr r pptx.opc.oxmlr r pptx.opc.packurir r rpptx.opc.sharedrZ pptx.opc.specr pptx.utilrpptx.opc.packagerrr+rr<r2rar]rFr}rLrrrrs.      !;!