File: //usr/lib/python3.6/site-packages/botocore/docs/__pycache__/sharedexample.cpython-36.pyc
3
�T_n$ � @ sP d dl Z d dlZd dlmZ d dlmZ d dlmZ G dd� de�Z dd� Z
dS ) � N)�parse_timestamp)�escape_controls)�sixc @ 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 j� |j|jd�� |j j� | j||||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 �#/usr/lib/python3.6/sharedexample.py�document_shared_example s
z/SharedExampleDocumenter.document_shared_examplec
C s� |j d�}|jj� |d k r&|j|� |jdi �}|jd�}|rJ|jd�}|j d�}| j|||g |� |j d�} | jj� | jj� | jd� | jj� d S )N�input�commentsZ
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� |j d�}|jj� |jd� |jj� |jj� |jdi �}ddi|d< |jd�}|rb|jd�}| j|||g |d� |j d�}|jj� 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
9 s
z'SharedExampleDocumenter.document_outputc C s� t |t�r | j|||||� nft |t�r<| j|||||� nHt |tj�rX| j|||� n,|rv|jdkrv| j |||� n| j
|||� 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.
Z 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� |j d�}| j|d� x�|j� D ]�\}} |jd| � |j |�}
|
jj� | j||�} | rn|
j| � |
jj� |
jd| � d } |r�|jdkr�|j j
|�} n|jdkr�|j } | j |
| ||| � |j
� q W |j d�}
| j|
d� |s�|
jd � d S )
Nz
dict-value�{z.%sz'%s': 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! c s.
z&SharedExampleDocumenter._document_dictc
C s� |j d�}| j|d� x�|j� D ]�\}}|jd| � |j |�} | jj� | j||�}
|
rn| j|
� | jj� | j|d � d } |r�|jj |�} | j
| |||| � |j � q W |j d�} | j | d� d S )Nz param-values�(z.%s�=zending-parenthesis�))
r r3 r4 r5 r r r6 r r7 r
r. r8 r9 )
r r r, r r- r r r: r; r< r= r> Zparam_section_endr r r r s$
z(SharedExampleDocumenter._document_paramsc
C s� |j d�}| j|d� |j}xtt|�D ]h\}} |j |�}
|
jj� |jd| � | j||�} | rt|
j| � |
jj� | j |
| |||� |j
� q&W |j d�} | j | d� d S )Nz list-section�[z[%s]zending-bracketz],) r r3 �member� enumerater r r5 r6 r r. r8 r9 )
r r r, r r- r Z list_sectionr> �indexr; r< r= Zlist_section_endr r r r% � s
z&SharedExampleDocumenter._document_listc C s t |�}|jdtj|� � d S )Nz'%s',)r r r Z text_type)r r r, r- Z
safe_valuer r r r+ � s z%SharedExampleDocumenter._document_strc C s |j dt|� � d S )Nz%s,)r �str)r r r, r- r r r r( � s z(SharedExampleDocumenter._document_numberc C sV t |�j� }t|d �}x*tdt|��D ]}|dt|| � 7 }q(W |jd| � d S )Nr � z, z
datetime(%s),)r Z timetuplerF �range�lenr )r r r, r- Zdatetime_tupleZ datetime_str�ir r r r* � s
z*SharedExampleDocumenter._document_datetimec C s4 t jdddj|��}|r,||kr,d|| S dS d S )Nz^\.� z# )�re�sub�join)r r- r r: r r r r6 � s z$SharedExampleDocumenter._get_commentc C s" |j |� |jj� |jj� d S )N)r r �indent)r r �startr r r r3 � s
z+SharedExampleDocumenter._start_nested_valuec C s, |j j� |j j� |j j� |j|� d S )N)r �dedentr r )r r �endr r r r9 � s
z)SharedExampleDocumenter._end_nested_valueN)F)�__name__�
__module__� __qualname__r r r
r. r! r r% r+ r( r* r6 r3 r9 r r r r r s
r c C sT | j d�}|jj� |jjd� t� }x(|D ] }|j||j |d �||d� q,W 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 Zboldr r )r r Zexample_prefixZshared_examplesZcontainer_sectionZ
documenterr r r r �document_shared_examples� s
rW ) rL r& Zbotocore.utilsr Zbotocore.docs.utilsr Zbotocore.compatr �objectr rW r r r r �<module>
s 6