HEX

File: //home/arjun/projects/env/lib/python3.10/site-packages/boto3/docs/__pycache__/utils.cpython-310.pyc
o

/we<�@s^ddlZddlZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	ddd�ZGdd�d�Z	dS)�NcCsZg}|D]&}t�|j�}|j}|dr|dd}|ds|ddkr*|�|d�q|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)�params�
ignore_params�param�result�current�r�I/home/arjun/projects/env/lib/python3.10/site-packages/boto3/docs/utils.py�get_resource_ignore_paramss��rcCs
t�|�S�N)�inspect�
isfunction)�
action_handlerrr�is_resource_action'�
rcCsPt�|�}i}|D]\}}|�d�s%|d��s%|�d�s%t|�r%|||<q	|S)N�_r�
wait_until)r�
getmembers�
startswith�isupperr)�resource_class�resource_class_members�resource_methods�name�memberrrr�get_resource_public_actions+s


�r#cCsd�dd�|D��S)N�,cSsg|]}d|�d��qS)�'r)�.0�
identifierrrr�
<listcomp>8sz5get_identifier_values_for_example.<locals>.<listcomp>��join��identifier_namesrrr�!get_identifier_values_for_example7sr-cCs
d�|�S)Nr$r)r+rrr�!get_identifier_args_for_signature;rr.cCsd|�d|�d�S)NzThe z's z" identifier. This **must** be set.r)�
resource_name�identifier_namerrr�get_identifier_description?s�r1cCst|j��|j�|�|j��|j��|�|�|j��|dur8|�d|���d|�d��|j��dSdS)NzFor more information about z1 refer to the :ref:`Resources Introduction Guide<z>`.)�style�new_line�h3�write�lower)�section�
resource_type�description�
intro_linkrrr�add_resource_type_overviewFs




���r;c@s$eZdZdd�Zdd�Zdd�ZdS)�DocumentModifiedShapecCs||_||_||_||_dSr)�_shape_name�	_new_type�_new_description�_new_example_value)�self�
shape_name�new_type�new_description�new_example_valuerrr�__init__Xs
zDocumentModifiedShape.__init__cKsd|j|j�d�kr|�||�|jD]}|�|�}|j|j�d�kr)|�||�q|�||�qdS)N�shape)r=�context�get�_replace_documentation�available_sections�get_section�(replace_documentation_for_matching_shape)rA�
event_namer7�kwargs�section_name�sub_sectionrrrrM`s

��z>DocumentModifiedShape.replace_documentation_for_matching_shapecCs�|�d�s
|�d�r|��|��|�|j�|�d�s"|�d�rud}|jD]}||vr2|�|�q'|�d�}|��|�|j�|�d�}|�	��
d��d	�rd|��|�d
|j�d|j���dS|��|j
�d|j�d
��dSdS)Nzdocs.request-examplezdocs.response-examplezdocs.request-paramszdocs.response-params)z
param-name�param-documentationz
end-structure�
param-typez	end-paramrRrSzutf-8z:typez:type z: �(z) -- )r�remove_all_sections�
clear_textr5r@rK�delete_sectionrLr?�getvalue�decoder!r>r2�italics)rArNr7�allowed_sectionsrP�description_section�type_sectionrrrrJns8����

�

�z,DocumentModifiedShape._replace_documentationN)�__name__�
__module__�__qualname__rFrMrJrrrrr<Wsr<r)
rrrrr#r-r.r1r;r<rrrr�<module>s
