o
    .&ßaŸ5  ã                   @   sœ   d Z ddlmZ ddlZddlZddlmZ ddlmZ ddlmZ ddl	m
Z
 dd	„ Zd
d„ Zdd„ ZG dd„ deƒZG dd„ deƒZG dd„ deƒZdS )aQ  User input parameter validation.

This module handles user input parameter validation
against a provided input model.

Note that the objects in this module do *not* mutate any
arguments.  No type version happens here.  It is up to another
layer to properly convert arguments to any required types.

Validation Errors
-----------------


é    )ÚsixN)Údatetime)Úparse_to_aware_datetime)Úis_json_value_header)ÚParamValidationErrorc                 C   s,   t ƒ }| | |¡}| ¡ rt| ¡ d�‚dS )av  Validates input parameters against a schema.

    This is a convenience function that validates parameters against a schema.
    You can also instantiate and use the ParamValidator class directly if you
    want more control.

    If there are any validation errors then a ParamValidationError
    will be raised.  If there are no validation errors than no exception
    is raised and a value of None is returned.

    :param params: The user provided input parameters.

    :type shape: botocore.model.Shape
    :param shape: The schema which the input parameters should
        adhere to.

    :raise: ParamValidationError

    ©ÚreportN)ÚParamValidatorÚvalidateÚ
has_errorsr   Úgenerate_report)ÚparamsÚshapeÚ	validatorr   © r   ú3/usr/lib/python3/dist-packages/botocore/validate.pyÚvalidate_parameters   s
   ÿr   c                    s   ‡ fdd„}|S )Nc                    s   ‡ ‡fdd„}‡fdd„‰ |S )Nc                    s    ˆ |||ƒrˆ| ||||ƒS d S ©Nr   ©ÚselfÚparamr   ÚerrorsÚname©Ú_type_checkÚfuncr   r   Ú_on_passes_type_check6   s   ÿzKtype_check.<locals>._create_type_check_guard.<locals>._on_passes_type_checkc                    s2   t | ˆ ƒsdd„ ˆ D ƒ}|j|d| |d� dS dS )Nc                 S   ó   g | ]}t  |¡‘qS r   ©r   Ú	text_type©Ú.0Útr   r   r   Ú
<listcomp><   ó    zUtype_check.<locals>._create_type_check_guard.<locals>._type_check.<locals>.<listcomp>úinvalid type©r   Úvalid_typesFT)Ú
isinstancer   )r   r   r   Úvalid_type_names©r'   r   r   r   :   s   

ÿzAtype_check.<locals>._create_type_check_guard.<locals>._type_checkr   )r   r   r*   r   r   Ú_create_type_check_guard5   s   z,type_check.<locals>._create_type_check_guardr   )r'   r+   r   r*   r   Ú
type_check4   s   r,   c                 C   sr   d}t dƒ}d|jv r|jd }||k rd}nt|dƒr*|j d¡r*d}||k r*d}|r7|j| |||d� d S d S )	NFz-infÚminTÚserializationÚ	hostLabelé   )r   Úmin_allowed)ÚfloatÚmetadataÚhasattrr.   Úgetr   )r   Úvaluer   Ú
error_typer   Úfailedr1   r   r   r   Úrange_checkF   s   

€
ÿr9   c                   @   s<   e Zd Zdd„ Zdd„ Zdd„ Zdd„ Zd	d
„ Zdd„ ZdS )ÚValidationErrorsc                 C   s
   g | _ d S r   ©Ú_errors©r   r   r   r   Ú__init__X   s   
