hA#SrSSKJr SSKJrJrJrJr SSKJ r SSK J r SSK J r SSKJr SSKJr SS KJr \(a SS KJr SS KJr "S S 5r"SS5r"SS\5rg)zAOpen Packaging Convention (OPC) objects related to package parts.) annotations) TYPE_CHECKINGCallableTypecast)serialize_part_xml)PackURI) Relationships) cls_method_fn parse_xml) lazyproperty)BaseOxmlElement)Packagec6^\rSrSrSrSSU4SjjjrSrSr\SSj5r \S5r SSjr \ SS j5r SSS jjr\S 5r\S 5r\R"SS j5rSSjrSSSjjr\S5r\S5rSSjrS SjrSrU=r$)!PartzBase class for package parts. Provides common properties and methods, but intended to be subclassed in client code to implement specific part behaviors. cZ>[[U] 5 XlX lX0lX@lgN)superr__init__ _partname _content_type_blob_package)selfpartname content_typeblobpackage __class__s ?/var/www/html/env/lib/python3.13/site-packages/docx/opc/part.pyr Part.__init__s' dD"$!)  cg)zEntry point for post-unmarshaling processing, for example to parse the part XML. May be overridden by subclasses without forwarding call to super. Nrs r"after_unmarshalPart.after_unmarshal) r$cg)zEntry point for pre-serialization processing, for example to finalize part naming if necessary. May be overridden by subclasses without forwarding call to super. Nr&r's r"before_marshalPart.before_marshal3r*r$c,UR=(d S$)zContents of this package part as a sequence of bytes. May be text or binary. Intended to be overridden by subclasses. Default behavior is to return load blob. r$)rr's r"r Part.blob=szz S r$cUR$)zContent type of this part.)rr's r"rPart.content_typeFs!!!r$cJURU5S:aURU gg)zRemove the relationship identified by `rId` if its reference count is less than 2. Relationships with a reference count of 0 are implicit relationships. N)_rel_ref_countrelsrrIds r"drop_rel Part.drop_relKs'   s #a ' # (r$cU"XX45$rr&)clsrrrr s r"load Part.loadTs8499r$c:URRXX45$)avReturn newly added |_Relationship| instance of `reltype`. The new relationship relates the `target` part to this part 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 a part when manipulating a part. )r5add_relationship)rreltypetargetr7 is_externals r"load_rel Part.load_relXsyy))'3LLr$cUR$)z+|OpcPackage| instance this part belongs to.)rr's r"r Part.packagec}}r$cUR$)zP|PackURI| instance holding partname of this part, e.g. '/ppt/slides/slide1.xml'.)rr's r"r Part.partnamehs~~r$c[U[5(d#Sn[U[U5R-5eXlg)Nz.partname must be instance of PackURI, got '%s') isinstancer TypeErrortype__name__r)rrtmpls r"rrIns3(G,,CDD4>#:#::; ;!r$c8URRU5$)aReturn part to which this part has a relationship of `reltype`. Raises |KeyError| if no such relationship is found and |ValueError| if more than one such relationship is found. Provides ability to resolve implicitly related part, such as Slide -> SlideLayout. )r5part_with_reltype)rr@s r"part_related_byPart.part_related_byusyy**733r$cU(a*URRU[[U55$URR U[[ U55nUR $)zReturn rId key of relationship of `reltype` to `target`. The returned `rId` is from an existing relationship if there is one, otherwise a new relationship is created. )r5get_or_add_ext_relrstr get_or_addrr7)rrAr@rBrels r" relate_toPart.relate_to~sK 99//c69JK K))&&wT60BCC77Nr$c.URR$)zDictionary mapping related parts by rId, so child objects can resolve explicit relationships present in the part XML, e.g. sldIdLst to a specific |Slide| instance.)r5 related_partsr's r"r\Part.related_partss yy&&&r$cb[URR5UlUR$)zA|Relationships| instance holding the relationships for this part.)r rbaseURI_relsr's r"r5 Part.relss$#4>>#9#9: zzr$c8URUnUR$)zGReturn URL contained in target ref of relationship identified by `rId`.)r5 target_ref)rr7rXs r"rcPart.target_refsiin~~r$cg)zReturn the count of references in this part to the relationship identified by `rId`. Only an XML part can contain references, so this is 0 for `Part`. rr&r6s r"r4Part._rel_ref_counts r$)rrrrr`)NN)rr rrVrz bytes | Noner zPackage | None)returnbytes)r7rVrr rrVrrhr r)F)r@rVrA Part | strr7rVrBbool)rrV)r@rVrgr)rArjr@rVrBrkrgrV)r7rVrgrVr7rVrgint)rN __module__ __qualname____firstlineno____doc__rr(r,propertyrrr8 classmethodr<rCr rsetterrRrYr\rr5rcr4__static_attributes__ __classcell__r!s@r"rrs""&             !!"":: M __"" 4 ''   r$rch\rSrSr%SrS\S'0rS\S'\rS Sjr \ S Sj5r S r g ) PartFactoryaProvides a way for client code to specify a subclass of |Part| to be constructed by |Unmarshaller| based on its content type and/or a custom callable. Setting ``PartFactory.part_class_selector`` to a callable object will cause that object to be called with the parameters ``content_type, reltype``, once for each part in the package. If the callable returns an object, it is used as the class for that part. If it returns |None|, part class selection falls back to the content type map defined in ``PartFactory.part_type_for``. If no class is returned from either of these, the class contained in ``PartFactory.default_part_type`` is used to construct the part, which is by default ``opc.package.Part``. z.Callable[[str, str], Type[Part] | None] | Nonepart_class_selectorzdict[str, Type[Part]] part_type_forcSnURb[US5nU"X#5nUcURU5nURXXE5$)Nr{)r{r _part_cls_forr<)r;rrr@rr PartClassr{s r"__new__PartFactory.__new__sT(,  " " ."/5J"K +LBI  )),7I~~hdDDr$cVXR;aURU$UR$)zReturn the custom part class registered for `content_type`, or the default part class if no custom class is registered for `content_type`.)r|default_part_type)r;rs r"r~PartFactory._part_cls_fors- ,, ,$$\2 2$$$r$r&N) rr rrVr@rVrrhr r)rrV) rNrnrorprq__annotations__r|rrrrsr~rur&r$r"ryrysp HG+-M(-EEE E  E  E %%r$ryc^\rSrSrSrS U4Sjjr\S5r\S5r\ S Sj5r \S5r S Sjr S r U=r$) XmlPartzBase 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. c6>[[U] XUS9 X0lg)N)r )rrr_element)rrrelementr r!s r"rXmlPart.__init__s gt%hg%N r$c,[UR5$r)rrr's r"r XmlPart.blobs!$--00r$cUR$)z&The root XML element of this XML part.rr's r"rXmlPart.elementrGr$c*[U5nU"XXT5$rr )r;rrrr rs r"r< XmlPart.loadsD/87<rsSH"66,$&)&$2$MM`'%'%T(;d(;r$