| Current File : //usr/lib/python3/dist-packages/boto3/docs/__pycache__/utils.cpython-312.pyc |
�
��e< � �V � d dl Z d dlZd� Zd� Zd� Zd� Zd� Zd� Z d d�Z G d � d
� Z y) � Nc �� � g }| D ]] }t j |j � }|j }|d r|d d }|d r�|d dk( s�J|j |d � �_ |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�currents �2/usr/lib/python3/dist-packages/boto3/docs/utils.py�get_resource_ignore_paramsr s� � � �M��
3���!�!�%�,�,�/���-�-�� �j�!� �j�)�!�,�G� �j�!� �6�?�g� %� � � ���!1� 2�
3� �� c �, � t j | � S �N)�inspect�
isfunction)�
action_handles r �is_resource_actionr ' s � � � � �m� ,�,r c �� � t j | � }i }|D ]N \ }}|j d� r�|d j � r�,|j d� r�>t |� s�J|||< �P |S )N�_r �
wait_until)r �
getmembers�
startswith�isupperr )�resource_class�resource_class_members�resource_methods�name�members r �get_resource_public_actionsr& + sm � � $� /� /�� ?����.� 8� ��f����s�#���7�?�?�$����|�4�)�&�1�17�(��.� 8� �r c �R � dj | D �cg c] }d|� d���
c}� S c c}w )N�,�'��join)�identifier_names�
identifiers r �!get_identifier_values_for_exampler. 7 s) � � �8�8�;K�L�Z�r�*� �R�(�L� M�M��Ls �
$c �$ � dj | � S )Nr( r* )r, s r �!get_identifier_args_for_signaturer0 ; s � � �8�8�$� %�%r c � � d| � d|� d�S )NzThe z's z" identifier. This **must** be set.� )�
resource_name�identifier_names r �get_identifier_descriptionr5 ? s � �
�}�o�S� � 1� 2 � !�r c � � | j j � | j j |� | j j � | j j � | j |� | j j � |�A| j d|j � � d|� d�� | j j � y y )NzFor more information about z1 refer to the :ref:`Resources Introduction Guide<z>`.)�style�new_line�h3�write�lower)�section�
resource_type� description�
intro_links r �add_resource_type_overviewr@ F s� � � �M�M��� � �M�M���]�#� �M�M��� � �M�M��� � �M�M�+� � �M�M��� �� ��
�
�)�-�*=�*=�*?�)@� A2�2<� �S�
B�
� �
�
� � � � r c � � e Zd Zd� Zd� Zd� Zy)�DocumentModifiedShapec �< � || _ || _ || _ || _ y r )� _shape_name� _new_type�_new_description�_new_example_value)�self�
shape_name�new_type�new_description�new_example_values r �__init__z DocumentModifiedShape.__init__X s# � � &���!��� /�� �"3�� r c �V � | j |j j d� k( r| j ||� |j D ]` }|j |� }| j |j j d� k( r| j ||� �O| j
||� �b y )N�shape)rD �context�get�_replace_documentation�available_sections� get_section�(replace_documentation_for_matching_shape)rH �
event_namer< �kwargs� section_name� sub_sections r rU z>DocumentModifiedShape.replace_documentation_for_matching_shape` s� � � � � �w��� 2� 2�7� ;� ;� � '� '�
�G� <� #� 6� 6� �L�!�-�-�l�;�K�� � �;�#6�#6�#:�#:�7�#C�C��+�+�J� �D��=�=� � �� r c �8 � |j d� s|j d� r;|j � |j � |j | j � |j d� s|j d� �rd}|j
D ] }||vs�|j
|� � |j d� }|j � |j | j � |j d� }|j � j d� j d � r<|j � |j d
|j � d | j � �� y |j � |j j d | j � d
�� y y )Nzdocs.request-examplezdocs.response-examplezdocs.request-paramszdocs.response-params)z
param-name�param-documentationz
end-structure�
param-typez end-paramr[ r\ zutf-8z:typez:type z: �(z) -- )r �remove_all_sections�
clear_textr: rG rS �delete_sectionrT rF �getvalue�decoder$ rE r7 �italics)rH rV r< �allowed_sectionsrX �description_section� type_sections r rR z,DocumentModifiedShape._replace_documentationn so � � � � � "�
�
�
"�
"�#:�
;� � '� '� )� � � � � �M�M�$�1�1� 2� � � � !�
�
�
"�
"�#9�
:� � � !(� :� :�
9� � �'7�7��*�*�<�8�
9� #*�"5�"5�6K�"L� � � *� *� ,� � %� %�d�&;�&;� <� #�.�.�|�<�L��$�$�&�-�-�g�6�A�A�'�J� �'�'�)� �"�"�V�G�L�L�>��D�N�N�;K�#L�M� �'�'�)� �"�"�*�*�Q�t�~�~�.>�e�+D�E�5 ;r N)�__name__�
__module__� __qualname__rM rU rR r2 r r rB rB W s � �4� � $Fr rB r )
r r r r r& r. r0 r5 r@ rB r2 r r �<module>rj sB �� � ��*-� �N�&�� 59�!�";F� ;Fr