zValidationErrors.__init__c                 C   s   | j rdS dS ©NTFr;   r=   r   r   r   r   [   s   zValidationErrors.has_errorsc                 C   s*   g }| j D ]
}| |  |¡¡ qd |¡S )NÚ
)r<   ÚappendÚ_format_errorÚjoin)r   Úerror_messagesÚerrorr   r   r   r   `   s   

z ValidationErrors.generate_reportc                 C   sP  |\}}}|   |¡}|dkrd||d f S |dkr(d||d d |d ¡f S |d	krAd
||d tt|d ƒƒd |d ¡f S |dkrR|d }d||d |f S |dkrc|d }d||d |f S |dkrod||d f S |dkrˆd||d tt|d ƒƒd |d ¡f S |dkr—d|d |d ¡f S |dkr¦d|d |d ¡f S d S )Númissing required fieldz&Missing required parameter in %s: "%s"Úrequired_nameúunknown fieldz1Unknown parameter in %s: "%s", must be one of: %sÚunknown_paramz, Úvalid_namesr%   zCInvalid type for parameter %s, value: %s, type: %s, valid types: %sr   r'   úinvalid ranger1   z>Invalid value for parameter %s, value: %s, valid min value: %súinvalid lengthz@Invalid length for parameter %s, value: %s, valid min length: %súunable to encode to jsonz2Invalid parameter %s must be json serializable: %sÚ
type_errorúinvalid type for documentzLInvalid type for document parameter %s, value: %s, type: %s, valid types: %súmore than one inputzkInvalid number of parameters set for tagged union structure %s. Can only set one of the following keys: %s.z. Úmembersúempty inputzDMust set one of the following keys for tagged unionstructure %s: %s.)Ú	_get_namerC   ÚstrÚtype)r   rE   r7   r   Ú
additionalr1   r   r   r   rB   f   sv   

ÿÿþÿýÿÿÿÿ
ÿÿÿÿÿüÿÿ	þÿÿÿÿzValidationErrors._format_errorc                 C   s"   |sdS |  d¡r|dd … S |S )NÚinputÚ.r0   )Ú
startswith)r   r   r   r   r   rS   ©   s
   
zValidationErrors._get_namec                 K   s   | j  |||f¡ d S r   )r<   rA   )r   r   ÚreasonÚkwargsr   r   r   r   ±   s   zValidationErrors.reportN)	Ú__name__Ú
__module__Ú__qualname__r>   r   r   rB   rS   r   r   r   r   r   r:   W   s    Cr:   c                   @   s   e Zd ZdZdd„ Zdd„ Zdd„ Zdd	„ Zd
d„ Ze	e
fd�dd„ ƒZe	ejd�dd„ ƒZe	eefd�dd„ ƒZe	e
fd�dd„ ƒZe	ejd�dd„ ƒZdd„ Ze	efd�dd„ ƒZe	eejfej d�dd„ ƒZeZe	ejd�dd„ ƒZdd „ Zd!d"„ Zd#S )$r	   z+Validates parameters against a shape model.c                 C   s   t ƒ }| j|||dd� |S )aÞ  Validate parameters against a shape model.

        This method will validate the parameters against a provided shape model.
        All errors will be collected before returning to the caller.  This means
        that this method will not stop at the first error, it will return all
        possible errors.

        :param params: User provided dict of parameters
        :param shape: A shape model describing the expected input.

        :return: A list of errors.

        Ú )r   )r:   Ú	_validate)r   r   r   r   r   r   r   r
   ¸   s   zParamValidator.validatec                 C   s,   t |ƒr| jS |jdkr|jr| jS d S d S )NÚ	structure)r   Ú_validate_jsonvalue_stringÚ	type_nameÚis_document_typeÚ_validate_document)r   r   r   r   r   Ú_check_special_validation_casesÊ   s
   ÿz.ParamValidator._check_special_validation_casesc                 C   s>   |   |¡}|r|||||ƒ d S t| d|j ƒ||||ƒ d S )Nz_validate_%s)rf   Úgetattrrc   )r   r   r   r   r   Úspecial_validatorr   r   r   r`   Ð   s   
ÿzParamValidator._validatec              
   C   sL   zt  |¡ W d S  ttfy% } z|j|d|d� W Y d }~d S d }~ww )NrM   )rN   )ÚjsonÚdumpsÚ
ValueErrorÚ	TypeErrorr   )r   r   r   r   r   Úer   r   r   rb   Ø   s   €ÿz)ParamValidator._validate_jsonvalue_stringc           
   	   C   sÂ   |d u rd S t |tƒr|D ]}|  || |||¡ qd S t |tƒr8t|ƒD ]\}}|  |||d||f ¡ q%d S t |tjttt	fƒs_t
ttt	ttf}dd„ |D ƒ}	|j|d|t|ƒ|	d� d S d S )Nz%s[%d]c                 S   r   r   r   r    r   r   r   r#   í   r$   z5ParamValidator._validate_document.<locals>.<listcomp>rO   )r   Ú
param_typer'   )r(   Údictre   ÚlistÚ	enumerater   Ústring_typesÚintÚboolr2   rT   r   rU   )
r   r   r   r   r   ÚkeyÚindexÚentityr'   r)   r   r   r   re   à   s*   
ÿ


