File: //opt/cppython/lib/python3.8/site-packages/botocore/docs/__pycache__/sharedexample.cpython-38.pyc
U
KD�g�# � @ sB d dl Z d dlZd dlmZ d dlmZ G dd� d�Zdd� ZdS )� N)�escape_controls)�parse_timestampc @ sv e Zd Zdd� Zdd� Zdd� Zdd� Zd 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_inputZ input_shape�document_outputZ output_shape)�self�example�prefix�section�operation_model� r �H/opt/cppython/lib/python3.8/site-packages/botocore/docs/sharedexample.py�document_shared_example s
�z/SharedExampleDocumenter.document_shared_examplec
C s� |� d�}|j�� |d k r&|�|� |�di �}|�d�}|rJ|�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 �shapeZ
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�}|rb|�d�}| �|||g |d� |� d�}|j�� d S )N�outputzExpected Output:z...ZResponseMetadatar Tz output-close)r r r
r r r �_document_dictr )r
r r r Zoutput_sectionr r r r r r r ; s
z'SharedExampleDocumenter.document_outputc C s� t |t�r | �|||||� nft |t�r<| �|||||� nHt |tj�rX| �|||� n,|rv|jdkrv| � |||� n| �
|||� 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 � _documentL s
z!SharedExampleDocumenter._documentFc C s� |� d�}| �|d� |�� D ]�\}} |�d|� �� |� |�}
|
j�� | �||�} | rn|
�| � |
j�� |
�d|� d�� d } |r�|jdkr�|j �
|�} n|jdkr�|j } | � |
| ||| � |�
� q |� d�}
| �|
d � |s�|
�d
� d S ) Nz
dict-value�{�.�'z': Z structure�mapz ending-brace�}�,)r �_start_nested_value�items�appendr r
� _get_commentr r* �membersr r- r/ �pop�_end_nested_value)r
r r- r r. r Z top_levelZ dict_section�key�val� item_section� item_comment�
item_shapeZdict_section_endr r r r! e s.
z&SharedExampleDocumenter._document_dictc
C s� |� d�}| �|d� |�� D ]�\}}|�d|� �� |� |�} | j�� | �||�}
|
rn| �|
� | j�� | �|d � d } |r�|j� |�} | �
| |||| � |� � q |� d�} | � | d� d S )Nz param-values�(r1 �=zending-parenthesis�))
r r6 r7 r8 r r
r9 r r: r r/ r; r< )
r
r r- r r. r r r= r> r? r@ rA Zparam_section_endr r r r � s$
z(SharedExampleDocumenter._document_paramsc
C s� |� d�}| �|d� |j}t|�D ]l\}} |� |�}
|
j�� |�d|� d�� | �||�} | rv|
�| � |
j�� | � |
| |||� |�
� q$|� d�} | � | d� d S )Nz list-section�[�]zending-bracketz],) r r6 �member� enumerater r
r8 r9 r r/ r; r< )
r
r r- r r. r Z list_sectionrA �indexr> r? r@ Zlist_section_endr r r r& � s
z&SharedExampleDocumenter._document_listc C s t |�}|�d|� d�� d S )Nr2 z',)r r )r
r r- r. Z
safe_valuer r r r, � s z%SharedExampleDocumenter._document_strc C s |� t|�� d�� d S )Nr5 )r �str)r
r r- r. r r r r) � s z(SharedExampleDocumenter._document_numberc C sV t |��� }t|d �}tdt|��D ]}|dt|| � 7 }q&|�d|� d�� d S )Nr � z, z datetime(z),)r � timetuplerJ �range�lenr )r
r r- r. Zdatetime_tupleZ datetime_str�ir r r r+ � s
z*SharedExampleDocumenter._document_datetimec C s4 t �ddd�|��}|r,||kr,d|| S dS d S )Nz^\.� z# )�re�sub�join)r
r. r r= r r r r9 � s z$SharedExampleDocumenter._get_commentc C s" |� |� |j�� |j�� d S �N)r r �indent)r
r �startr r r r6 � s
z+SharedExampleDocumenter._start_nested_valuec C s, |j �� |j �� |j �� |�|� d S rT )r �dedentr
r )r
r �endr r r r< � s
z)SharedExampleDocumenter._end_nested_valueN)F)�__name__�
__module__� __qualname__r r r r/ r! r r& r, r) r+ r9 r6 r< r r r r r s �
r c C sP | � d�}|j�� |j�d� t� }|D ] }|j||� |d �||d� q*dS )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-examplesZExamples�id)r r r r N)r r r �boldr r )r r Zexample_prefixZshared_examplesZcontainer_sectionZ
documenterr r r r �document_shared_examples� s
�r^ )r' rQ Zbotocore.docs.utilsr Zbotocore.utilsr r r^ r r r r �<module>
s 9