File: //proc/722141/root/lib/python3.6/site-packages/botocore/docs/__pycache__/example.cpython-36.pyc
3
�T_/" � @ 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 sB g }|j j� |j j� |dk r*|j|� | j|||||d� 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�exclude)�style�new_lineZstart_codeblock�write�traverse_and_document_shape)�selfr r �prefixr r r � r � /usr/lib/python3.6/example.py�document_example s
z&BaseExampleDocumenter.document_examplec K s |j d� d S )Nz{'... recursive ...'})r )r r r �kwargsr r r �document_recursive_shape- s z.BaseExampleDocumenter.document_recursive_shapec K s> | j |�}|d kr t|j�}| jjd�|kr0d}|j|� d S )NZstreaming_shapezStreamingBody())Z_get_special_py_defaultr Z type_nameZ_context�getr )r r r r r r r Zpy_typer r r �document_shape_default0 s
z,BaseExampleDocumenter.document_shape_defaultc K sh d|j krVxXt|j d �D ]6\}}|jd| � |t|j d �d k r|jd� qW n| j|||� d S )N�enumz'%s'� �|)Zmetadata� enumerater �lenr ) r r r r r r r �ir r r r �document_shape_type_string: s
z0BaseExampleDocumenter.document_shape_type_stringc K sn |j }|jd�}| j|d� |jdd|jid�} | j| ||d� |jd�}
|
jd� |jd �} | j| d
� d S ) Nz
list-value�[�memberr )�context)r r r z ending-comma�,zending-bracket�])r �add_new_section�_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_listD s
z.BaseExampleDocumenter.document_shape_type_listc K s� |j s|jd� d S |jd�}| j|d� | j|j |�}x�t|�D ]�\}} |rX| |krXqB|j| �}
|
jd| � || } |
jdd| jid�} | j| | || d� |t|�d k rB|
jd
�}
|
jd � |
j j
� qBW | j |dd � d S )
Nz{}zstructure-value�{z'%s': z member-valuer )r )r r r r% r z ending-commar! �}) �membersr r# r$ �_add_members_to_shaper r% r
r r
r �_end_structure)r r r r r r r �
input_membersr �paramr( r' �param_value_sectionr) r r r � document_shape_type_structureS s.
z3BaseExampleDocumenter.document_shape_type_structurec K sz |j d�}| j|d� |j}|j dd|jjid�} | jd� |j dd|jid�}
| j|
||d� |j d �} | j| d
� d S ) Nz map-valuer+ �keyr )r z
'string': �value)r r r zending-bracketr, )r# r$ r5 r4 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_mapp s
z-BaseExampleDocumenter.document_shape_type_mapc C s( |r$|j � }x|D ]}|||j< qW |S )N)�copyr% )r r- r r1 r r r r. s
z+BaseExampleDocumenter._add_members_to_shapec C s4 |d k r|j |� |jj� |jj� |jj� d S )N)r r
�indentr )r r �startr r r r$ � s
z)BaseExampleDocumenter._start_nested_paramc C s4 |j j� |j j� |j j� |d k r0|j|� d S )N)r
�dedentr r )r r �endr r r r& � s
z'BaseExampleDocumenter._end_nested_paramc C sB |j s(|j� |j|| � | j|� n|jd�}| j||� d S )Nzending-bracket)Zavailable_sectionsZ
clear_textr r& r# )r r r: r< r6 r r r r/ � s
z$BaseExampleDocumenter._end_structure)NNN)NN)NN)NN)NN)NN)N)N)�__name__�
__module__� __qualname__r r r r r* r3 r7 r. r$ r& r/ r r r r r s
r c @ s e Zd ZdZdd� ZdS )�ResponseExampleDocumenterzresponse-examplec K s4 |j d� | j|||f|� |jd�}|j d� d S )Nz EventStream(zevent-stream-end�))r r3 r# )r r r r r Z end_sectionr r r � document_shape_type_event_stream� s
z:ResponseExampleDocumenter.document_shape_type_event_streamN)r= r> r? �
EVENT_NAMErB r r r r r@ � s r@ c @ s e Zd ZdZddd�ZdS )�RequestExampleDocumenterzrequest-exampleNc K s d}d}d} d}
t |�dkr,d}d} d}
d }|jd
�}| j|| � | j|j|�} x�t| �D ]�\} }
|rp|
|krpqZ|j|
�}|j||
� |j|� | |
}|jd d |jid
�}| j||||
d� | t | �d k rZ|jd�}|jd� |j j
� qZW | j || |
� d S )Nz'%s'z: r+ r, r �=�(rA z%szstructure-valuez member-valuer )r )r r r r% z ending-commar! ) r r# r$ r. r- r r r% r
r
r r/ )r r r r r r r Z param_format�operatorr: r< r0 r r1 r( r' r2 r) r r r r3 � s<
z6RequestExampleDocumenter.document_shape_type_structure)NN)r= r> r? rC r3 r r r r rD � s rD N)Zbotocore.docs.shaper Zbotocore.docs.utilsr r r@ rD r r r r �<module>
s