~ZinuSrSSKJr SSKrSSKJrJrJrJrJ r J r J r SSK J r SSK Jr SSKJrJr SSKJrJrJr SS KJrJr SS KJr SS KJr SS KJ r \(a SS K!J"r" SSKJ#r#J$r$ SSK%J&r& SSK'J(r( SSK)J*r* "SS5r+"SS\+5r,"SS5r-"SS\+5r."SS\.5r/"SS5r0"SS5r1"S S!\ \2S"45r3"S#S"5r4g)$zFundamental Open Packaging Convention (OPC) objects. The :mod:`pptx.packaging` module coheres around the concerns of reading and writing presentations to and from a .pptx file. ) annotationsN)IO TYPE_CHECKING DefaultDictIteratorMappingSetcast)RELATIONSHIP_TARGET_MODE)RELATIONSHIP_TYPE)CT_Relationshipsserialize_part_xml)CONTENT_TYPES_URI PACKAGE_URIPackURI) PackageReader PackageWriter)CaseInsensitiveDict) parse_xml) lazyproperty)Self)CT_RelationshipCT_Types)BaseOxmlElement)Package)PresentationPartcX\rSrSrSrS SjrS S SjjrS SjrSSjr\ SSj5r Sr g )_RelatableMixinzHProvide relationship methods required by both the package and each part.c8URRU5$)zReturn (single) part having relationship to this package of `reltype`. Raises |KeyError| if no such relationship is found and |ValueError| if more than one such relationship is found. )_relspart_with_reltype)selfreltypes j/var/www/eduai.edurigo.com/question_generate/ques_gen_env/lib/python3.13/site-packages/pptx/opc/package.pypart_related_by_RelatableMixin.part_related_by!s zz++G44c[U[5(a$U(deURRX!5$URR X!5$)zReturn rId key of relationship of `reltype` to `target`. If such a relationship already exists, its rId is returned. Otherwise the relationship is added and its new rId returned. ) isinstancestrr!get_or_add_ext_rel get_or_add)r#targetr$ is_externals r% relate_to_RelatableMixin.relate_to)sC fc " " ;::00A Azz$$W55r(c4URUR$)z2Return related |Part| subtype identified by `rId`.)r! target_partr#rIds r% related_part_RelatableMixin.related_part5szz#***r(c4URUR$)zGReturn URL contained in target ref of relationship identified by `rId`.)r! target_refr4s r%r9_RelatableMixin.target_ref9szz#)))r(cD[S[U5R-5e)zJ|_Relationships| object containing relationships from this part to others.z`%s` must implement `.rels`)NotImplementedErrortype__name__r#s r%r!_RelatableMixin._rels=s#" )DJ,?,? ?  r(Nr$r+returnPartF)r. Part | strr$r+r/boolrCr+)r5r+rCrD)r5r+rCr+rC_Relationships) r> __module__ __qualname____firstlineno____doc__r&r0r6r9rr!__static_attributes__rAr(r%rrs-R5 6+*  r(rc\rSrSrSrSSjr\SSj5rSSjrSSjr SSjr \ SSj5r SS jr SS jrSS jr\SS j5rS rg) OpcPackageEzMain API class for |python-opc|. A new instance is constructed by calling the :meth:`open` classmethod with a path to a package file or file-like object containing a package (.pptx file). cXlgN _pkg_filer#pkg_files r%__init__OpcPackage.__init__L!r(c.U"U5R5$)zGReturn an |OpcPackage| instance loaded with the contents of `pkg_file`._load)clsrWs r%openOpcPackage.openOs8}""$$r(c:URRU5 g)z(Remove relationship identified by `rId`.Nr!popr4s r%drop_relOpcPackage.drop_relTs sr(c## [5nUR5H>nUR(aMURnX1;aM)Uv UR U5 M@ g7f)z;Generate exactly one reference to each part in the package.N)set iter_relsr/r3add)r#visitedrelparts r% iter_partsOpcPackage.iter_partsXsI U>>#C??DJ KK $sAA c#n^^# [5mSUU4SjjmT"UR5ShvN gN7f)zuGenerate exactly one reference to each relationship in package. Performs a depth-first traversal of the rels graph. c3># UR5HYnUv UR(aMURnUT;aM.TRU5 T"UR5ShvN M[ gN 7frS)valuesr/r3rirels)rrrkrlrj walk_relss r%rs'OpcPackage.iter_rels..walk_relsks]{{} ??7? D!$TYY///%0sA%A4(A2) A4N)rrrIrCIterator[_Relationship])rgr!)r#rjrss @@r%rhOpcPackage.iter_relsds- !U 0 0 TZZ(((s )535cT[SUR[R55$)zzReturn |Part| subtype serving as the main document part for this package. In this case it will be a |Presentation| part. r)r r&RTOFFICE_DOCUMENTr?s r%main_document_partOpcPackage.main_document_part}s# &(<(S>STZ>[ZQZZ): \s9~)1b1A!% !21222JKK ]s #B$B$ct[R"XR[UR 555 g)zjSave this package to `pkg_file`. `file` can be either a path to a file (a string) or a file-like object. N)rwriter!tuplermrVs r%saveOpcPackage.saves$ Hjj%8I2JKr(c[RUR[SU55upURR [ X5 U$)z=Return the package after loading all parts and relationships.r)_PackageLoaderloadrUr r! load_from_xmlr)r# pkg_xml_relspartss r%r]OpcPackage._loads<,11$..$yRVBWX    lB r(c4[[R5$)z@|Relationships| object containing relationships of this package.)rIrbaseURIr?s r%r!OpcPackage._relssk1122r(rTN)rWstr | IO[bytes])rWrrCrr5r+rCNone)rCzIterator[Part])rCru)rCr)rr+rCr)rWrrCr)rCrrH)r>rJrKrLrMrX classmethodr_rdrmrhpropertyrzrrr]rr!rNrAr(r%rPrPEsj "%% )2RRL$L 33r(rPc\rSrSrSrS Sjr\SSj5rSSjr\ SSj5r \ SSj5r \ SSj5r \ SS j5r SS jrS rg )rz@Function-object that loads a package from disk (or other store).cXlX lgrS)rU_package)r#rWpackages r%rX_PackageLoader.__init__s ! r(c.U"X5R5$)aReturn (pkg_xml_rels, parts) pair resulting from loading `pkg_file`. The returned `parts` value is a {partname: part} mapping with each part in the package included and constructed complete with its relationships to other parts in the package. The returned `pkg_xml_rels` value is a `CT_Relationships` object containing the parsed package relationships. It is the caller's responsibility (the package object) to load those relationships into its |_Relationships| object. r\)r^rWrs r%r_PackageLoader.loads8%++--r(cURURp!UR5Hup4URX#U5 M U[U4$)zBReturn (pkg_xml_rels, parts) pair resulting from loading pkg_file.)_parts _xml_relsitemsload_rels_from_xmlr)r#rxml_relsrrls r%r]_PackageLoader._loadsH++t~~x#kkmNH  # #H$6 >, $e++r(cN[RUR[5$)z|_ContentTypeMap| object providing content-types for items of this package. Provides a content-type (MIME-type) for any given partname. )_ContentTypeMapfrom_xml_package_readerrr?s r%_content_types_PackageLoader._content_typess! ''(<(<=N(OPPr(c,[UR5$)zE|PackageReader| object providing access to package-items in pkg_file.)rrUr?s r%r_PackageLoader._package_readersT^^,,r(c URnURnURnSUR5Vs0sHnXC;dM U[ UXUX4S9_M sn$s snf)a5dict {partname: Part} populated with parts loading from package. Among other duties, this collection is passed to each relationships collection so each relationship can resolve a reference to its target part when required. This reference can only be reliably carried out once the all parts have been loaded. c34# UHoS:wdM Uv M g7f)/NrA).0rs r% (_PackageLoader._parts..sC1s(QQs  )blob)rrrr PartFactory)r# content_typesrpackage_readerrs r%r_PackageLoader._partss++ ----DC  D) Hk'#-   D   s AAc|^^^^0m[5mSUUUU4SjjmT"[TR[55 T$)zdict {partname: xml_rels} for package and all package parts. This is used as the basis for other loading operations such as loading parts and populating their relationships. c0>UTU'TRU5 URnURHcnUR[R :XaM#[ R"X#R5nUT;aMKT"UTRU55 Me g)zAPopulate `xml_rels` dict by traversing relationships depth-first.N) rirrelationship_lst targetModeRTMEXTERNALr from_rel_refr9 _xml_rels_for) source_partnamerrbase_urirktarget_partname load_relsr#visited_partnamesrs r%r+_PackageLoader._xml_rels..load_relss(,H_ %  ! !/ 2&..H,,>>S\\1")"6"6x"P"&77/4+=+=o+NO -r()rrrrr )rgrr)r#rrrs`@@@r%r_PackageLoader._xml_relss:57*-% P P +t11+>?r(cURRU5nUc[R"5$[ [[ U55$)zReturn CT_Relationships object formed by parsing rels XML for `partname`. A CT_Relationships object is returned in all cases. A part that has no relationships receives an "empty" CT_Relationships object, i.e. containing no `CT_Relationship` objects. )r rels_xml_forr newr r)r#rrels_xmls r%r_PackageLoader._xml_rels_for sL ''44X>  " & ((;< r()rrUN)rWrrr)rWrrrrC,tuple[CT_Relationships, dict[PackURI, Part]])rCr)rCr)rCr)rCdict[PackURI, Part])rCzdict[PackURI, CT_Relationships])rrrCr )r>rJrKrLrMrXrrr]rrrrrrrNrAr(r%rrsJ  .& .18 . 5 . .,QQ--  06  r(rc&\rSrSrSrSSSjjr\SSj5r\SSj5r \ RSSj5r \ SSj5r SS jr \ SS j5r\SS j5r\RSS j5r\ SS j5rSSjr\ SSj5rSrg)rDizBase class for package parts. Provides common properties and methods, but intended to be subclassed in client code to implement specific part behaviors. Also serves as the default class for parts that are not yet given specific behaviors. Nc4XlX lX0lX@lgrS) _partname _content_typer_blob)r#r content_typerrs r%rX Part.__init__!s")  r(cU"XX45$)zReturn `cls` instance loaded from arguments. This one is a straight pass-through, but subtypes may do some pre-processing, see XmlPart for an example. rAr^rrrrs r%r Part.load*s8799r(c,UR=(d S$)zContents of this package part as a sequence of bytes. Intended to be overridden by subclasses. Default behavior is to return the blob initial loaded during `Package.open()` operation. r(rr?s r%r Part.blob3szz S r(cXlg)zNote that not all subclasses use the part blob as their blob source. In particular, the |XmlPart| subclass uses its `self._element` to serialize a blob on demand. This works fine for binary parts though. Nr)r#rs r%rr<s  r(cUR$)z&Content-type (MIME-type) of this part.)rr?s r%rPart.content_typeEs!!!r(cdURRURRX5 g)a4load _Relationships for this part from `xml_rels`. Part references are resolved using the `parts` dict that maps each partname to the loaded part with that partname. These relationships are loaded from a serialized package and so already have assigned rIds. This method is only used during package loading. N)r!rrr)r#rrs r%rPart.load_rels_from_xmlJs"   !7!7Ir(cUR$)zPackage this part belongs to.)rr?s r%r Part.packageS}}r(cUR$)z@|PackURI| partname for this part, e.g. "/ppt/slides/slide1.xml".)rr?s r%r Part.partnameXs~~r(c|[U[5(d![S[U5R-5eXlg)Nz.partname must be instance of PackURI, got '%s')r*r TypeErrorr=r>rr#rs r%rr]s5(G,,@4>CZCZZ "r(cUR$)z:Collection of relationships from this part to other parts.r!r?s r%rr Part.relseszzr(c[U[5(a&[US5nUR5sSSS5 $[ [ US55(aUR S5 UR5$!,(df  NI=f)zIReturn bytes of `file`, which is either a str path or a file-like object.rbNseekr)r*r+r_readcallablegetattrr)r#filefs r%_blob_from_filePart._blob_from_fileksb dC dD!Qvvx"! GD&) * * IIaLyy{"!s A77 Bc@[URR5$)z'Relationships from this part to others.)rIrrr?s r%r! Part._relsxsdnn4455r()rrrrrS)rrrr+rrrz bytes | None) rrrr+rrrbytesrCrrCr)rrrCr+)rr rrrCr)rCrrCr)rrrH)rrrCr)r>rJrKrLrMrXrrrrsetterrrrrrrrrr!rNrAr(r%rDrDs\`/2=DLX::!! [[""J__"" 66r(rDc^\rSrSrSrS U4Sjjr\S Sj5r\S Sj5r S Sjr \S5r SSjr S r U=r$)XmlParti~zBase class for package parts containing an XML payload, which is most of them. Provides additional methods to the |Part| base class that take care of parsing and reserializing the XML payload and managing relationships to other parts. c:>[[U] XU5 X@lgrS)superr rX_element)r#rrrelement __class__s r%rXXmlPart.__init__s gt%hgF r(c 8U"XU[S[U55S9$)zrJrKrLrMrXrrrrrdrlrrN __classcell__)rs@r%r r ~sz   /2 =D O^   11  __r(r cF\rSrSr%Sr0rS\S'S Sjr\S Sj5r Sr g) rizConstructs a registered subtype of |Part|. Client code can register a subclass of |Part| to be used for a package blob based on its content type. zdict[str, type[Part]] part_type_forcHURU5nURXX45$rS) _part_cls_forr)r^rrrr PartClasss r%__new__PartFactory.__new__s#%%l3 ~~hgDDr(cJXR;aURU$[$)zReturn the custom part class registered for `content_type`. Returns |Part| if no custom class is registered for `content_type`. )r"rD)r^rs r%r$PartFactory._part_cls_fors& ,, ,$$\2 2 r(rAN) rrrr+rrrrrCrD)rr+rCz type[Part]) r>rJrKrLrMr"__annotations__r&rr$rNrAr(r%rrs. ,.M(-Er(rc@\rSrSrSrSSjrS Sjr\S Sj5rSr g) rizLValue type providing dict semantics for looking up content type by partname.cXlX lgrS) _overrides _defaults)r# overridesdefaultss r%rX_ContentTypeMap.__init__s #!r(c,[U[5(d![S[U5R-5eXR ;aUR U$UR UR;aURUR $[SU-5e)zBReturn content-type (MIME-type) for part identified by *partname*.z4_ContentTypeMap key must be , got %sz8no content-type for partname '%s' in [Content_Types].xml) r*rrr=r>r-extr.KeyErrorrs r% __getitem___ContentTypeMap.__getitem__s~(G,,FhI`I``   &??8, , <<4>> )>>(,,/ /QT\\]]r(c[S[U55n[SUR55n[SUR55nU"X45$)zEReturn |_ContentTypeMap| instance populated from `content_types_xml`.rc3l# UH*oRR5UR4v M, g7frS)partNamelower contentType)ros r%r+_ContentTypeMap.from_xml..s(( 9OAZZ    /9O24c3l# UH*oRR5UR4v M, g7frS) extensionr:r;)rds r%rr=s(' :OQ[[   !-- 0:Or>)r rr override_lst default_lst)r^content_types_xml types_elmr/r0s r%r_ContentTypeMap.from_xmls_Y/@%AB '( 9B9O9O(  '' :C:O:O'  9''r()r.r-N)r/dict[str, str]r0rG)rrrCr+)rDrrCr) r>rJrKrLrMrXr5rrrNrAr(r%rrs$V" ^ ( (r(rc\rSrSrSrSSjrSSjrSSjrSSjrSSjr SSjr SS jr SS jr SS jr SS jr\S 5rSSSjjrSS Sjjr\S!Sj5r\S"Sj5r\S#Sj5rSrg)$rIiaCollection of |_Relationship| instances having `dict` semantics. Relationships are keyed by their rId, but may also be found in other ways, such as by their relationship type. |Relationship| objects are keyed by their rId. Iterating this collection has normal mapping semantics, generating the keys (rIds) of the mapping. `rels.keys()`, `rels.values()`, and `rels.items() can be used as they would be for a `dict`. cXlgrS _base_uri)r#rs r%rX_Relationships.__init__rZr(cXR;$)z9Implement 'in' operation, like `"rId7" in relationships`.rr4s r% __contains___Relationships.__contains__sjj  r(cZURU$![a [SU-5ef=f)zJImplement relationship lookup by rId using indexed access, like rels[rId].zno relationship with key '%s')r!r4r4s r%r5_Relationships.__getitem__s8 B::c? " B:S@A A Bs*c,[UR5$)zDImplement iteration of rIds (iterating a mapping produces its keys).)iterr!r?s r%__iter___Relationships.__iter__sDJJr(c,[UR5$)z,Return count of relationships in collection.)rr!r?s r%__len___Relationships.__len__ s4::r(cPURX5nUcURX5$U$)zReturn str rId of `reltype` to `target_part`. The rId of an existing matching relationship is used if present. Otherwise, a new relationship is added and that rId is returned.  _get_matching_add_relationship)r#r$r3 existing_rIds r%r-_Relationships.get_or_adds4 ))'? # TRHcnUR[R:Xa)[R "TUR 5nUT;aMJ[RTUT5v Me g7f)z?Filter out broken relationships such as those pointing to NULL.N) rrrINTERNALrrr9 _Relationshipr)rel_elmrrrrs r%iter_valid_rels5_Relationships.load_from_xml..iter_valid_rels+sb#44 %%5&33Hg>P>PQHu, #,,XwFF5sA5A8c3<# UHoRU4v M g7frS)r5)rrks r%r/_Relationships.load_from_xml..9sF4ES77C.4EsN)r!clearupdate)r#rrrrfs ``` r%r_Relationships.load_from_xml&s6 G  FO4EFFr(cURUn[U5S:Xa[SU-5e[U5S:a[SU-5eUSR$)zReturn target part of relationship with matching `reltype`. Raises |KeyError| if not found and |ValueError| if more than one matching relationship is found. rz*no relationship of type '%s' in collectionrz1multiple relationships of type '%s' in collection)_rels_by_reltyperr4 ValueErrorr3)r#r$rels_of_reltypes r%r" _Relationships.part_with_reltype;sb //8  1 $G'QR R  ! #PSZZ[ [q!---r(c8URRU5$)zReturn |_Relationship| identified by `rId` after removing it from collection. The caller is responsible for ensuring it is no longer required. rbr4s r%rc_Relationships.popKs zz~~c""r(c^[R"5nU4SjnU"5H?nURURURUR UR 5 MA UR$)zbytes XML serialization of this relationship collection. This value is suitable for storage as a .rels file in an OPC package. Includes a `[STR555nU4SjU5$)Nc3# UHEnURS5(a&USSR5(a[USS5OSU4v MG g7f)r5Nr)risdigitr)rr5s r%rK_Relationships.xml..iter_rels_in_numerical_order..^sP* 'C%(NN5$9$9c!"goo>O>OCABLUV'sA Ac32># UH upTUv M g7frSrA)r_r5r#s r%rryesA,@&!DI,@s)sortedkeys)sorted_num_rId_pairsr#s r%iter_rels_in_numerical_order8_Relationships.xml..iter_rels_in_numerical_order]s2#)*  99; *$ B,@A Ar()r radd_relr5r$r9r/xml_file_bytes)r#rels_elmrrks` r%xml_Relationships.xmlRsZ$'') B01C   SWWckk3>>3?? S2&&&r(cURn[URUUU(a[RO[R US9UR U'U$)z6Return str rId of |_Relationship| newly added to spec.) target_moder.) _next_rIdrdrKrrrcr!)r#r$r.r/r5s r%r\ _Relationships._add_relationshiplsCnn' NN  (3    3 r(cURUHQnURU:waMUR(a URO URnXR:XdMEURs $ g)zvReturn optional str rId of rel of `reltype`, `target`, and `is_external`. Returns `None` on no matching relationship N)rnr/r9r3r5)r#r$r.r/rk rel_targets r%r[_Relationships._get_matchingxsQ((1C+-+.??J#ww 2r(c[[U5S-SS5HnSU-nX R;dMUs $ [S5e)zNext str rId available in collection. The next rId is the first unused key starting from "rId1" and making use of any gaps in numbering, e.g. 'rId2' for rIds ['rId1', 'rId3']. rrrzrId%dzJProgrammingError: Impossible to have more distinct rIds than relationships)rrr!r)r#r rId_candidates r%r_Relationships._next_rIdsJs4y1}a,A#aKMJJ.$$- X  r(c0$)zFdict {rId: _Relationship} containing relationships of this collection.rAr?s r%r!_Relationships._relss  r(c[R"[5nUR5H nXRR U5 M" U$)zBdefaultdict {reltype: [rels]} for all relationships in collection.) collections defaultdictlistrqr$append)r#Drks r%rn_Relationships._rels_by_reltypes=4?3J3J43P;;=C kkN ! !# &!r(rJN)rr+)r5objectrCrG)r5r+rCrd)rCz Iterator[str])rCr)r$r+r3rDrCr+)r$r+r9r+rCr+)rr+rr rrrCrrBrE)r$r+r.rFr/rGrCr+)r$r+r.rFr/rGrCz str | Noner)rCzdict[str, _Relationship])rCzdict[str, list[_Relationship]])r>rJrKrLrMrXrNr5rTrWr-r,rr"rcrrr\r[rrr!rnrNrAr(r%rIrIs"!B     GG'7G@SG G*. #''2 EJ$.=A    "r(rIrdc\rSrSrSrS Sjr\SSj5r\SSj5r \SSj5r \SSj5r \SSj5r \SS j5r \SS j5rS rg )rdizDValue object describing link from a part or package to another part.c@XlX lX0lX@lXPlgrS)rK_rId_reltype _target_mode_target)r#rr5r$rr.s r%rX_Relationship.__init__s!  ' r(cUR[R:Xa URO"U[R "XR5nU"XR URURU5$)zEReturn |_Relationship| object based on CT_Relationship element `rel`.)rrrr9rrr5r$)r^rrkrr.s r%r_Relationship.from_xmlsX~~- NNw++HnnEF  8WWckk3>>6JJr(c<UR[R:H$)zTrue if target_mode is `RTM.EXTERNAL`. An external relationship is a link to a resource outside the package, such as a web-resource (URL). )rrrr?s r%r/_Relationship.is_externals  CLL00r(cUR$)zHMember of RELATIONSHIP_TYPE describing relationship of target to source.)rr?s r%r$_Relationship.reltyperr(cUR$)zstr relationship-id, like 'rId9'. Corresponds to the `Id` attribute on the `CT_Relationship` element and uniquely identifies this relationship within its peers for the source-part or package. )rr?s r%r5_Relationship.rIdsyyr(cUR(a [S5e[UR[5(deUR$)z3|Part| or subtype referred to by this relationship.zR`.target_part` property on _Relationship is undefined when target-mode is external)r/ror*rrDr?s r%r3_Relationship.target_partsB   * $,,----||r(cUR(a [S5e[UR[5(deURR $)z|PackURI| instance containing partname targeted by this relationship. Raises `ValueError` on reference if target_mode is external. Use :attr:`target_mode` to check before referencing. zV`.target_partname` property on _Relationship is undefined when target-mode is external)r/ror*rrDrr?s r%r_Relationship.target_partnamesH   * $,,----||$$$r(cUR(a-[UR[5(deUR$URR UR 5$)zstr reference to relationship target. For internal relationships this is the relative partname, suitable for serialization purposes. For an external relationship it is typically a URL. )r/r*rr+r relative_refrKr?s r%r9_Relationship.target_refsI   dllC00 00<< ##00@@r()rKrrrrN) rr+r5r+r$r+rr+r.rF)rr+rkrrrrCrd)rCrGr)rCrDr)r>rJrKrLrMrXrrrr/r$r5r3rr9rNrAr(r%rdrdsN K K!0 K9L K  K K11 % % A Ar()5rM __future__rrtypingrrrrrr r pptx.opc.constantsr rr rx pptx.opc.oxmlr rpptx.opc.packurirrrpptx.opc.serializedrrpptx.opc.sharedr pptx.oxmlr pptx.utilrtyping_extensionsrrrpptx.oxml.xmlchemyr pptx.packagerpptx.parts.presentationrrrPrrDr rrr+rIrdrAr(r%rs #OOO>6>DD</"&72$8$ $ Nb3b3Jl l ^b6?b6J0_d0_f0!(!(HxWS/12xvRARAr(