HEX
Server: nginx/1.24.0
System: Linux webserver 6.8.0-85-generic #85-Ubuntu SMP PREEMPT_DYNAMIC Thu Sep 18 15:26:59 UTC 2025 x86_64
User: wpuser (1002)
PHP: 8.3.6
Disabled: NONE
Upload Files
File: //lib/python3/dist-packages/botocore/docs/__pycache__/params.cpython-312.pyc
�

P��e�-��^�ddlmZddlmZGd�de�ZGd�de�ZGd�de�Zy	)
�)�ShapeDocumenter)�py_type_namec�d�eZdZd
d�Zd�Z	d
d�Z	d
d�Z	d
d�Z			dd�Zd�Z	d	�Z
d
�Zd�Zd�Z
y)�BaseParamsDocumenterNc�6�g}|j|||d||��y)a3Fills out the documentation for a section given a model shape.

        :param section: The section to write the documentation to.

        :param shape: The shape of the operation.

        :type include: Dictionary where keys are parameter names and
            values are the shapes of the parameter names.
        :param include: The parameter shapes to include in the documentation.

        :type exclude: List of the names of the parameters to exclude.
        :param exclude: The names of the parameters to exclude from
            documentation.
        N)�section�shape�history�name�include�exclude)�traverse_and_document_shape)�selfrr	rr
