Current File : //usr/lib/python3/dist-packages/boto3/docs/__pycache__/action.cpython-312.pyc
�

��e����ddlZddlmZddlmZddlmZmZddlm	Z	ddl
mZddlm
Z
ddlmZdd	lmZmZmZd
ZddeiiZddd
giiZGd�de
�Z	dd�Z	dd�Zy)�N)�
xform_name)�DocumentStructure)�document_custom_method�document_model_driven_method)�OperationModel)�get_service_module_name)�NestedDocumenter)�%document_model_driven_resource_method)�add_resource_type_overview�get_resource_ignore_params�get_resource_public_actionsa?
.. warning::
    It is recommended to use the :py:meth:`put_metric_data`
    :doc:`client method <../../cloudwatch/client/put_metric_data>`
    instead. If you would still like to use this resource method,
    please make sure that ``MetricData[].MetricName`` is equal to
    the metric resource's ``name`` attribute.
�Metric�put_data�	Namespacec��eZdZd�Zy)�ActionDocumenterc	�Z�|jj}i}|D]}|||j<�t|jj
�}t
|�|jd<t|ddd��tj|ji�}t
|�D�]}t|d��}|jd�}	|	jj|j d	�|	j#d
|���|j%|�|j|�}
|
� |jd�j#|
�|j|d|j&�d
�i��}|dvr�|jj(rlt+|||j|jj,j.j,j0|jj(|j2��nn||vrZt5||j|jj,j.j,j0|||j2��nt7||||�t8j:j=|j>|j@�|jB��}|jE||���y)N�actions�Actionsz�Actions call operations on resources.  They may automatically handle the passing in of arguments set from identifiers and some attributes.�
actions_intro)�section�
resource_type�description�
intro_link�html)�target�
breadcrumb�indexz / Action / �warning�	qualifier�.)�context)�load�reload)r�action_name�
resource_name�
event_emitter�
load_model�
service_model)rr&r'�action_modelr))#�_resource_modelr�namer
�	_resource�	__class__�sorted�
member_mapr�WARNING_MESSAGES�get�_resource_namer�add_new_section�style�ref�_resource_class_name�write�add_title_section�
class_namer#�document_load_reload_action�meta�client�events�_service_model�document_actionr�os�path�join�_root_docs_path�
_service_name�_resource_sub_path�
write_to_file)
�selfr�modeled_actions_list�modeled_actions�modeled_action�resource_actions�resource_warningsr%�
action_doc�breadcrumb_section�warning_message�action_section�actions_dir_paths
             �3/usr/lib/python3/dist-packages/boto3/docs/action.py�document_actionsz!ActionDocumenter.document_actions1s��#�3�3�;�;����2�	B�N�3A�O�N�/�/�0�	B�6��N�N�$�$�
��&,�,<�%=����	�"�"��#�8�'�		
�-�0�0��1D�1D�b�I��!�"2�3�*	D�K�*�;�v�F�J�!+�!;�!;�L�!I���$�$�(�(��)B�)B�G�L��$�$�|�K�=�%A�B��(�(��5�/�3�3�K�@�O��*��*�*�9�5�;�;�O�L�'�7�7��$����(9��&;�<�8��N��0�0�T�5I�5I�5N�5N�+�*� +�"&�"5�"5�"&�.�.�"5�"5�"<�"<�"A�"A�"H�"H�#�3�3�8�8�"&�"5�"5�
���/��*�"&�"5�"5�"&�.�.�"5�"5�"<�"<�"A�"A�"H�"H�!0��!=�"&�"5�"5��'�"�K�1A�+�1N��
 "�w�w�|�|��$�$��%�%�&��*�*�+� ��

�$�$�%5�{�C�U*	D�N)�__name__�
__module__�__qualname__rT�rUrSrr0s��>DrUrc�D�|j|jj�}tj	|i�j	|j
t
|jj��}d}|jrt|jj�}t|�}	|j|k(r|}	dj||	|j
�}
|jj	dd��|j
��}t|||||j|
|||��	y)a�Documents a resource action

    :param section: The section to write to

    :param resource_name: The name of the resource

    :param event_emitter: The event emitter to use to emit events

    :param action_model: The model of the action

    :param service_model: The model of the service

    :param include_signature: Whether or not to include the signature.
        It is useful for generating docstrings.
    �responsez
{} = {}.{}r �)	r�method_name�operation_modelr'�method_description�example_prefix�
exclude_input�resource_action_model�include_signatureN)r^�request�	operation�
IGNORE_PARAMSr2r,r�params�resourcer�type�service_name�formatr"r
�
documentation)rr&r'r*r)rcr^�
ignore_params�example_return_value�example_resource_namer`�full_action_names            rSr@r@rs��.$�3�3����&�&��O�"�%�%�m�R�8�<�<����"�<�#7�#7�#>�#>�?��M�&�����)�,�*?�*?�*D�*D�E��&�}�5���!�!�]�2� -��!�(�(��3�\�5F�5F��N��?�?���{�B�/�
0��1B�1B�0C�D��*��$�'�#�*�8�8�%�#�*�+�
rUc	�4�djt|�t|jj�|�}t|�}|j
|k(r|}|�d|��}	|jjdd��|��}
t||
ti|�|||	|��y)a�Documents the resource load action

    :param section: The section to write to

    :param action_name: The name of the loading action should be load or reload

    :param resource_name: The name of the resource

    :param event_emitter: The event emitter to use to emit events

    :param load_model: The model of the load action

    :param service_model: The model of the service

    :param include_signature: Whether or not to include the signature.
        It is useful for generating docstrings.
    z�Calls :py:meth:`{}.Client.{}` to update the attributes of the {} resource. Note that the load and reload methods are the same method and can be used interchangeably.r!r r\)rr]r^r'r_r`rcN)
rkrrrdrerjr"r2rr)rr%r&r'r(r)rcrror`rps           rSr;r;�s���6	;�;A�6�#�M�2��z�)�)�3�3�4��<
��'�}�5���!�!�]�2� -��-�.�a��}�=�N�!�/�/�-�-�k�2�>�?��}�M�� ��$�&�r�=�9�#�&�%�+�rU)T)rA�botocorer�botocore.docs.bcdoc.restdocr�botocore.docs.methodrr�botocore.modelr�botocore.utilsr�boto3.docs.baser	�boto3.docs.methodr
�boto3.docs.utilsrrr
�PUT_DATA_WARNING_MESSAGEr1rfrr@r;rYrUrS�<module>r{s���
��9��*�2�,�C�����
�z�3�4����J��
�6�7�
�?D�'�?D�P�
4�|�0rU