HEX
Server: LiteSpeed
System: Linux us-phx-web1284.main-hosting.eu 4.18.0-553.109.1.lve.el8.x86_64 #1 SMP Thu Mar 5 20:23:46 UTC 2026 x86_64
User: u300739242 (300739242)
PHP: 8.2.30
Disabled: system, shell_exec, passthru, mysql_list_dbs, ini_alter, dl, symlink, link, chgrp, leak, popen, apache_child_terminate, virtual, mb_send_mail
Upload Files
File: //opt/alt/python311/lib/python3.11/site-packages/botocore/docs/__pycache__/params.cpython-311.pyc
�

/�;f�-��r�ddlmZddlmZGd�de��ZGd�de��ZGd�de��Zd	S)
�)�ShapeDocumenter)�py_type_namec�f�eZdZd
d�Zd�Z	d
d�Z	d
d�Z	d
d�Z			dd�Zd�Z	d	�Z
d
�Zd�Zd�Z
dS)�BaseParamsDocumenterNc�@�g}|�|||d||���dS)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      �G/opt/alt/python311/lib/python3.11/site-packages/botocore/docs/params.py�document_paramsz$BaseParamsDocumenter.document_paramssB�����(�(�������
	)�	
�	
�	
�	
�	
�c�$�|j||fi|��dS�N��_add_member_documentation�rrr	�kwargss    r�document_recursive_shapez-BaseParamsDocumenter.document_recursive_shape+s%��&��&�w��@�@��@�@�@�@�@rc�$�|j||fi|��dSrr)rrr	r
rr
rs       r�document_shape_defaultz+BaseParamsDocumenter.document_shape_default.s'��	'��&�w��@�@��@�@�@�@�@rc�2�|j||fi|��|j}|�|jd|jji���}|�|��|�|||d���|�d��}|�|��dS)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���/�/���w���0A�&B�0�
�
�
�	
� � ��/�/�/��(�(�!����		)�	
�	
�	
��)�)�*�5�5�����w�'�'�'�'�'rc�:�|j||fi|��|�dd|jji���}|�|��|�||j��|�|jjd|jji���}|j���|�|��|�||j|d���|�d��}	|�	|	��|�	|	��dS)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�^�4�.�
�
��	
� � ��-�-�-��&�&�{�E�I�>�>�>��/�/��K��w���0@�&A�0�
�
�
�	��"�"�$�$�$�� � ��/�/�/��(�(�!��+���		)�	
�	
�	
��-�-�i�8�8�����{�+�+�+����{�+�+�+�+�+rc��|�|j|��}|�|||���|D]]}	|r|	|vr�	||	}
|�|	d|
ji���}|�|��|�||
||	����^|�d��}|�|��dS)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�D���&�&�w��D�&�A�A�A��
	�
	�E��
�5�G�+�+��!�%�.�K�#�3�3����)9�:�4���M�
�$�$�]�3�3�3��,�,�%�!���	
-�
�
�
�
��)�)�/�:�:�����w�'�'�'�'�'rc��dSr�rs    rrz.BaseParamsDocumenter._add_member_documentation}s���rc�P�|r#|���}|D]}|||j<�
|Sr)�copyr)rr2rr3s    rr1z*BaseParamsDocumenter._add_members_to_shape�s:���	,��l�l�n�n�G� �
,�
,��&+���
�#�#��rc��|�|��}t|j��}d}|�|�||z��n|j�||z��|�d��dS)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�s����8�8��?�?���u��/�/�����&�
���{�_�<�=�=�=�=���&�&�{�W�'<�=�=�=����3�����rc�j�|j���|j���dSr)r*r+�new_line�rrs  rr"z(BaseParamsDocumenter._start_nested_param��0���
�������
��� � � � � rc�j�|j���|j���dSr)r*�dedentrErFs  rr#z&BaseParamsDocumenter._end_nested_param�rGr�NN)NNN)�__name__�
__module__�__qualname__rrrr&r.r4rr1rCr"r#r6rrrrs�������
�
�
�
�2A�A�A�>B�A�A�A�A�>B�(�(�(�(�&>B�,�,�,�,�@��
�(�(�(�(�:
�
�
���� � � �!�!�!�!�!�!�!�!rrc�$�eZdZdZdZdd�Zd�ZdS)�ResponseParamsDocumenterz5Generates the description for the response parameterszresponse-paramsNc�6�|�d��}|�d��|�2|j�d|z��|�d��|�d��}|�||��|�d��}|jr�|j���t|dd��r�|�d	��}d
}	d�d�|j	�
��D����}
d
}|�|	|
z��|�d��}|j�|��|�|j��|j�
��dS)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�, c��g|]}d|z��S�z``%s``r6��.0r(s  r�
<listcomp>zFResponseParamsDocumenter._add_member_documentation.<locals>.<listcomp>����D�D�D��X��^�D�D�Drz3'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�note�tagged_union_members_str�unknown_code_example�examples
             rrz2ResponseParamsDocumenter._add_member_documentation�s����.�.�|�<�<�����4� � � �����#�#�D�4�K�0�0�0����s�#�#�#��.�.�|�<�<���/�/��e�D�D�D� '� 7� 7�8M� N� N����	J�!�'�.�.�0�0�0��u�/��7�7�
>�$+�$;�$;�-�%�%�!�%��,0�9�9�D�D�u�}�/A�/A�/C�/C�D�D�D�,�,�(�8�%�"�'�'��0H�(I�J�J�J�!�1�1�2I�J�J���
�'�'�(<�=�=�=�!�4�4�U�5H�I�I�I��
�#�#�%�%�%�%�%rc�&�|j|||fi|��dSr)r4)rrr	r
rs     r� document_shape_type_event_streamz9ResponseParamsDocumenter.document_shape_type_event_stream�s)��	+��*�7�E�7�M�M�f�M�M�M�M�Mrr)rKrLrM�__doc__�
EVENT_NAMError6rrrOrO�sH������?�?�"�J�%&�%&�%&�%&�NN�N�N�N�NrrOc�:�eZdZdZdZ	d	d�Z			d
d�Zd�Zd�ZdS)�RequestParamsDocumenterz4Generates the description for the request parameterszrequest-paramsNc�b�t|��dkr(|j||fi|��|j���|�|j|��}t
|��D]n\}}	|r|	|vr�||	}
|�|	d|
ji���}|j�	��|	|j
v}|�||
||	|����o|�d��}t|��dkr|j���|j�	��dS)N�r	r)rr	r
r�is_requiredr0)
�lenrr*r+r1r2�	enumerater!rrE�required_membersrrI)
rrr	r
rr
rr2�ir3r$r%rvs
             rr4z5RequestParamsDocumenter.document_shape_type_structure�sf���w�<�<�!���*�D�*�7�E�D�D�V�D�D�D��M� � �"�"�"��,�,�U�]�G�D�D��!�'�*�*�	�	�H�A�u��
