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__/utils.cpython-311.pyc
�

/�;f|��2�ddlZddlmZd�Zd�Zd�Zedgd���ZGd�de��ZGd	�d
��ZGd�d��Z	Gd
�d��Z
dddddd�Zejd�
eeje������Zd�Zd�ZdS)�N)�
namedtuplec�>�dddddddd��||��S)z�Get the Python type name for a given model type.

        >>> py_type_name('list')
        'list'
        >>> py_type_name('structure')
        'dict'

    :rtype: string
    �bytes�string�float�integer�dict�datetime)�blob�	character�double�long�map�	structure�	timestamp��get��	type_names �F/opt/alt/python311/lib/python3.11/site-packages/botocore/docs/utils.py�py_type_namers9�����������
�c�)�Y��� �c�D�ddddddddddd	�
�|d
��S)z�Get the Python default value for a given model type.

        >>> py_default('string')
        ''string''
        >>> py_default('list')
        '[...]'
        >>> py_default('unknown')
        '...'

    :rtype: string
    z123.0�123z'string'zb'bytes'z
True|Falsez[...]z{...}zdatetime(2015, 1, 1))
r
rrrr�boolean�listrrrz...rrs r�
py_defaultr&sB�����������+���
�c�)�U���rc�R�|j�d��}|j�dd��}|�d��r
|dd�}|�d��r
|dd�}|r1|���|���vr	|d	|�d
�z
}|S)zwGenerate the official name of an AWS Service

    :param service_model: The service model representing the service
    �serviceFullName�serviceAbbreviation��Amazon�N�AWS�z (�))�metadatar�
startswith�lower)�
service_model�
official_name�
short_names   r�get_official_service_namer-@s���
"�*�.�.�/@�A�A�M��'�+�+�,A�2�F�F�J����X�&�&�$�����^�
����U�#�#�$�����^�
��,�j�&�&�(�(�
�0C�0C�0E�0E�E�E��+�j�+�+�+�+�
��r�DocumentedShape)�namer�
documentationr'�members�required_membersc�*��eZdZdZ			d�fd�	Z�xZS)r.zBUse this class to inject new shapes into a model for documentationNc	�j��|�g}|�g}|�g}t���|||||||��S�N)�super�__new__)�clsr/rr0r'r1r2�	__class__s       �rr7zDocumentedShape.__new__`sU������H��?��G��#�!���w�w����������
�
�	
r)NNN)�__name__�
__module__�__qualname__�__doc__r7�
__classcell__)r9s@rr.r.]sN�������L�L����
�
�
�
�
�
�
�
�
�
rc��eZdZdd�Zd�ZdS)�AutoPopulatedParamNc�8�||_||_|�	d|_dSdS)Nz{Please note that this parameter is automatically populated if it is not provided. Including this parameter is not required
)r/�param_description)�selfr/rBs   r�__init__zAutoPopulatedParam.__init__{s2����	�!2����$��
�"�"�"�%�$rc���|�d��ry|j|jvri|�|j��}d|jvr|�d��|�d��}|�|j��dSdS|�d��r?|�d��}|j|jvr|�|j��dSdSdS)z�Documents auto populated parameters

        It will remove any required marks for the parameter, remove the
        parameter from the example, and add a snippet about the parameter
        being autopopulated in the description.
        zdocs.request-paramszis-required�param-documentationzdocs.request-example�structure-valueN)r(r/�available_sections�get_section�delete_section�writelnrB�rC�
event_name�section�kwargs�description_sections     r�document_auto_populated_paramz0AutoPopulatedParam.document_auto_populated_param�s��� � �!6�7�7�	2��y�G�6�6�6�!�-�-�d�i�8�8�� �G�$>�>�>��*�*�=�9�9�9�&-�&9�&9�)�'�'�#�$�+�+�D�,B�C�C�C�C�C�7�6��
"�
"�#9�
:�
:�	2��)�)�*;�<�<�G��y�G�6�6�6��&�&�t�y�1�1�1�1�1�	2�	2�6�6rr5)r:r;r<rDrQ�rrr@r@zs7����������2�2�2�2�2rr@c��eZdZdZd�Zd�ZdS)�HideParamFromOperationsa>Hides a single parameter from multiple operations.

    This method will remove a parameter from documentation and from
    examples. This method is typically used for things that are
    automatically populated because a user would be unable to provide
    a value (e.g., a checksum of a serialized XML request body).c���||_t��|_t��|_d}d}|D]@}|j�|||fz��|j�|||fz���AdS)a(
        :type service_name: str
        :param service_name: Name of the service to modify.

        :type parameter_name: str
        :param parameter_name: Name of the parameter to modify.

        :type operation_names: list
        :param operation_names: Operation names to modify.
        z*docs.request-params.%s.%s.complete-sectionz+docs.request-example.%s.%s.complete-sectionN)�_parameter_name�set�_params_events�_example_events�add)rC�service_name�parameter_name�operation_names�param_template�example_templater/s       rrDz HideParamFromOperations.__init__�s��� .���!�e�e���"�u�u���E��H��#�	N�	N�D���#�#�N�l�D�5I�$I�J�J�J�� �$�$�%5��t�8L�%L�M�M�M�M�	N�	Nrc��||jvr|�d��}n||jvrdS|j|jvr|�|j��dSdS)NrG)rYrIrXrVrHrJ)rCrMrNrOs    r�
hide_paramz"HideParamFromOperations.hide_param�so����-�-�-��)�)�*;�<�<�G�G�
�t�2�
2�
2��F���7�#=�=�=��"�"�4�#7�8�8�8�8�8�>�=rN)r:r;r<r=rDrarRrrrTrT�sA������D�D�N�N�N�*9�9�9�9�9rrTc��eZdZdZd�Zd�ZdS)�AppendParamDocumentationz-Appends documentation to a specific parameterc�"�||_||_dSr5)rV�_doc_string)rCr\�
doc_strings   rrDz!AppendParamDocumentation.__init__�s��-���%����rc��|j|jvrK|�|j��}|�d��}|�|j��dSdS)NrF)rVrHrIrKrerLs     r�append_documentationz-AppendParamDocumentation.append_documentation�sc����7�#=�=�=��)�)�$�*>�?�?�G�")�"5�"5�6K�"L�"L���'�'��(8�9�9�9�9�9�>�=rN)r:r;r<r=rDrhrRrrrcrc�s8������7�7�&�&�&�:�:�:�:�:rrcz\nz\rz\tz\bz\f)�
�
�	���|c�B�t|�d��S)Nr)�	_CONTROLS�group)�matchs r�<lambda>rs�s��	�%�+�+�a�.�.�(A�rc�B�t�t|��Sr5)�_ESCAPE_CONTROLS_RE�sub�_CONTROLS_MATCH_HANDLER)�values r�escape_controlsry�s���"�"�#:�E�B�B�Br)�re�collectionsrrrr-�_DocumentedShaper.r@rTrcrp�compile�joinr�escaperurwryrRrr�<module>r�s���
�	�	�	�"�"�"�"�"�"� � � �*���4
�
�
� �:�����
�
��
�
�
�
�
�&�
�
�
�:2�2�2�2�2�2�2�2�B$9�$9�$9�$9�$9�$9�$9�$9�N:�:�:�:�:�:�:�:��
�
�
�
�
�
�	�!�b�j����#�#�b�i��*C�*C�!D�!D�E�E��A�A��C�C�C�C�Cr