o W_@sdZddlmZmZmZmZddlmZddlm Z ddlm Z ddl m Z dd l mZdd lmZGd d d eZGd ddeZGdddeZdS)zC Open Packaging Convention (OPC) objects related to package parts. )absolute_importdivisionprint_functionunicode_literals) cls_method_fn)serialize_part_xml parse_xml)PackURI) Relationships) lazypropertycseZdZdZd%fdd ZddZddZed d Zed d Z d dZ e ddZ d&ddZ eddZeddZejddZddZd&ddZeddZedd Zd!d"Zd#d$ZZS)'Partz Base class for package parts. Provides common properties and methods, but intended to be subclassed in client code to implement specific part behaviors. Ncs*tt|||_||_||_||_dSN)superr__init__ _partname _content_type_blob_package)selfpartname content_typeblobpackage __class__=D:\Projects\ConvertPro\env\Lib\site-packages\docx\opc\part.pyrs  z Part.__init__cCdS)z Entry point for post-unmarshaling processing, for example to parse the part XML. May be overridden by subclasses without forwarding call to super. Nrrrrrafter_unmarshal zPart.after_unmarshalcCr )z Entry point for pre-serialization processing, for example to finalize part naming if necessary. May be overridden by subclasses without forwarding call to super. Nrr!rrrbefore_marshal*r#zPart.before_marshalcC|jS)z Contents 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. )rr!rrrr4sz Part.blobcCr%)z, Content type of this part. )rr!rrrr=zPart.content_typecCs||dkr |j|=dSdS)z Remove the relationship identified by *rId* if its reference count is less than 2. Relationships with a reference count of 0 are implicit relationships. r N)_rel_ref_countrels)rrIdrrrdrop_relDs z Part.drop_relcCs|||||Srr)clsrrrrrrrloadMsz Part.loadFcCs|j||||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 a part when manipulating a part. )r(Zadd_relationship)rreltypetargetr) is_externalrrrload_relQs z Part.load_relcCr%)z= |OpcPackage| instance this part belongs to. )rr!rrrr\r&z Part.packagecCr%)zi |PackURI| instance holding partname of this part, e.g. '/ppt/slides/slide1.xml' )rr!rrrrcsz Part.partnamecCs*t|tsd}t|t|j||_dS)Nz.partname must be instance of PackURI, got '%s') isinstancer TypeErrortype__name__r)rrtmplrrrrks  cCs |j|S)a- Return 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. )r(Zpart_with_reltype)rr-rrrpart_related_byrs zPart.part_related_bycCs&|r |j||S|j||}|jS)z Return rId key of relationship of *reltype* to *target*, from an existing relationship if there is one, otherwise a newly created one. )r(Zget_or_add_ext_relZ get_or_addr))rr.r-r/relrrr relate_to{szPart.relate_tocCs|jjS)z Dictionary 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. )r( related_partsr!rrrr9szPart.related_partscCs t|jjS)zS |Relationships| instance holding the relationships for this part. )r rZbaseURIr!rrrr(s z Part.relscCs|j|}|jS)za Return URL contained in target ref of relationship identified by *rId*. )r( target_ref)rr)r7rrrr:s zPart.target_refcs"|jd}tfdd|DS)zt Return the count of references in this part's XML to the relationship identified by *rId*. z//@r:idcsg|]}|kr|qSrr).0Z_rIdr)rr sz'Part._rel_ref_count..)_elementZxpathlen)rr)ZrIdsrr<rr's zPart._rel_ref_count)NN)F)r4 __module__ __qualname____doc__rr"r$propertyrrr* classmethodr,r0rrsetterr6r8r9rr(r:r' __classcell__rrrrrs6           rc@s0eZdZdZdZiZeZddZe ddZ dS) PartFactorya Provides 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``. NcCsDd}|jdurt|d}|||}|dur||}|||||S)Npart_class_selector)rHr _part_cls_forr,)r+rrr-rrZ PartClassrHrrr__new__s    zPartFactory.__new__cCs||jvr |j|S|jS)z Return the custom part class registered for *content_type*, or the default part class if no custom class is registered for *content_type*. ) part_type_fordefault_part_type)r+rrrrrIs  zPartFactory._part_cls_for) r4r@rArBrHrKrrLrJrDrIrrrrrGs  rGcsPeZdZdZfddZeddZeddZedd Z ed d Z Z S) XmlParta Base 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. cs tt|j|||d||_dS)N)r)rrMrr>)rrrelementrrrrrs  zXmlPart.__init__cCs t|jSr)rr>r!rrrrs z XmlPart.blobcCr%)z8 The root XML element of this XML part. )r>r!rrrrNr&zXmlPart.elementcCst|}|||||Srr )r+rrrrrNrrrr,sz XmlPart.loadcCs|S)z Part 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. rr!rrrpartsz XmlPart.part) r4r@rArBrrCrrNrDr,rOrFrrrrrMs    rMN)rBZ __future__rrrrcompatrZoxmlrr Zpackurir r7r sharedrobjectrrGrMrrrrs      &