File: //opt/alt/python311/lib/python3.11/site-packages/boto3/docs/__pycache__/subresource.cpython-311.pyc
�
/�;f� � �| � d dl Z d dlmZ d dlmZ d dlmZ d dlmZ d dl m
Z
m Z m Z m
Z
G d� de� � Z d d
�ZdS ) � N)�
xform_name)�DocumentStructure)�get_service_module_name)�NestedDocumenter)�add_resource_type_overview�!get_identifier_args_for_signature�get_identifier_description�!get_identifier_values_for_examplec � � e Zd Zd� ZdS )�SubResourceDocumenterc � � t |ddd�� � t | j j j j d� �� � }g }|| j d< |D �]/}|� |j � � t |j d� � � }|�
d
� � }|j � | j
d � � |� d |j � �� � |� |j � � |�
|j d
| j � d�i�� � }t# || j || j �� � t( j � | j | j � | j � � � }|� ||j � � ��1d S )Nz
Sub-resourcesz�Sub-resources are methods that create a new instance of a child resource. This resource's identifiers get passed along to the child.�subresources_intro)�section�
resource_type� description�
intro_linkc � � | j S )N)�name)� sub_resources �I/opt/alt/python311/lib/python3.11/site-packages/boto3/docs/subresource.py�<lambda>z>SubResourceDocumenter.document_sub_resources.<locals>.<lambda>* s � �\�%6� � )�keyz
sub-resources�html)�target�
breadcrumb�indexz / Sub-Resource / � qualifier�.)�context)r �
resource_name�sub_resource_model�
service_model)r �sorted� _resource�meta�resource_model� subresources�
member_map�appendr r �add_new_section�style�ref�_resource_class_name�write�add_title_section�
class_name�document_sub_resource�_resource_name�_service_model�os�path�join�_root_docs_path�
_service_name�_resource_sub_path�
write_to_file) �selfr �
sub_resources�sub_resources_listr �sub_resource_doc�breadcrumb_section�sub_resource_section�sub_resources_dir_paths r �document_sub_resourcesz,SubResourceDocumenter.document_sub_resources s� � �"��)�'� ,�
�
�
�
� � �N� � .� ;�6�6�
�
�
�
� ��+=����(� )� � �L� � %� %�l�&7� 8� 8� 8� 0� �!�&� � � � � "2�!A�!A�,�!O�!O� � � $� (� (��)B�G� L� L� L� � $� $�%M�,�:K�%M�%M� N� N� N� � .� .�|�/@� A� A� A�#3�#C�#C� �!�$�� �&;�&;�&;�<� $D� $� $� �
"�,� "� 1�#/� "� 1�
�
�
�
� &(�W�\�\��$��%�'��*�,�&� &� "�
� *� *�&� �(9�
�
�
�
�9 � r N)�__name__�
__module__� __qualname__rC � r r r r s# � � � � � �/� /� /� /� /r r Tc �� � g }|j j D ]4}|j dk r'|� t |j � � � � �5|rNt
|� � }| j � dd� � � |j � �}| j
� ||� � | � d� � } d|j j
� d�}
| � |
� � | � d� � } t |� � } t |� � }
|j |k r|}
d� t |j j
� � |
|j | � � }| j
� � � | � |� � | j
� � � | � d � � }|D ]}}t+ |j |� � }
|� d
|� d �� � |j
� � � |� d |� d
|
� �� � |j
� � � �~| � d� � }|j
� � � |� d� t/ |� � |j j
� � � � |j
� � � |� d|j j
� d�� � |j
� � � dS )aj Documents a resource action
:param section: The section to write to
:param resource_name: The name of the resource
:param sub_resource_model: The model of the subresource
:param service_model: The model of the service
:param include_signature: Whether or not to include the signature.
It is useful for generating docstrings.
�inputr � z method-introz
Creates a z
resource.�examplez{} = {}.{}({})�paramsz:type z: stringz:param z: �returnz:rtype: :py:class:`{}.{}`z :returns: A z resourceN)�resource� identifiers�sourcer* r r r r �getr r, �start_sphinx_py_methodr+ �type�include_doc_stringr
� service_name�format�start_codeblockr/ �
end_codeblockr �new_liner )r r! r" r# �include_signature�identifiers_needed�
identifier�signature_args�full_sub_resource_name�method_intro_sectionr �example_section�example_values�example_resource_namerK �
param_section�return_sections r r2 r2 O s � �( ��(�1�=� E� E�
� � �� '� '� � %� %�j��1B�&C�&C� D� D� D���
�:�;M�N�N����"�"�;��3�3� N�5G�5L� N� N� � �
�,�,� "�N�
�
�
� #�2�2�>�B�B��K� 1� :� ?�K�K�K�K��+�+�K�8�8�8� �-�-�i�8�8�O�6�7I�J�J�N� &�}� 5� 5���!�]�2�2� -� � �%�%��%�.�3�4�4� �� �� � �G� ��)�)�+�+�+����'�"�"�"���'�'�)�)�)��+�+�H�5�5�M�(� '� '�
�0� � #�Z�
�
� � ��� 9�Z� 9� 9� 9�:�:�:���$�$�&�&�&���� A�j� A� A�K� A� A�B�B�B���$�$�&�&�&�&� �,�,�X�6�6�N���!�!�#�#�#����#�*�*� #�M� 2� 2� � '� ,�
�
�� � � ��!�!�#�#�#����B�)�2�7�B�B�B�� � � ��!�!�#�#�#�#�#r )T)r5 �botocorer �botocore.docs.bcdoc.restdocr �botocore.utilsr �boto3.docs.baser �boto3.docs.utilsr r r r
r r2 rG r r �<module>rj s� ��
� � � � � � � � � � 9� 9� 9� 9� 9� 9� 2� 2� 2� 2� 2� 2� ,� ,� ,� ,� ,� ,�� � � � � � � � � � � �0� 0� 0� 0� 0� ,� 0� 0� 0�p � J$� J$� J$� J$� J$� J$r