File: //opt/alt/python37/lib/python3.7/site-packages/boto3/docs/__pycache__/utils.cpython-37.pyc
B
�P�e< � @ s\ d dl Z d dlZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Zddd�ZG dd� d�Z dS )� Nc C s\ g }xR| D ]J}t �|j�}|j}x|d r8|d d }q"W |d dkr
|�|d � q
W |S )z�Helper method to determine which parameters to ignore for actions
:returns: A list of the parameter names that does not need to be
included in a resource's method call for documentation purposes.
�childrenr �type�field�value)�jmespath�compile�target�parsed�append)�paramsZ
ignore_params�param�result�current� r �A/opt/alt/python37/lib/python3.7/site-packages/boto3/docs/utils.py�get_resource_ignore_params s
r c C s
t �| �S )N)�inspect�
isfunction)Z
action_handler r r �is_resource_action' s r c C sT t �| �}i }x@|D ]8\}}|�d�s|d �� s|�d�st|�r|||< qW |S )N�_r Z
wait_until)r �
getmembers�
startswith�isupperr )Zresource_classZresource_class_membersZresource_methods�name�memberr r r �get_resource_public_actions+ s
r c C s d� dd� | D ��S )N�,c S s g | ]}d |� d ��qS )�'r )�.0�
identifierr r r �
<listcomp>8 s z5get_identifier_values_for_example.<locals>.<listcomp>)�join)�identifier_namesr r r �!get_identifier_values_for_example7 s r# c C s
d� | �S )Nr )r! )r" r r r �!get_identifier_args_for_signature; s r$ c C s d| � d|� d�S )NzThe z's z" identifier. This **must** be set.r )�
resource_nameZidentifier_namer r r �get_identifier_description? s r& c C sp | j �� | j �|� | j �� | j �� | �|� | j �� |d k rl| �d|�� � d|� d�� | j �� d S )NzFor more information about z1 refer to the :ref:`Resources Introduction Guide<z>`.)�style�new_lineZh3�write�lower)�sectionZ
resource_type� descriptionZ
intro_linkr r r �add_resource_type_overviewF s
r- c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )�DocumentModifiedShapec C s || _ || _|| _|| _d S )N)� _shape_name� _new_type�_new_description�_new_example_value)�selfZ
shape_name�new_typeZnew_descriptionZnew_example_valuer r r �__init__X s z DocumentModifiedShape.__init__c K sh | j |j�d�kr | �||� xD|jD ]:}|�|�}| j |j�d�krT| �||� q&| �||� q&W d S )N�shape)r/ �context�get�_replace_documentation�available_sections� get_section�(replace_documentation_for_matching_shape)r3 �
event_namer+ �kwargs� section_nameZ sub_sectionr r r r< ` s
z>DocumentModifiedShape.replace_documentation_for_matching_shapec C s� |� d�s|� d�r0|�� |�� |�| j� |� d�sD|� d�r�d}x |jD ]}||krP|�|� qPW |�d�}|�� |�| j� |�d�}|� � �
d�� d �r�|�� |�d
|j � d | j � �� n |�� |j
�d | j � d
�� d S )Nzdocs.request-examplezdocs.response-examplezdocs.request-paramszdocs.response-params)z
param-namezparam-documentationz
end-structurez
param-typez end-paramzparam-documentationz
param-typezutf-8z:typez:type z: �(z) -- )r Zremove_all_sectionsZ
clear_textr) r2 r: Zdelete_sectionr; r1 �getvalue�decoder r0 r' Zitalics)r3 r= r+ Zallowed_sectionsr? Zdescription_sectionZ type_sectionr r r r9 n s,
z,DocumentModifiedShape._replace_documentationN)�__name__�
__module__� __qualname__r5 r< r9 r r r r r. W s r. )N)
r r r r r r# r$ r& r- r. r r r r �<module>
s