o

�h��@s�dd
lZddl
mZ
ddlmZ
ddlmZmZ
ddlm	Z	
ddl
mZ
ddlm
Z

ddlmZ
dd	lmZmZmZ
d
Zddei
i
Zddd
g
i
i
ZGdd�de
�Z	ddd�
Z	ddd�
Zd
S)�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@seZ
dZd
d�ZdS)�ActionDocumenterc
	Cs�
|jj
}i}|D]}|||j<qt|jj�
}t|�
|jd
<t|
dddd�
t	�
|ji�}t|�
D]�}t|dd�}|�
d�
}	|	j�|jd	�
|	�d
|���

|�|�

|�
|�
}
|
du
rc|�
d�
�|
�

|j
|d|j�d
�i
d�}|dvr�|jjr�t|||j|jjjjj|jj|jd�
n||vr�t||j|jjjjj|||jd�
nt||||�
tj�|j|j �|j!��}|�"||�
q0dS)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_path�rP�G/usr/local/CyberPanel/lib/python3.10/site-packages/boto3/docs/action.py�document_actions1sn





�


�














�






�





�

�


��z!ActionDocumenter.document_actionsN)�__name__�
__module__�__qualname__rRrPrPrPrQr0s
rTcCs�|�|j
j�
}t�|
i��|jt|j
j�
�}d
}|jr!t	|jj
�
}t	|
�
}	|j|
kr,|
}	|�d|	�d|j��}
|j�dd��|j��}t
|||||j|
|||d�	
dS)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 = rr�)	r�method_name�operation_modelr$�method_description�example_prefix�
exclude_input�resource_action_model�include_signatureN)rY�request�	operation�
IGNORE_PARAMSr/r)r�params�resourcer�type�service_namerr	�
documentation)rr#r$r'r&r^rY�
ignore_params�example_return_value�example_resource_namer[�full_action_namerPrPrQr=rs8
�


�





��









�r=c	Cs~d
t|�
�dt
|jj�
�d|�d�}t
|�
}|j|kr|}|�d|
��}	|j�dd��|
��}
t||
ti|�|||	|d�
d	S)
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.
    zCalls :py:meth:`z.Client.z"` to update the attributes of the ze resource. Note that the load and reload methods are the same method and can be used interchangeably.rrrW)rrXrYr$rZr[r^N)	rrr_r`rerr/rr)rr"r#r$r%r&r^rrir[rjrPrPrQr8�s(

���













�r8)
T)r>�botocorer�botocore.docs.bcdoc.restdocr�botocore.docs.methodrr�botocore.modelr�botocore.utilsr�boto3.docs.baser�boto3.docs.methodr	�boto3.docs.utilsr
rr�PUT_DATA_WARNING_MESSAGEr.rarr=r8rPrPrPrQ�<module>
s$





�H
�>