File: //opt/cppython/lib/python3.8/site-packages/botocore/docs/__pycache__/example.cpython-38.pyc
U
KD�g�" � @ sL d dl mZ d dlmZ G dd� de�ZG dd� de�ZG dd� de�Zd S )
� )�ShapeDocumenter)�
py_defaultc @ st e Zd Zddd�Zdd� Zddd�Zddd �Zdd
d �Zd d d
�Zd dd�Z dd� Z
d dd�Z d dd�Z dd� Z
dS ) �BaseExampleDocumenterNc C sV g }|j �� |j �� |dk r*|�|� | 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_lineZstart_codeblock�write�traverse_and_document_shape�add_new_section)�selfr r �prefixr r r Zfinal_blank_line_section� r �B/opt/cppython/lib/python3.8/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 kr t|j�}| j�d�|kr0d}|�|� d S )NZstreaming_shapezStreamingBody())Z_get_special_py_defaultr � type_name�_context�getr )r r r r r r r Zpy_typer r r �document_shape_default7 s
z,BaseExampleDocumenter.document_shape_defaultc K sh d|j krVt|j d �D ]:\}}|�d|� d�� |t|j d �d k r|�d� qn| �|||� 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_shapeZ list_section�
param_section�ending_comma_sectionZending_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 ]�\}} |rV| |krVq@|�| �}
|
�d| � d�� || } |
jdd| jid�} | j| | || d � |t|�d
k r@|
�d �}
|
�d � |
j �
� q@| � |dd
� d S )Nz{}�structure-value�{r z': � member-valuer r% �r r r r- r r( r) �}) �membersr r r, �_add_members_to_shaper r- r
r r
r �_end_structure)r r r r r r r �
input_membersr! �paramr0 r/ �param_value_sectionr1 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-valuer4 �keyr r% z
'string': �valuer' r* r7 )r r, r@ r? r- r r
r. ) r r r r r r r Z map_sectionZ value_shapeZ key_sectionZ
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)�copyr- )r r8 r r< r r r r9 � s
z+BaseExampleDocumenter._add_members_to_shapec C s4 |d k r|� |� |j�� |j�� |j�� d S rC )r r
�indentr )r r �startr r r r, � s
z)BaseExampleDocumenter._start_nested_paramc C s4 |j �� |j �� |j �� |d k r0|�|� d S rC )r
�dedentr r )r r �endr r r r. � s
z'BaseExampleDocumenter._end_nested_paramc C sB |j s(|�� |�|| � | �|� n|�d�}| �||� d S )Nr* )Zavailable_sectionsZ
clear_textr r. r )r r rF rH rA r r r r: � s
z$BaseExampleDocumenter._end_structure)NNN)NN)NN)NN)NN)NN)N)N)�__name__�
__module__� __qualname__r r r r" r2 r> rB r9 r, r. r: r r r r r s0 �
" �
�
�
�
$ �
r c @ s e Zd ZdZdd� ZdS )�ResponseExampleDocumenterzresponse-examplec K s4 |� d� | j|||f|� |�d�}|� d� d S )Nz EventStream(zevent-stream-end�))r r> r )r r r r r � end_sectionr r r � document_shape_type_event_stream� s
z:ResponseExampleDocumenter.document_shape_type_event_streamN)rI rJ rK �
EVENT_NAMErO r r r r rL � s rL c @ s e Zd ZdZddd�ZdS )�RequestExampleDocumenterzrequest-exampleNc K s d}d}d} d}
t |�dkr,d}d} d}
d }|�d
�}| �|| � | �|j|�} t| �D ]�\} }
|rn|
|krnqX|�|
�}|�||
� |�|� | |
}|jd d |jid
�}| j||||
d� | t | �d k rX|�d�}|�d� |j �
� qX| � || |
� d S )Nz'%s'z: r4 r7 r �=�(rM z%sr3 r5 r r% r6 r( r) ) r r r, r9 r8 r r r- r
r
r r: )r r r r r r r Z param_format�operatorrF rH r; r! r< r0 r/ r= r1 r r r r> � sH
���
z6RequestExampleDocumenter.document_shape_type_structure)NN)rI rJ rK rP r> r r r r rQ � s �rQ N)Zbotocore.docs.shaper Zbotocore.docs.utilsr r rL rQ r r r r �<module>
s
&