| Server IP : 89.117.53.150 / Your IP : 216.73.216.11 Web Server : Apache System : Linux server2.hostofiraq.site 5.15.0-186-generic #196-Ubuntu SMP Sat Jun 20 16:09:34 UTC 2026 x86_64 User : iscmbt-kufa-atu ( 1014) PHP Version : 8.2.32 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /lib/python3/dist-packages/botocore/docs/__pycache__/ |
Upload File : |
o
.&�an$ � @ sP d dl Z d dlZd dlmZ d dlmZ d dlmZ G dd� de�Z dd� Z
dS ) � N)�parse_timestamp)�escape_controls)�sixc @ sx e Zd Zdd� Zdd� Zdd� Zdd� Z d d
d �Zd d
� Zdd� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zd S ) �SharedExampleDocumenterc C sJ |j �� |�|�d�� |j �� | �||||j� | �|||j� dS )a8 Documents a single shared example based on its definition.
:param example: The model of the example
:param prefix: The prefix to use in the method example.
:param section: The section to write to.
:param operation_model: The model of the operation used in the example
� descriptionN) �style�
new_paragraph�write�get�new_line�document_input� input_shape�document_output� output_shape)�self�example�prefix�section�operation_model� r �=/usr/lib/python3/dist-packages/botocore/docs/sharedexample.py�document_shared_example s
�z/SharedExampleDocumenter.document_shared_examplec
C s� |� d�}|j�� |d ur|�|� |�di �}|�d�}|r%|�d�}|� d�}| �|||g |� |� d�} | j�� | j�� | �d� | j�� d S )N�input�comments�
parametersz input-closezprint(response))�add_new_sectionr �start_codeblockr r
�_document_paramsr �
end_codeblock)
r r r r �shape�
input_section�paramsr �
param_section�closing_sectionr r r r ( s
z&SharedExampleDocumenter.document_inputc C s� |� d�}|j�� |�d� |j�� |j�� |�di �}ddi|d< |�d�}|r1|�d�}| �|||g |d� |� d�}|j�� d S )N�outputzExpected Output:z...�ResponseMetadatar Tz output-close)r r r r r r
�_document_dictr )r r r r �output_sectionr! r r# r r r r 9 s
z'SharedExampleDocumenter.document_outputc C s� t |t�r| �|||||� dS t |t�r | �|||||� dS t |tj�r/| �|||� dS |r?|jdkr?| � |||� dS | �
|||� dS )a
:param section: The section to add the docs to.
:param value: The input / output values representing the parameters that
are included in the example.
:param comments: The dictionary containing all the comments to be
applied to the example.
:param path: A list describing where the documenter is in traversing the
parameters. This is used to find the equivalent location
in the comments dictionary.
� timestampN) �
isinstance�dictr& �list�_document_list�numbers�Number�_document_number� type_name�_document_datetime�
_document_str)r r �valuer �pathr r r r � _documentJ s
z!SharedExampleDocumenter._documentFc C s� |� d�}| �|d� |�� D ]S\}} |�d| � |� |�}
|
j�� | �||�} | r6|
�| � |
j�� |
�d| � d } |rU|jdkrM|j �
|�} n|jdkrU|j } | � |
| ||| � |�
� q|� d�}
| �|
d� |sw|
�d � d S d S )
Nz
dict-value�{�.%sz'%s': � structure�mapz ending-brace�}�,)r �_start_nested_value�items�appendr r � _get_commentr r0 �membersr
r3 r5 �pop�_end_nested_value)r r r3 r r4 r � top_level� dict_section�key�val� item_section� item_comment�
item_shape�dict_section_endr r r r& c s0
�z&SharedExampleDocumenter._document_dictc
C s� |� d�}| �|d� |�� D ]E\}}|�d| � |� |�} | j�� | �||�}
|
r6| �|
� | j�� | �|d � d } |rG|j� |�} | �
| |||| � |� � q|� d�} | � | d� d S )Nz param-values�(r7 �=zending-parenthesis�))
r r< r= r> r r r? r r@ r
r5 rA rB )
r r r3 r r4 r r" rE rF rG rH rI �param_section_endr r r r s$
z(SharedExampleDocumenter._document_paramsc
C s� |� d�}| �|d� |j}t|�D ]4\}} |� |�}
|
j�� |�d| � | �||�} | r9|
�| � |
j�� | � |
| |||� |�
� q|� d�} | � | d� d S )Nz list-section�[z[%s]zending-bracketz],) r r< �member� enumerater r r> r? r r5 rA rB )
r r r3 r r4 r � list_sectionrI �indexrF rG rH �list_section_endr r r r, � s
z&SharedExampleDocumenter._document_listc C s t |�}|�dt�|� � d S )Nz'%s',)r r r � text_type)r r r3 r4 �
safe_valuer r r r2 � s z%SharedExampleDocumenter._document_strc C s |� dt|� � d S )Nz%s,)r �str)r r r3 r4 r r r r/ � s z(SharedExampleDocumenter._document_numberc C sR t |��� }t|d �}tdt|��D ] }|dt|| � 7 }q|�d| � d S )Nr � z, z
datetime(%s),)r � timetuplerW �range�lenr )r r r3 r4 �datetime_tuple� datetime_str�ir r r r1 � s
z*SharedExampleDocumenter._document_datetimec C s0 t �ddd�|��}|r||v rd|| S dS )Nz^\.� z# )�re�sub�join)r r4 r rE r r r r? � s z$SharedExampleDocumenter._get_commentc C s" |� |� |j�� |j�� d S �N)r r �indent)r r �startr r r r< � s
z+SharedExampleDocumenter._start_nested_valuec C s, |j �� |j �� |j �� |�|� d S rc )r �dedentr r )r r �endr r r rB � s
z)SharedExampleDocumenter._end_nested_valueN)F)�__name__�
__module__� __qualname__r r r r5 r& r r, r2 r/ r1 r? r< rB r r r r r s
� r c C sP | � d�}|j�� |j�d� t� }|D ]}|j||� |d �||d� qdS )a Documents the shared examples
:param section: The section to write to.
:param operation_model: The model of the operation.
:param example_prefix: The prefix to use in the method example.
:param shared_examples: The shared JSON examples from the model.
zshared-examples�Examples�id)r r r r N)r r r �boldr r )r r �example_prefix�shared_examples�container_section�
documenterr r r r �document_shared_examples� s
��rr ) r` r- �botocore.utilsr �botocore.docs.utilsr �botocore.compatr �objectr rr r r r r �<module> s 6