File: //home/arjun/projects/env/lib/python3.10/site-packages/docx/parts/__pycache__/story.cpython-310.pyc
o
$we� � @ s� d Z ddlmZ ddlmZmZmZ ddlmZ ddl
m Z ddl m
Z
ddlmZmZ erFddlmZ dd lmZ dd
lmZ dd lmZ G d d
� d
e �ZdS )z |StoryPart| and related objects.� )� annotations)�IO�
TYPE_CHECKING�Tuple)�RELATIONSHIP_TYPE)�XmlPart)� CT_Inline)�Length� lazyproperty)�
WD_STYLE_TYPE)�Image)� DocumentPart)� BaseStylec @ sZ e Zd ZdZd dd�Zd!d
d�Zd"dd�Z d#d$dd�Zed%dd ��Z e
d&d d ��Z dS )'� StoryPartz�Base class for story parts.
A story part is one that can contain textual content, such as the document-part and
header or footer parts. These all share content behaviors like `.paragraphs`,
`.add_paragraph()`, `.add_table()` etc.
�image_descriptor�str | IO[bytes]�return�Tuple[str, Image]c C s4 | j }|dus J �|�|�}| �|tj�}||jfS )a| Return (rId, image) pair for image identified by `image_descriptor`.
`rId` is the str key (often like "rId7") for the relationship between this story
part and the image part, reused if already present, newly created if not.
`image` is an |Image| instance providing access to the properties of the image,
such as dimensions and image type.
N)�_package�get_or_add_image_part� relate_to�RT�IMAGE�image)�selfr �package�
image_part�rId� r �I/home/arjun/projects/env/lib/python3.10/site-packages/docx/parts/story.py�get_or_add_image s
zStoryPart.get_or_add_image�style_id�
str | None�
style_typer r c C � | j �||�S )z�Return the style in this document matching `style_id`.
Returns the default style for `style_type` if `style_id` is |None| or does not
match a defined style of `style_type`.
)�_document_part� get_style)r r! r# r r r r& ) s zStoryPart.get_style�
style_or_name�BaseStyle | str | Nonec C r$ )a2 Return str style_id for `style_or_name` of `style_type`.
Returns |None| if the style resolves to the default style for `style_type` or if
`style_or_name` is itself |None|. Raises if `style_or_name` is a style of the
wrong type or names a style not present in the document.
)r% � get_style_id)r r' r# r r r r) 1 s zStoryPart.get_style_idN�width�
Length | None�heightr c
C s> | � |�\}}|�||�\}}| j|j}} t�||| ||�S )z�Return a newly-created `w:inline` element.
The element contains the image specified by `image_descriptor` and is scaled
based on the values of `width` and `height`.
)r �scaled_dimensions�next_id�filenamer �new_pic_inline)
r r r* r, r r �cx�cy�shape_idr/ r r r r0 < s zStoryPart.new_pic_inline�intc C s. | j �d�}dd� |D �}|sdS t|�d S )aB Next available positive integer id value in this story XML document.
The value is determined by incrementing the maximum existing id value. Gaps in
the existing id sequence are not filled. The id attribute value is unique in the
document, without regard to the element type it appears on.
z//@idc S s g | ]
}|� � rt|��qS r )�isdigitr4 )�.0�id_strr r r �
<listcomp>U s z%StoryPart.next_id.<locals>.<listcomp>� )�_element�xpath�max)r �
id_str_lst�used_idsr r r r. L s
zStoryPart.next_idr
c C s | j }|dus J �|jS )z'|DocumentPart| object for this package.N)r �main_document_part)r r r r r r% Z s zStoryPart._document_part)r r r r )r! r" r# r r r )r' r( r# r r r" )NN)r r r* r+ r, r+ r r )r r4 )r r
) �__name__�
__module__� __qualname__�__doc__r r& r) r0 �propertyr. r
r% r r r r r s
�
r N)rC �
__future__r �typingr r r �docx.opc.constantsr r �
docx.opc.partr �docx.oxml.shaper � docx.sharedr r
�docx.enum.styler �docx.image.imager �docx.parts.documentr
�docx.styles.styler r r r r r �<module> s