o hA#@sdZddlmZddlmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZddlmZdd lmZerFdd lmZdd lmZGd d d ZGdddZGdddeZdS)zAOpen Packaging Convention (OPC) objects related to package parts.) annotations) TYPE_CHECKINGCallableTypecast)serialize_part_xml)PackURI) Relationships) cls_method_fn parse_xml) lazyproperty)BaseOxmlElement)PackagecseZdZdZ  d7d8fd d Zd dZddZed9ddZeddZ d:ddZ e d;ddZ dd)d(Zd?d*d+Zd SlideLayout. )r1part_with_reltype)rr6r"r"r#part_related_byus zPart.part_related_bycCs2|r |j|tt|S|j|tt|}|jS)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. )r1get_or_add_ext_relrr get_or_addrr.)rr7r6r9relr"r"r# relate_to~szPart.relate_tocCs|jjS)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.)r1 related_partsr%r"r"r#rHszPart.related_partscCst|jj|_|jS)zA|Relationships| instance holding the relationships for this part.)r rbaseURI_relsr%r"r"r#r1sz Part.relscCs|j|}|jS)zGReturn URL contained in target ref of relationship identified by `rId`.)r1 target_ref)rr.rFr"r"r#rKs zPart.target_refintcCr$)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"r2r"r"r#r0szPart._rel_ref_count)NN)rrrrrrrr)r)r*)r.rrrrrrr*rr)F)r6rr7r8r.rr9r:)rr)r6rr)r)r7r8r6rr9r:r)r)r.rr)rr.rr)rL)r@ __module__ __qualname____doc__rr&r(propertyrrr3 classmethodr5r<rrsetterrCrGrHr r1rKr0 __classcell__r"r"r r#rs:                rc@sBeZdZUdZded<iZded<eZdddZe dddZ dS) 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_forrrrrr6rr*rrcCsDd}|jdurt|d}|||}|dur||}|||||S)NrW)rWr _part_cls_forr5)r4rrr6rr PartClassrWr"r"r#__new__s    zPartFactory.__new__cCs||jvr |j|S|jS)zReturn the custom part class registered for `content_type`, or the default part class if no custom class is registered for `content_type`.)rXdefault_part_type)r4rr"r"r#rYs  zPartFactory._part_cls_forN) rrrrr6rrr*rr)rr) r@rOrPrQ__annotations__rXrr\r[rSrYr"r"r"r#rVs   rVcs^eZdZdZdfd d Zed d ZeddZedddZ eddZ dddZ Z S)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. rrrrelementrrrcs tt|j|||d||_dS)N)r)rr^r_element)rrrr_rr r"r#rs zXmlPart.__init__cCs t|jSr)rr`r%r"r"r#rs z XmlPart.blobcCr,)z&The root XML element of this XML part.)r`r%r"r"r#r_r-zXmlPart.elementrr*cCst|}|||||Srr )r4rrrrr_r"r"r#r5sz XmlPart.loadcCs|S)zPart of the parent protocol, "children" of the document will not know the part that contains them so must ask their parent object. That chain of delegation ends here for child objects. r"r%r"r"r#partsz XmlPart.partr.r)rLcs(td|jd}tfdd|DS)zbReturn the count of references in this part's XML to the relationship identified by `rId`.z list[str]z//@r:idcsg|]}|kr|qSr"r").0_rIdr.r"r# sz*XmlPart._rel_ref_count..)rr`xpathlen)rr.rIdsr"rdr#r0szXmlPart._rel_ref_count)rrrrr_rrrrMrN) r@rOrPrQrrRrr_rSr5rar0rUr"r"r r#r^s    r^N)rQ __future__rtypingrrrr docx.opc.oxmlrdocx.opc.packurir docx.opc.relr docx.opc.sharedr docx.oxml.parserr docx.sharedr docx.oxml.xmlchemyr docx.packagerrrVr^r"r"r"r#s          *