File: //usr/local/CyberCP/lib/python3.10/site-packages/botocore/docs/__pycache__/example.cpython-310.pyc
o
�h�" � @ sL d dl mZ d dlmZ G dd� de�ZG dd� de�ZG dd� de�Zd S )
� )�ShapeDocumenter)�
py_defaultc @ s� e Zd Z ddd�Zdd� Z ddd�Z ddd �Z dd
d �Z dd d
�Z ddd�Z dd� Z
ddd�Z ddd�Z dd� Z
dS )�BaseExampleDocumenterNc C sV g }|j �� |j �� |dur|�|� | j|||||d� |�d�}|j �� dS )a] Generates an example based on a shape
:param section: The section to write the documentation to.
:param shape: The shape of the operation.
:param prefix: Anything to be included before the example
:type include: Dictionary where keys are parameter names and
values are the shapes of the parameter names.
:param include: The parameter shapes to include in the documentation.
:type exclude: List of the names of the parameters to exclude.
:param exclude: The names of the parameters to exclude from
documentation.
N)�section�shape�history�include�excludezfinal-blank-line)�style�new_line�start_codeblock�write�traverse_and_document_shape�add_new_section)�selfr r �prefixr r r �final_blank_line_section� r �H/usr/local/CyberCP/lib/python3.10/site-packages/botocore/docs/example.py�document_example s
�
z&BaseExampleDocumenter.document_examplec K s |� d� d S )Nz{'... recursive ...'})r
)r r r �kwargsr r r �document_recursive_shape4 s z.BaseExampleDocumenter.document_recursive_shapec K s> | � |�}|d u rt|j�}| j�d�|krd}|�|� d S )N�streaming_shapezStreamingBody())�_get_special_py_defaultr � type_name�_context�getr
)r r r r r r r �py_typer r r �document_shape_default7 s
z,BaseExampleDocumenter.document_shape_defaultc K sj d|j v r,t|j d �D ] \}}|�d|� d�� |t|j d �d k r)|�d� q d S | �|||� d S )N�enum�'� �|)�metadata� enumerater
�lenr ) r r r r r r r �ir r r r �document_shape_type_stringB s
��z0BaseExampleDocumenter.document_shape_type_stringc K sn |j }|�d�}| �|d� |jdd|jid�} | j| ||d� |�d�}
|
�d� |�d �} | �| d
� d S ) Nz
list-value�[�memberr ��context�r r r � ending-comma�,�ending-bracket�])r) r �_start_nested_param�namer r
�_end_nested_param) r r r r r r r � param_shape� list_section�
param_section�ending_comma_section�ending_bracket_sectionr r r �document_shape_type_listM s
��
z.BaseExampleDocumenter.document_shape_type_listc K s� |j s
|�d� d S |�d�}| �|d� | �|j |�}t|�D ]G\}} |r+| |v r+q |�| �}
|
�d| � d�� || } |
jdd| jid�} | j| | || d � |t|�d
k rg|
�d �}
|
�d � |
j �
� q | � |dd
� d S )Nz{}�structure-value�{r z': � member-valuer r* �r r r r2 r! r- r. �}) �membersr
r r1 �_add_members_to_shaper$ r2 r r% r
r �_end_structure)r r r r r r r �
input_membersr& �paramr6 r4 �param_value_sectionr7 r r r � document_shape_type_structure^ s:
���
�z3BaseExampleDocumenter.document_shape_type_structurec K sz |� d�}| �|d� |j}|j dd|jjid�} | �d� |j dd|jid�}
| j|
||d� |� d �} | �| d
� d S ) Nz map-valuer; �keyr r* z
'string': �valuer, r/ r> )r r1 rG rF r2 r
r r3 ) r r r r r r r � map_section� value_shape� key_section�
value_section�end_bracket_sectionr r r �document_shape_type_map� s
�
��
z-BaseExampleDocumenter.document_shape_type_mapc C s$ |r|� � }|D ]}|||j< q|S �N)�copyr2 )r r? r rC r r r r@ � s
z+BaseExampleDocumenter._add_members_to_shapec C s4 |d ur |� |� |j�� |j�� |j�� d S rN )r
r
�indentr )r r �startr r r r1 � s
z)BaseExampleDocumenter._start_nested_paramc C s8 |j �� |j �� |j �� |d ur|�|� d S d S rN )r
�dedentr r
)r r �endr r r r3 � s
�z'BaseExampleDocumenter._end_nested_paramc C sD |j s|�� |�|| � | �|� d S |�d�}| �||� d S )Nr/ )�available_sections�
clear_textr
r3 r )r r rQ rS rL r r r rA � s
z$BaseExampleDocumenter._end_structure)NNN�NNrN )�__name__�
__module__� __qualname__r r r r' r9 rE rM r@ r1 r3 rA r r r r r s$
�"
�
�
�
�$
�
r c @ s e Zd ZdZdd� ZdS )�ResponseExampleDocumenterzresponse-examplec K s8 |� d� | j|||fi |�� |�d�}|� d� d S )Nz EventStream(zevent-stream-end�))r
rE r )r r r r r � end_sectionr r r � document_shape_type_event_stream� s
z:ResponseExampleDocumenter.document_shape_type_event_streamN)rW rX rY �
EVENT_NAMEr] r r r r rZ � s rZ c @ s e Zd ZdZ ddd�ZdS )�RequestExampleDocumenterzrequest-exampleNc K s d}d}d} d}
t |�dkrd}d} d}
d }|�d
�}| �|| � | �|j|�} t| �D ]J\} }
|r7|
|v r7q,|�|
�}|�||
� |�|� | |
}|jd d |jid
�}| j||||
d� | t | �d k rv|�d�}|�d� |j �
� q,| � || |
� d S )Nz'%s'z: r; r> r! �=�(r[ z%sr: r< r r* r= r- r. ) r% r r1 r@ r? r$ r
r2 r r
r rA )r r r r r r r � param_format�operatorrQ rS rB r& rC r6 r4 rD r7 r r r rE � sH
���
�z6RequestExampleDocumenter.document_shape_type_structurerV )rW rX rY r^ rE r r r r r_ � s �r_ N)�botocore.docs.shaper �botocore.docs.utilsr r rZ r_ r r r r �<module> s &