Website : rimsha.abasa.com
backdoor
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
proc
/
self
/
root
/
lib
/
python3
/
dist-packages
/
botocore
/
docs
/
__pycache__
/
Filename :
sharedexample.cpython-310.pyc
back
Copy
o .&�an$ � @ sP d dl Z d dlZd dlmZ d dlmZ d dlmZ G dd� de�Z dd� Z dS ) � N)�parse_timestamp)�escape_controls)�sixc @ sx e Zd Zdd� Zdd� Zdd� Zdd� Z d 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_input� input_shape�document_output� output_shape)�self�example�prefix�section�operation_model� r �=/usr/lib/python3/dist-packages/botocore/docs/sharedexample.py�document_shared_example s �z/SharedExampleDocumenter.document_shared_examplec C s� |� d�}|j�� |d ur|�|� |�di �}|�d�}|r%|�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 �shape� 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�}|r1|�d�}| �|||g |d� |� d�}|j�� d S )N�outputzExpected Output:z...�ResponseMetadatar Tz output-close)r r r r r r �_document_dictr )r r r r �output_sectionr! r r# r r r r 9 s z'SharedExampleDocumenter.document_outputc C s� t |t�r| �|||||� dS t |t�r | �|||||� dS t |tj�r/| �|||� dS |r?|jdkr?| � |||� dS | � |||� 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 � _documentJ s z!SharedExampleDocumenter._documentFc C s� |� d�}| �|d� |�� D ]S\}} |�d| � |� |�} | j�� | �||�} | r6| �| � | j�� | �d| � d } |rU|jdkrM|j � |�} n|jdkrU|j } | � | | ||| � |� � q|� d�} | �| d� |sw| �d � d S d S ) Nz dict-value�{�.%sz'%s': � structure�mapz ending-brace�}�,)r �_start_nested_value�items�appendr r � _get_commentr r0 �membersr r3 r5 �pop�_end_nested_value)r r r3 r r4 r � top_level� dict_section�key�val� item_section� item_comment� item_shape�dict_section_endr r r r& c s0 �z&SharedExampleDocumenter._document_dictc C s� |� d�}| �|d� |�� D ]E\}}|�d| � |� |�} | j�� | �||�} | r6| �| � | j�� | �|d � d } |rG|j� |�} | � | |||| � |� � q|� d�} | � | d� d S )Nz param-values�(r7 �=zending-parenthesis�)) r r< r= r> r r r? r r@ r r5 rA rB ) r r r3 r r4 r r" rE rF rG rH rI �param_section_endr r r r s$ z(SharedExampleDocumenter._document_paramsc C s� |� d�}| �|d� |j}t|�D ]4\}} |� |�} | j�� |�d| � | �||�} | r9| �| � | j�� | � | | |||� |� � q|� d�} | � | d� d S )Nz list-section�[z[%s]zending-bracketz],) r r< �member� enumerater r r> r? r r5 rA rB ) r r r3 r r4 r � list_sectionrI �indexrF rG rH �list_section_endr r r r, � s z&SharedExampleDocumenter._document_listc C s t |�}|�dt�|� � d S )Nz'%s',)r r r � text_type)r r r3 r4 � safe_valuer r r r2 � s z%SharedExampleDocumenter._document_strc C s |� dt|� � d S )Nz%s,)r �str)r r r3 r4 r r r r/ � s z(SharedExampleDocumenter._document_numberc C sR t |��� }t|d �}tdt|��D ] }|dt|| � 7 }q|�d| � d S )Nr � z, z datetime(%s),)r � timetuplerW �range�lenr )r r r3 r4 �datetime_tuple� datetime_str�ir r r r1 � s z*SharedExampleDocumenter._document_datetimec C s0 t �ddd�|��}|r||v rd|| S dS )Nz^\.� z# )�re�sub�join)r r4 r rE r r r r? � s z$SharedExampleDocumenter._get_commentc C s" |� |� |j�� |j�� d S �N)r r �indent)r r �startr r r r< � s z+SharedExampleDocumenter._start_nested_valuec C s, |j �� |j �� |j �� |�|� d S rc )r �dedentr r )r r �endr r r rB � s z)SharedExampleDocumenter._end_nested_valueN)F)�__name__� __module__� __qualname__r r r r5 r& r r, r2 r/ r1 r? r< rB r r r r r s � r c C sP | � d�}|j�� |j�d� t� }|D ]}|j||� |d �||d� qdS )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-examples�Examples�id)r r r r N)r r r �boldr r )r r �example_prefix�shared_examples�container_section� documenterr r r r �document_shared_examples� s ��rr ) r` r- �botocore.utilsr �botocore.docs.utilsr �botocore.compatr �objectr rr r r r r �<module> s 6