r
s      �6/usr/lib/python3/dist-packages/botocore/docs/params.py�document_paramsz$BaseParamsDocumenter.document_paramss.�����(�(�������
	)�	
�c�,�|j||fi|��y�N��_add_member_documentation�rrr	�kwargss    r�document_recursive_shapez-BaseParamsDocumenter.document_recursive_shape+s��&��&�&�w��@��@rc�,�|j||fi|��yrr)rrr	r
rr
rs       r�document_shape_defaultz+BaseParamsDocumenter.document_shape_default.s��	'��&�&�w��@��@rc�:�|j||fi|��|j}|j|jd|jji��}|j	|�|j|||d��|jd�}|j
|�y)Nr	��context�rr	r
rzend-list)r�member�add_new_sectionr�_start_nested_paramr�_end_nested_param)	rrr	r
rr
r�param_shape�
param_sections	         r�document_shape_type_listz-BaseParamsDocumenter.document_shape_type_list3s���	'��&�&�w��@��@��l�l���/�/����w����0A�0A�&B�0�
�
�	
� � ��/��(�(�!����		)�	
��)�)�*�5�����w�'rc�L�|j||fi|��|jdd|jji��}|j	|�|j||j�|j|j
jd|j
ji��}|jj�|j	|�|j||j
|d��|jd�}	|j|	�|j|	�y)N�keyr	rrzend-map)
rr!r(rr"�value�style�indentrr#)
rrr	r
rr
r�key_sectionr%�end_sections
          r�document_shape_type_mapz,BaseParamsDocumenter.document_shape_type_mapEs��	'��&�&�w��@��@��-�-��G�U�Y�Y�^�^�4�.�
��	
� � ��-��&�&�{�E�I�I�>��/�/��K�K���w����0@�0@�&A�0�
�
�	���"�"�$�� � ��/��(�(�!��+�+���		)�	
��-�-�i�8�����{�+����{�+rc�X�|j|j|�}|j|||��|D]S}	|r|	|vr�
||	}
|j|	d|
ji��}|j|�|j
||
||	���U|jd�}|j|�y)N)rr	rr�
end-structure)�_add_members_to_shape�membersrr!rr"rr#)rrr	r
rr
rrr2�paramr$r%s            r�document_shape_type_structurez2BaseParamsDocumenter.document_shape_type_structure`s����,�,�U�]�]�G�D���&�&�w��D�&�A��
	�E��5�G�+��!�%�.�K�#�3�3����)9�)9�:�4��M�
�$�$�]�3��,�,�%�!���	
-�
�
	��)�)�/�:�����w�'rc��yr�rs    rrz.BaseParamsDocumenter._add_member_documentation}s��rc�V�|r&|j�}|D]}|||j<�|Sr)�copyr)rr2rr3s    rr1z*BaseParamsDocumenter._add_members_to_shape�s2����l�l�n�G� �
,��&+���
�
�#�
,��rc���|j|�}t|j�}d}|�|j||z�n|jj||z�|jd�y)Nz(%s) --� )�_get_special_py_type_namer�	type_name�writer*�italics)r�type_sectionr	�special_py_type�py_type�type_formats      r�"_document_non_top_level_param_typez7BaseParamsDocumenter._document_non_top_level_param_type�sg���8�8��?���u���/�����&�
���{�_�<�=����&�&�{�W�'<�=����3�rc�l�|jj�|jj�yr)r*r+�new_line�rrs  rr"z(BaseParamsDocumenter._start_nested_param��"���
�
�����
�
��� rc�l�|jj�|jj�yr)r*�dedentrErFs  rr#z&BaseParamsDocumenter._end_nested_param�rGr�NN)NNN)�__name__�
__module__�__qualname__rrrr&r.r4rr1rCr"r#r6rrrrsY��
�2A�>B�A�>B�(�&>B�,�@��
�(�:
�� �!�!rrc�"�eZdZdZdZdd�Zd�Zy)�ResponseParamsDocumenterz5Generates the description for the response parameterszresponse-paramsNc�
�|jd�}|jd�|�/|jjd|z�|jd�|jd�}|j	||�|jd�}|j
r�|jj
�t|dd�r�|jd	�}d
}	dj|jj�D�
cgc]}
d|
z��	c}
�}d
}|j|	|z�|jd�}
|
jj|�|j|j
�|jj�ycc}
w)N�
param-name�- �%sr:�
param-type�param-documentation�is_tagged_unionF�param-tagged-union-docsaK.. note::    This is a Tagged Union structure. Only one of the     following top level keys will be set: %s.     If a client receives an unknown member it will     set ``SDK_UNKNOWN_MEMBER`` as the top level key,     which maps to the name or tag of the unknown     member. The structure of ``SDK_UNKNOWN_MEMBER`` is     as follows�, �``%s``z3'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}zparam-unknown-example)r!r=r*�boldrC�
documentationr+�getattr�joinr2�keys�	codeblock�include_doc_string�
new_paragraph)rrr	rr�name_sectionr?�documentation_section�tagged_union_docs�noter(�tagged_union_members_str�unknown_code_example�examples              rrz2ResponseParamsDocumenter._add_member_documentation�sb���.�.�|�<�����4� ������#�#�D�4�K�0����s�#��.�.�|�<���/�/��e�D� '� 7� 7�8M� N�����!�'�'�.�.�0��u�/��7�$+�$;�$;�-�%�!�%��,0�9�9�/4�}�}�/A�/A�/C�D��X��^�D�,�(�8�%�"�'�'��0H�(I�J�!�1�1�2I�J���
�
�'�'�(<�=�!�4�4�U�5H�5H�I��
�
�#�#�%��Es�5Fc�.�|j|||fi|��yr)r4)rrr	r
rs     r� document_shape_type_event_streamz9ResponseParamsDocumenter.document_shape_type_event_stream�s��	+��*�*�7�E�7�M�f�Mrr)rKrLrM�__doc__�
EVENT_NAMErrjr6rrrOrO�s��?�"�J�%&�NNrrOc�8�eZdZdZdZ	dd�Z			d	d�Zd�Zd�Zy)
�RequestParamsDocumenterz4Generates the description for the request parameterszrequest-paramsNc�R�t|�dkDr.|j||fi|��|jj�|j	|j
|�}t
|�D]n\}}	|r|	|vr�
||	}
|j|	d|
ji��}|jj�|	|jv}|j||
||	|���p|jd�}t|�dkDr|jj�|jj�y)N�r	r)rr	r
r�is_requiredr0)
�lenrr*r+r1r2�	enumerater!rrE�required_membersrrI)
rrr	r
rr
rr2�ir3r$r%rqs
             rr4z5RequestParamsDocumenter.document_shape_type_structure�s$���w�<�!��*�D�*�*�7�E�D�V�D��M�M� � �"��,�,�U�]�]�G�D��!�'�*�	�H�A�u��5�G�+��!�%�.�K�#�3�3����)9�)9�:�4��M�
���(�(�*��5�#9�#9�9�K��,�,�%�!���'�
-�
�	� �)�)�/�:���w�<�!���M�M� � �"��
�
��� rc���|j|�}|�t|j�}|ry|jd�}|j	d|�d|���|jd�}	|	j
j
�|jd�}
|
j	d|z�nv|jd�}
|
j	d�|�/|
j
jd|z�|
j	d	�|jd�}|j||�|rW|jd
�}|j
j�|j
jd�|j	d	�|jr�|jd�}|j
j�t|d
d�ra|jd�}
d}dj|jj�D�cgc]}d|z��	c}�}|
j	||z�|j|j�|j!||�|jd�}|j
j#�ycc}w)NrTz:type z: zend-param-typerQz:param %s: rRrSr:zis-requiredz
[REQUIRED]rUrVFrWzl.. note::    This is a Tagged Union structure. Only one of the     following top level keys can be set: %s. rXrYz	end-param)r;rr<r!r=r*rErZrCr+r[r\r]r2r^r`� _add_special_trait_documentationra)rrr	r�is_top_level_paramrqrrAr?�end_type_sectionrb�is_required_sectionrcrdrer(rf�end_param_sections                  rrz1RequestParamsDocumenter._add_member_documentation�sA���0�0��7���?�"�5�?�?�3�G��"�2�2�<�@�L������v�R��y�9�:�+�;�;�<L�M���"�"�+�+�-�"�2�2�<�@�L����}�t�3�4�#�2�2�<�@�L����t�$����"�"�'�'��t��4��"�"�3�'�"�2�2�<�@�L��3�3�L�%�H��")�"9�"9�-�"H���%�%�,�,�.��%�%�*�*�<�8��%�%�c�*����$+�$;�$;�%�%�!�
"�'�'�.�.�0��u�/��7�$+�$;�$;�-�%�!�D��
,0�9�9�/4�}�}�/A�/A�/C�D��X��^�D�,�(�"�'�'��0H�(I�J�!�4�4�U�5H�5H�I��1�1�2G��O�#�3�3�K�@�����-�-�/��
Es�1I1c�D�d|jvr|j|�yy)N�idempotencyToken)�metadata�!_append_idempotency_documentation)rrr	s   rrwz8RequestParamsDocumenter._add_special_trait_documentation)s!������/��2�2�7�;�0rc�*�d}|j|�y)Nz,This field is autopopulated if not provided.)r=)rr�	docstrings   rrz9RequestParamsDocumenter._append_idempotency_documentation-s��B�	��
�
�i� rrJ)NFF)	rKrLrMrkrlr4rrwrr6rrrnrn�s1��>�!�J�>B�!�@� ��
70�r<�!rrnN)�botocore.docs.shaper�botocore.docs.utilsrrrOrnr6rr�<module>r�s;��0�,�I!�?�I!�X/N�3�/N�d`!�2�`!r