File: //home/arjun/projects/env/lib/python3.10/site-packages/docx/opc/__pycache__/part.cpython-310.pyc
o
$we^ � @ s� d Z ddlmZ ddlmZmZmZmZ ddlm Z ddl
m Z ddl m
Z
ddlmZmZ ddlmZ er<dd lmZ G d
d � d �ZG d d
� d
�ZG dd� de�ZdS )zAOpen Packaging Convention (OPC) objects related to package parts.� )� annotations)�
TYPE_CHECKING�Callable�Dict�Type)�serialize_part_xml)�PackURI)�
Relationships)�
cls_method_fn� lazyproperty�� parse_xml)�Packagec s� e Zd ZdZ d4d5� fd
d �
Zd d
� Zdd� Zedd� �Zedd� �Z d6dd�Z
e d7dd��Z d8d d �Z
ed d � �Zed d!� �Zejd"d!� �Zd9d%d&�Zd8d:d*d+�Zed,d-� �Zed.d/� �Zd0d1� Zd2d3� Z� ZS );�Partz�Base class for package parts.
Provides common properties and methods, but intended to be subclassed in client code
to implement specific part behaviors.
N�partname�str� content_type�blob� bytes | None�package�Package | Nonec s* t t| ��� || _|| _|| _|| _d S �N)�superr �__init__� _partname�
_content_type�_blob�_package)�selfr r r r �� __class__� �F/home/arjun/projects/env/lib/python3.10/site-packages/docx/opc/part.pyr s
z
Part.__init__c C � dS )z�Entry point for post-unmarshaling processing, for example to parse the part
XML.
May be overridden by subclasses without forwarding call to super.
Nr! �r r! r! r" �after_unmarshal% � zPart.after_unmarshalc C r# )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.
Nr! r$ r! r! r" �before_marshal/ r& zPart.before_marshalc C � | j S )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.
)r r$ r! r! r" r 9 s z Part.blobc C r( )zContent type of this part.)r r$ r! r! r" r B � zPart.content_type�rIdc C s | � |�dk r
| j|= dS dS )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.
� N)�_rel_ref_count�rels)r r* r! r! r" �drop_relG s �z
Part.drop_rel�bytesr c C s | ||||�S r r! )�clsr r r r r! r! r" �loadP s z Part.loadFc C s | 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- �add_relationship)r �reltype�targetr* � is_externalr! r! r" �load_relT s z
Part.load_relc C r( )z+|OpcPackage| instance this part belongs to.)r r$ r! r! r" r ^ r) z Part.packagec C r( )zX|PackURI| instance holding partname of this part, e.g.
'/ppt/slides/slide1.xml'.)r r$ r! r! r" r c s z
Part.partnamec C s* t |t�sd}t|t|�j ��|| _d S )Nz.partname must be instance of PackURI, got '%s')�
isinstancer � TypeError�type�__name__r )r r �tmplr! r! r" r i s
r3 �returnc C s | 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- �part_with_reltype)r r3 r! r! r" �part_related_byp s zPart.part_related_byr4 r5 �boolc C s& |r | j �||�S | j �||�}|jS )z�Return 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.
)r- �get_or_add_ext_rel�
get_or_addr* )r r4 r3 r5 �relr! r! r" � relate_toy s zPart.relate_toc C s | j jS )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$ r! r! r" rD � s zPart.related_partsc C s t | jj�S )zA|Relationships| instance holding the relationships for this part.)r r �baseURIr$ r! r! r" r- � s z Part.relsc C s | j | }|jS )zGReturn URL contained in target ref of relationship identified by `rId`.)r- �
target_ref)r r* rB r! r! r" rF � s
zPart.target_refc s" | j �d�}t� fdd�|D ��S )zbReturn the count of references in this part's XML to the relationship
identified by `rId`.z//@r:idc s g | ]}|� kr|�qS r! r! )�.0�_rId�r* r! r" �
<listcomp>� s z'Part._rel_ref_count.<locals>.<listcomp>)�_element�xpath�len)r r* �rIdsr! rI r" r, � s zPart._rel_ref_count)NN)r r r r r r r r )r* r )r r r r r r/ r r )F)r3 r r< r )r4 r r3 r r5 r? r< r )r: �
__module__� __qualname__�__doc__r r% r' �propertyr r r. � classmethodr1 r6 r r �setterr> rC rD r r- rF r, �
__classcell__r! r! r r" r s:
�
r c @ sB e Zd ZU dZded< i Zded< eZddd�Ze ddd��Z
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``.
z.Callable[[str, str], Type[Part] | None] | None�part_class_selectorzDict[str, Type[Part]]�
part_type_forr r r r3 r r/ r r c C sD d }| j d urt| d�}|||�}|d u r| �|�}|�||||�S )NrW )rW r
�
_part_cls_forr1 )r0 r r r3 r r � PartClassrW r! r! r" �__new__� s
zPartFactory.__new__c C s || j v r
| 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`.)rX �default_part_type)r0 r r! r! r" rY � s
zPartFactory._part_cls_forN)
r r r r r3 r r r/ r r )r r ) r: rO rP rQ �__annotations__rX r r\ r[ rS rY r! r! r! r" rV � s
rV c sP e Zd ZdZ� fdd�Zedd� �Zedd� �Zedd � �Z ed
d � �Z
� Z S ) �XmlPartz�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.
c s t t| �j|||d� || _d S )N)r )r r^ r rK )r r r �elementr r r! r" r � s
zXmlPart.__init__c C s
t | j�S r )r rK r$ r! r! r" r � s
z XmlPart.blobc C r( )z&The root XML element of this XML part.)rK r$ r! r! r" r_ � r) zXmlPart.elementc C s t |�}| ||||�S r r )r0 r r r r r_ r! r! r" r1 � s z XmlPart.loadc C s | 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.
r! r$ r! r! r" �part� s z XmlPart.part) r: rO rP rQ r rR r r_ rS r1 r` rU r! r! r r" r^ � s
r^ N)rQ �
__future__r �typingr r r r �
docx.opc.oxmlr �docx.opc.packurir � docx.opc.relr �docx.opc.sharedr
r �docx.oxml.parserr
� docx.packager r rV r^ r! r! r! r" �<module> s
*