File: //opt/alt/python311/lib/python3.11/site-packages/boto3/docs/__pycache__/utils.cpython-311.pyc
�
/�;f< � �^ � d dl Z d dlZd� Zd� Zd� Zd� Zd� Zd� Z d d�Z G d � d
� � Z dS ) � Nc �� � g }| D ]g}t j |j � � }|j }|d r|d d }|d �|d dk r|� |d � � �h|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 �C/opt/alt/python311/lib/python3.11/site-packages/boto3/docs/utils.py�get_resource_ignore_paramsr s� � � �M��
3�
3���!�%�,�/�/���-�� �j�!� -� �j�)�!�,�G� �j�!� -� �6�?�g� %� %� � � ���!1� 2� 2� 2�� �� c �* � t j | � � S �N)�inspect�
isfunction)�
action_handles r �is_resource_actionr ' s � � � �m� ,� ,�,r c �� � t j | � � }i }|D ]]\ }}|� d� � sC|d � � � s)|� d� � st |� � r|||< �^|S )N�_r �
wait_until)r �
getmembers�
startswith�isupperr )�resource_class�resource_class_members�resource_methods�name�members r �get_resource_public_actionsr& + s� � � $� /�� ?� ?����.� 8� 8� ��f����s�#�#� 8���7�?�?�$�$�
8����|�4�4� 8�)�&�1�1� 8�17�(��.�� �r c �@ � d� d� | D � � � � S )N�,c � � g | ]}d |� d ��� S )�'� )�.0�
identifiers r �
<listcomp>z5get_identifier_values_for_example.<locals>.<listcomp>8 s$ � �L�L�L�Z�(�*�(�(�(�L�L�Lr ��join��identifier_namess r �!get_identifier_values_for_exampler3 7 s$ � � �8�8�L�L�;K�L�L�L� M� M�Mr c �, � d� | � � S )Nr( r/ r1 s r �!get_identifier_args_for_signaturer5 ; s � � �8�8�$� %� %�%r c � � d| � d|� d�S )NzThe z's z" identifier. This **must** be set.r+ )�
resource_name�identifier_names r �get_identifier_descriptionr9 ? s) � � !�}� !� !� � !� !� !�r c �� � | j � � � | j � |� � | j � � � | j � � � | � |� � | j � � � |�I| � d|� � � � d|� d�� � | j � � � d S d S )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_overviewrD F s� � � �M��� � � � �M���]�#�#�#� �M��� � � � �M��� � � � �M�M�+� � � � �M��� � � �� ��
�
�
B�-�*=�*=�*?�*?�
B�
B�2<�
B�
B�
B�
�
�
� �
� � � � � � � � � r c � � e Zd Zd� Zd� Zd� ZdS )�DocumentModifiedShapec �> � || _ || _ || _ || _ d S 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 � d� � k r| � ||� � |j D ]g}|� |� � }| j |j � d� � k r| � ||� � �Q| � ||� � �hd S )N�shape)rH �context�get�_replace_documentation�available_sections� get_section�(replace_documentation_for_matching_shape)rL �
event_namer@ �kwargs� section_name� sub_sections r rY z>DocumentModifiedShape.replace_documentation_for_matching_shape` s� � � � �w�� 2� 2�7� ;� ;� ;� ;� � '� '�
�G� <� <� <� #� 6� � �L�!�-�-�l�;�;�K�� �;�#6�#:�#:�7�#C�#C�C�C��+�+�J� �D�D�D�D��=�=� � �� � � � � r c � � |� d� � s|� d� � rB|� � � |� � � |� | j � � |� d� � s|� d� � �r+d}|j D ]}||vr|� |� � � |� d� � }|� � � |� | j � � |� d� � }|� � � �
d� � � d � � r;|� � � |� d
|j � d | j � �� � d S |� � � |j
� d | j � d
�� � d S d S )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> rK rW �delete_sectionrX rJ �getvalue�decoder$ rI r; �italics)rL rZ r@ �allowed_sectionsr\ �description_section� type_sections r rV z,DocumentModifiedShape._replace_documentationn s� � � � � � "�
�
� 3�
�
"�
"�#:�
;�
;� 3�
� '� '� )� )� )� � � � � � � �M�M�$�1� 2� 2� 2� � � � !�
�
� F�
�
"�
"�#9�
:�
:� F� � � !(� :�
9�
9� � �'7�7�7��*�*�<�8�8�8�� #*�"5�"5�6K�"L�"L� � � *� *� ,� ,� ,� � %� %�d�&;� <� <� <� #�.�.�|�<�<�L��$�$�&�&�-�-�g�6�6�A�A�'�J�J�
F� �'�'�)�)�)� �"�"�#L�G�L�#L�#L�D�N�#L�#L�M�M�M�M�M� �'�'�)�)�)� �"�*�*�+D�t�~�+D�+D�+D�E�E�E�E�E�9 F� Fr N)�__name__�
__module__� __qualname__rQ rY rV r+ r r rF rF W sF � � � � � �4� 4� 4� � � � $F� $F� $F� $F� $Fr rF r )
r r r r r& r3 r5 r9 rD rF r+ r r �<module>rn s� �� ���� ����� � �*-� -� -� � � �N� N� N�&� &� &�� � � 59�!� !� !� !�";F� ;F� ;F� ;F� ;F� ;F� ;F� ;F� ;F� ;Fr