ÿÿ
ýýz!ParamValidator._validate_documentr*   c           	   	   C   sà   |j r"t|ƒdkr|j|d|jd� nt|ƒdkr"|j|d|jd� |j dg ¡D ]}||vr8|j|d||d� q)|j}g }|D ]}||vrR|j|d	|t|ƒd
� q@| |¡ q@|D ]}|  || |j| |d||f ¡ qZd S )Nr   rR   )rQ   r0   rP   ÚrequiredrF   )rG   Úuser_paramsrH   )rI   rJ   ú%s.%s)	Úis_tagged_unionÚlenr   rQ   r3   r5   rp   rA   r`   )	r   r   r   r   r   Úrequired_memberrQ   Úknown_paramsr   r   r   r   Ú_validate_structureó   s4   ÿÿ€
ÿÿÿz"ParamValidator._validate_structurec                 C   s   t |t|ƒ|d|ƒ d S )NrL   )r9   r|   r   r   r   r   Ú_validate_string  s   
zParamValidator._validate_stringc              	   C   sH   |j }t|t|ƒ|d|ƒ t|ƒD ]\}}|  |||d||f ¡ qd S )NrL   z%s[%s])Úmemberr9   r|   rq   r`   )r   r   r   r   r   Úmember_shapeÚiÚitemr   r   r   Ú_validate_list  s
   ÿzParamValidator._validate_listc           	   	   C   sR   |j }|j}| ¡ D ]\}}|  |||d||f ¡ |  |||d||f ¡ q
d S )Nz%s (key: %s)rz   )ru   r6   Úitemsr`   )	r   r   r   r   r   Ú	key_shapeÚvalue_shaperu   r6   r   r   r   Ú_validate_map#  s   ÿýzParamValidator._validate_mapc                 C   ó   t |||d|ƒ d S ©NrK   ©r9   r   r   r   r   Ú_validate_integer,  ó   z ParamValidator._validate_integerc                 C   sH   t |tttjfƒrd S t|dƒrd S |j|d|ttƒttƒdgd� d S )NÚreadr%   zfile-like objectr&   )r(   ÚbytesÚ	bytearrayr   r   r4   r   rT   r   r   r   r   Ú_validate_blob0  s   

ÿ
ÿzParamValidator._validate_blobc                 C   s   d S r   r   r   r   r   r   Ú_validate_boolean;  s   z ParamValidator._validate_booleanc                 C   rŠ   r‹   rŒ   r   r   r   r   Ú_validate_double?  rŽ   zParamValidator._validate_doublec                 C   rŠ   r‹   rŒ   r   r   r   r   Ú_validate_longE  rŽ   zParamValidator._validate_longc                 C   s6   |   |¡}|st t¡dg}|j|d||d� d S d S )Nztimestamp-stringr%   r&   )Ú_type_check_datetimer   r   r   r   )r   r   r   r   r   Úis_valid_typer)   r   r   r   Ú_validate_timestampI  s   


ÿþz"ParamValidator._validate_timestampc              
   C   s*   zt |ƒ W dS  tttfy   Y dS w r?   )r   rl   rk   ÚAttributeError)r   r6   r   r   r   r–   S  s   ýz#ParamValidator._type_check_datetimeN) r\   r]   r^   Ú__doc__r
   rf   r`   rb   re   r,   ro   r   r   rr   r€   rp   Útupler…   r‰   Úinteger_typesr�   r’   rt   r“   r2   ÚdecimalÚDecimalr”   Ú_validate_floatr•   r˜   r–   r   r   r   r   r	   µ   s6    














r	   c                   @   s   e Zd Zdd„ Zdd„ ZdS )ÚParamValidationDecoratorc                 C   s   || _ || _d S r   )Ú_param_validatorÚ_serializer)r   Úparam_validatorÚ
serializerr   r   r   r>   ^  s   
z!ParamValidationDecorator.__init__c                 C   sB   |j }|d ur| j ||j ¡}| ¡ rt| ¡ d�‚| j ||¡S )Nr   )Úinput_shaper¡   r
   r   r   r   r¢   Úserialize_to_request)r   Ú
parametersÚoperation_modelr¥   r   r   r   r   r¦   b  s   ÿÿz-ParamValidationDecorator.serialize_to_requestN)r\   r]   r^   r>   r¦   r   r   r   r   r    ]  s    r    )rš   Úbotocore.compatr   r�   ri   r   Úbotocore.utilsr   r   Úbotocore.exceptionsr   r   r,   r9   Úobjectr:   r	   r    r   r   r   r   Ú<module>   s    ^ )