�5�G�+�+��!�%�.�K�#�3�3����)9�:�4���M�
��(�(�*�*�*��5�#9�9�K��,�,�%�!���'�
-�
�
�
�
��)�)�/�:�:���w�<�<�!����M� � �"�"�"��
��� � � � � rFc�Z�|�|��}|�t|j��}|r�|�d��}|�d|�d|����|�d��}	|	j���|�d��}
|
�d|z��n�|�d��}
|
�d��|�2|
j�d|z��|
�d	��|�d��}|�||��|r]|�d
��}|j�	��|j�d��|�d	��|j
r�|�d��}|j�	��t|d
d��re|�d��}
d}d�d�|j
���D����}|
�||z��|�|j
��|�||��|�d��}|j���dS)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. rXc��g|]}d|z��SrZr6r[s  rr]zERequestParamsDocumenter._add_member_documentation.<locals>.<listcomp>!r^rz	end-param)r;rr<r!r=r*rEr_rCr+r`rarbr2rcre� _add_special_trait_documentationrf)rrr	r�is_top_level_paramrvrrAr?�end_type_sectionrg�is_required_sectionrhrirjrk�end_param_sections                 rrz1RequestParamsDocumenter._add_member_documentation�s����0�0��7�7���?�"�5�?�3�3�G��	I�"�2�2�<�@�@�L����9��9�9��9�9�:�:�:�+�;�;�<L�M�M���"�+�+�-�-�-�"�2�2�<�@�@�L����}�t�3�4�4�4�4�#�2�2�<�@�@�L����t�$�$�$����"�'�'��t��4�4�4��"�"�3�'�'�'�"�2�2�<�@�@�L��3�3�L�%�H�H�H��	+�")�"9�"9�-�"H�"H���%�,�,�.�.�.��%�*�*�<�8�8�8��%�%�c�*�*�*���	P�$+�$;�$;�%�%�%�!�
"�'�.�.�0�0�0��u�/��7�7�
K�$+�$;�$;�-�%�%�!�D��
,0�9�9�D�D�u�}�/A�/A�/C�/C�D�D�D�,�,�(�"�'�'��0H�(I�J�J�J�!�4�4�U�5H�I�I�I��1�1�2G��O�O�O�#�3�3�K�@�@����-�-�/�/�/�/�/rc�F�d|jvr|�|��dSdS)N�idempotencyToken)�metadata�!_append_idempotency_documentation)rrr	s   rr}z8RequestParamsDocumenter._add_special_trait_documentation)s1�����/�/��2�2�7�;�;�;�;�;�0�/rc�4�d}|�|��dS)Nz,This field is autopopulated if not provided.)r=)rr�	docstrings   rr�z9RequestParamsDocumenter._append_idempotency_documentation-s��B�	��
�
�i� � � � � rrJ)NFF)	rKrLrMrprqr4rr}r�r6rrrsrs�sx������>�>�!�J�>B�!�!�!�!�@� ��
70�70�70�70�r<�<�<�!�!�!�!�!rrsN)�botocore.docs.shaper�botocore.docs.utilsrrrOrsr6rr�<module>r�s���0�/�/�/�/�/�,�,�,�,�,�,�I!�I!�I!�I!�I!�?�I!�I!�I!�X/N�/N�/N�/N�/N�3�/N�/N�/N�d`!�`!�`!�`!�`!�2�`!�`!�`!�`!�`!r