U
���`�� � @ s d Z ddlmZ ddlmZ ddlmZ ddlmZmZ ddlZddl m
Z
ddl m Z dd l
mZmZmZmZmZmZmZmZ dd
lmZmZmZmZ dd lm Z m Z m Z e � � Z d d
� Z!G dd� de"�Z#G dd� de"�Z$G dd� de%�Z&dZ'G dd� de(�Z)e)de&fi �Z*dS )a
Extensible validation for Python dictionaries.
This module implements Cerberus Validator class
:copyright: 2012-2016 by Nicola Iarocci.
:license: ISC, see LICENSE for more details.
Full documentation is available at http://python-cerberus.org
� )�absolute_import)� literal_eval)�copy)�date�datetimeN)�warn)�errors)�
_int_types� _str_type� Container�Hashable�Iterable�Mapping�Sequence�Sized)�schema_registry�rules_set_registry�DefinitionSchema� SchemaError)�drop_item_from_tuple�readonly_classproperty�TypeDefinitionc C s dd� }|}| |_ |S )Nc S s t d��d S )NzcDummy method called. Its purpose is to hold justvalidation constraints for a rule in its docstring.)� RuntimeError)�self�
constraint�field�value� r �C/opt/alt/python38/lib/python3.8/site-packages/cerberus/validator.py�dummy* s �z(dummy_for_rule_validation.<locals>.dummy)�__doc__)Zrule_constraintsr �fr r r �dummy_for_rule_validation) s r" c @ s e Zd ZdZdS )�
DocumentErrorzBRaised when the target document is missing or has the wrong formatN��__name__�
__module__� __qualname__r r r r r r# 6 s r# c @ s e Zd ZdZdS )�_SchemaRuleTypeErrorzw
Raised when a schema (list) validation encounters a mapping.
Not supposed to be used outside this module.
Nr$ r r r r r( < s r( c sJ e Zd ZdZdZdZedeefd�ede fd�ede
fe f�ede fd�ed e
fd�ed
efd�ed eefd�ed efd�ed
efe f�edeefe f�edefd�ede fd�d� Ze� Z� fdd�Zedd� �Zdd� Zedd� �Zdd� Zd�d d �Z d d � Z d!d"� Z d#d$� Z d%d&� Z d'd(� Z!e"d)d*� �Z#e#j$d+d*� �Z#e"d,d-� �Z%e%j$d.d-� �Z%e"d/d0� �Z&e"d1d2� �Z'e'j$d3d2� �Z'e"d4d5� �Z(e"d6d7� �Z)e)j$d8d7� �Z)e"d9d:� �Z*e*j$d;d:� �Z*e"d<d=� �Z+e+j$d>d=� �Z+e"d?d@� �Z,e"dAdB� �Z-e"dCdD� �Z.e"dEdF� �Z/e/j$dGdF� �Z/e"dHdI� �Z0e"dJdK� �Z1e1j$dLdK� �Z1e"dMdN� �Z2e2j$dOdN� �Z2e3dPdQ� �Z4d�dRdS�Z5dTdU� Z6d�dWdX�Z7dYdZ� Z8d[d\� Z9d]d^� Z:d_d`� Z;dadb� Z<dcdd� Z=dedf� Z>dgdh� Z?didj� Z@edkdl� �ZAedmdn� �ZBdodp� ZCdqdr� ZDdsdt� ZEdudv� ZFdwdx� ZGdydz� ZHd{d|� ZId�d~d�ZJeJZKd�d�� ZLd�d�� ZMd�d�� ZNeOd��ZPd�d�� ZQd�d�� ZRd�d�� ZSd�d�� ZTd�d�� ZUd�d�� ZVd�d�� ZWd�d�� ZXd�d�� ZYd�d�� ZZd�d�� Z[d�d�� Z\d�d�� Z]d�d�� Z^d�d�� Z_d�d�� Z`d�d�� Zad�d�� ZbeOd��Zcd�d�� Zdd�d�� Zed�d�� Zfd�d�� Zgd�d�� ZheOd��ZieOd��Zjd�d�� Zkd�d�� Zld�d�� Zmd�d�� Znd�d�� Zod�d Zp� ZqS )��
BareValidatora�
Validator class. Normalizes and/or validates any mapping against a
validation-schema which is provided as an argument at class instantiation
or upon calling the :meth:`~cerberus.Validator.validate`,
:meth:`~cerberus.Validator.validated` or
:meth:`~cerberus.Validator.normalized` method. An instance itself is
callable and executes a validation.
All instantiation parameters are optional.
There are the introspective properties :attr:`types`, :attr:`validators`,
:attr:`coercers`, :attr:`default_setters`, :attr:`rules`,
:attr:`normalization_rules` and :attr:`validation_rules`.
The attributes reflecting the available rules are assembled considering
constraints that are defined in the docstrings of rules' methods and is
effectively used as validation schema for :attr:`schema`.
:param schema: See :attr:`~cerberus.Validator.schema`.
Defaults to :obj:`None`.
:type schema: any :term:`mapping`
:param ignore_none_values: See :attr:`~cerberus.Validator.ignore_none_values`.
Defaults to ``False``.
:type ignore_none_values: :class:`bool`
:param allow_unknown: See :attr:`~cerberus.Validator.allow_unknown`.
Defaults to ``False``.
:type allow_unknown: :class:`bool` or any :term:`mapping`
:param require_all: See :attr:`~cerberus.Validator.require_all`.
Defaults to ``False``.
:type require_all: :class:`bool`
:param purge_unknown: See :attr:`~cerberus.Validator.purge_unknown`.
Defaults to to ``False``.
:type purge_unknown: :class:`bool`
:param purge_readonly: Removes all fields that are defined as ``readonly`` in the
normalization phase.
:type purge_readonly: :class:`bool`
:param error_handler: The error handler that formats the result of
:attr:`~cerberus.Validator.errors`.
When given as two-value tuple with an error-handler
class and a dictionary, the latter is passed to the
initialization of the error handler.
Default: :class:`~cerberus.errors.BasicErrorHandler`.
:type error_handler: class or instance based on
:class:`~cerberus.errors.BaseErrorHandler` or
:class:`tuple`
)�nullable)r* �readonly�type�empty�binaryr �boolean� containerr r �dict�float�integer�list�number�set�string) r. r/ r0 r r r1 r2 r3 r4 r5 r6 r7 c s� d| _ t�� | _d| _t�� | _t�� | _d| _ d| _
d| _ | � |�| _
| �||� |�dd�| _|�dd�| _|�dd�| _g | _tt| ��� dS )a4
The arguments will be treated as with this signature:
__init__(self, schema=None, ignore_none_values=False,
allow_unknown=False, require_all=False,
purge_unknown=False, purge_readonly=False,
error_handler=errors.BasicErrorHandler)
Nr F�schema�
allow_unknown� require_all)�documentr � ErrorList�_errors� recent_error�DocumentErrorTree�document_error_tree�SchemaErrorTree�schema_error_tree�
document_path� schema_path�update�"_BareValidator__init_error_handler�
error_handler� _BareValidator__store_config�getr8 r9 r: �_remaining_rules�superr) �__init__)r �args�kwargs�� __class__r r rL � s
zBareValidator.__init__c C sb | � dtj�}t|t�r"|\}}ni }t|t�rFt|tj�rF|f |�S t|tj�rV|S td��d S )NrG zInvalid error_handler.) �popr ZBasicErrorHandler�
isinstance�tupler, �
issubclassZBaseErrorHandlerr )rN rG Z eh_configr r r Z__init_error_handler� s
�
z"BareValidator.__init_error_handlerc C sN d}t |dt|�� �D ]*\}}||kr6td| ��q|| ||< q|| _dS )z.Assign args to kwargs and store configuration.)r8 �ignore_none_valuesr9 r: �
purge_unknown�purge_readonlyNz.__init__ got multiple values for argument '%s')� enumerate�len� TypeError�_config)r rM rN Z signature�i�pr r r Z__store_config� s z BareValidator.__store_configc C s | j �� dS )z'Purge the cache of known valid schemas.N)�_valid_schemas�clear��clsr r r � clear_caches� s zBareValidator.clear_cachesc G s� t |�dkr\| j�|d � | j�� |d D ](}| j�|� | j�|� | j�|� q.�n:t |�dkr�t |d t
�r�| � |d t j
|d � �nt |�dk�r�|d }|d j}|d j}|dd� }| j|f }| j}|t jjkr�|dk r�|||f7 }|�sd} n^| �| �| j�| �}
|dk�r4|
�|d�} n0|dk�r\|
�|| j�} ||
k�rdd}n|
| } | j�|�} t �||||| | |�| _| � | jg� dS ) a
Creates and adds one or multiple errors.
:param args: Accepts different argument's signatures.
*1. Bulk addition of errors:*
- :term:`iterable` of
:class:`~cerberus.errors.ValidationError`-instances
The errors will be added to
:attr:`~cerberus.Validator._errors`.
*2. Custom error:*
- the invalid field's name
- the error message
A custom error containing the message will be created and
added to :attr:`~cerberus.Validator._errors`.
There will however be fewer information contained in the
error (no reference to the violated rule and its
constraint).
*3. Defined error:*
- the invalid field's name
- the error-reference, see :mod:`cerberus.errors`
- arbitrary, supplemental information about the error
A :class:`~cerberus.errors.ValidationError` instance will
be created and added to
:attr:`~cerberus.Validator._errors`.
� r � Nr* F�requiredZ__require_all__)rY r= �extend�sortr@ �addrB rG �emitrR r
�_errorr ZCUSTOM�code�rulerC rD �
UNKNOWN_FIELD�_resolve_rules_set�_resolve_schemar8 rI r: r; ZValidationErrorr> ) r rM �errorr rk rl �inforC rD r � rules_setr r r r rj � sR &
�
�zBareValidator._errorNc K s� | j �� }|�|� | jsRd|d< t|d< | j|d< | j|d< | j|d< | j|d< | j f |�}|dkrp| j
|_
n t |t �s�|f}| j
| |_
|dkr�| j
|_
n t |t �s�|f}| j
| |_
|S ) a@
Creates a new instance of Validator-(sub-)class. All initial parameters of the
parent are passed to the initialization, unless a parameter is given as an
explicit *keyword*-parameter.
:param document_crumb: Extends the
:attr:`~cerberus.Validator.document_path`
of the child-validator.
:type document_crumb: :class:`tuple` or :term:`hashable`
:param schema_crumb: Extends the
:attr:`~cerberus.Validator.schema_path`
of the child-validator.
:type schema_crumb: :class:`tuple` or hashable
:param kwargs: Overriding keyword-arguments for initialization.
:type kwargs: :class:`dict`
:return: an instance of ``self.__class__``
T�is_childrG �root_allow_unknown�root_require_all�
root_document� root_schemaN)r[ r rE rs �toy_error_handlerr9 r: r; r8 rP rC rR rS rD )r �document_crumb� schema_crumbrN Z child_configZchild_validatorr r r �_get_child_validatorE s*
z"BareValidator._get_child_validatorc C s< d� ||�dd��}t| |d �}|d kr8td� ||���|S )Nz_{0}_{1}� �_z/There's no handler for '{}' in the '{}' domain.)�format�replace�getattrr )r Zdomainrl Z
methodname�resultr r r Z__get_rule_handlert s ��z BareValidator.__get_rule_handlerc C s� t | j�}t | j�}|D ]b}t|dd�D ]}t|j|| �|_q(t|dd�D ]}t|j|| �|_qL|jr| �|j||� qdS )a{
Removes nodes by index from an errorpath, relatively to the basepaths of self.
:param errors: A list of :class:`errors.ValidationError` instances.
:param dp_items: A list of integers, pointing at the nodes to drop from
the :attr:`document_path`.
:param sp_items: Alike ``dp_items``, but for :attr:`schema_path`.
T)�reverseN)rY rC rD �sortedr Z child_errors�_drop_nodes_from_errorpaths)r r= Zdp_itemsZsp_itemsZ dp_basedepthZ sp_basedepthrp r\ r r r r� ~ s
� �z)BareValidator._drop_nodes_from_errorpathsc C sn |� d�r.|dd� }|� d�r&| jn| j}n| j}|�d�}|D ] }||krT dS |�|i �}qB|d |fS )a�
Searches for a field as defined by path. This method is used by the
``dependency`` evaluation logic.
:param path: Path elements are separated by a ``.``. A leading ``^``
indicates that the path relates to the document root,
otherwise it relates to the currently evaluated document,
which is possibly a subdocument.
The sequence ``^^`` at the start will be interpreted as a
literal ``^``.
:type path: :class:`str`
:returns: Either the found field name and its value or :obj:`None` for
both.
:rtype: A two-value :class:`tuple`.
�^rc N�.)NN���)�
startswithr; rv �splitrI )r �path�context�parts�partr r r �
_lookup_field� s
zBareValidator._lookup_fieldc C s( t |t�r|S t |t�r$| j�|�S d S �N)rR r r
r rI )r rr r r r rn � s
z BareValidator._resolve_rules_setc C s( t |t�r|S t |t�r$| j�|�S d S r� )rR r r
r rI �r r8 r r r ro � s
z BareValidator._resolve_schemac C s | j �dd�S )a2
If ``True`` unknown fields that are not defined in the schema will be ignored.
If a mapping with a validation schema is given, any undefined field will be
validated against its rules. Also see :ref:`allowing-the-unknown`.
Type: :class:`bool` or any :term:`mapping`
r9 F�r[ rI �r r r r r9 � s zBareValidator.allow_unknownc C s0 | j s"t|ttf�s"t| d|i� || jd< d S )Nr9 )rs rR �boolr r[ �r r r r r r9 � s c C s | j �dd�S )zw
If ``True`` known fields that are defined in the schema will be required.
Type: :class:`bool`
r: Fr� r� r r r r: � s zBareValidator.require_allc C s || j d< d S )Nr: �r[ r� r r r r: � s c C s | � | j�S )z�
The errors of the last processing formatted by the handler that is bound to
:attr:`~cerberus.Validator.error_handler`.
)rG r= r� r r r r � s zBareValidator.errorsc C s | j �dd�S )zm
Whether to not process :obj:`None`-values in a document or not.
Type: :class:`bool`
rU Fr� r� r r r rU � s z BareValidator.ignore_none_valuesc C s || j d< d S )NrU r� r� r r r rU � s c C s | j �dd�S )z�
``True`` for child-validators obtained with
:meth:`~cerberus.Validator._get_child_validator`.
Type: :class:`bool`
rs Fr� r� r r r rs � s zBareValidator.is_childc C s | j �dd�S )z/``True`` if the document is already normalized.�_is_normalizedFr� r� r r r r� � s z BareValidator._is_normalizedc C s || j d< d S )Nr� r� r� r r r r� s c C s | j �dd�S )z�
If ``True``, unknown fields will be deleted from the document unless a
validation is called with disabled normalization. Also see
:ref:`purging-unknown-fields`.
Type: :class:`bool`
rV Fr� r� r r r rV s zBareValidator.purge_unknownc C s || j d< d S )NrV r� r� r r r rV s c C s | j �dd�S )z�
If ``True``, fields declared as readonly will be deleted from the document
unless a validation is called with disabled normalization.
Type: :class:`bool`
rW Fr� r� r r r rW s z BareValidator.purge_readonlyc C s || j d< d S )NrW r� r� r r r rW s c C s | j �d| j�S )z�
The :attr:`~cerberus.Validator.allow_unknown` attribute of the first level
ancestor of a child validator.
rt )r[ rI r9 r� r r r rt s z BareValidator.root_allow_unknownc C s | j �d| j�S )z�
The :attr:`~cerberus.Validator.require_all` attribute of the first level
ancestor of a child validator.
ru )r[ rI r: r� r r r ru ( s z BareValidator.root_require_allc C s | j �d| j�S )z~
The :attr:`~cerberus.Validator.document` attribute of the first level ancestor
of a child validator.
rv )r[ rI r; r� r r r rv 0 s zBareValidator.root_documentc C s | j �dt�S )zj
The registry that holds referenced rules sets.
Type: :class:`~cerberus.Registry`
r )r[ rI r r� r r r r 8 s z BareValidator.rules_set_registryc C s || j d< d S )Nr r� �r �registryr r r r @ s c C s | j �d| j�S )z|
The :attr:`~cerberus.Validator.schema` attribute of the first level ancestor of
a child validator.
rw )r[ rI r8 r� r r r rw D s zBareValidator.root_schemac C s | j S )z�
The validation schema of a validator. When a schema is passed to a method, it
replaces this attribute.
Type: any :term:`mapping` or :obj:`None`
)�_schemar� r r r r8 L s zBareValidator.schemac C s8 |d krd | _ n$| js t|t�r(|| _ n t| |�| _ d S r� )r� rs rR r r� r r r r8 U s
c C s | j �dt�S )zg
The registry that holds referenced schemas.
Type: :class:`~cerberus.Registry`
r )r[ rI r r� r r r r ^ s z BareValidator.schema_registryc C s || j d< d S )Nr r� r� r r r r f s c C s4 t | j�t | j�@ }|r$td| � t| j�| j S )zi
The constraints that can be used for the 'type' rule.
Type: A tuple of strings.
zcThese types are defined both with a method and in the'types_mapping' property of this validator: %s)r6 �
types_mapping�_types_from_methodsr rS )ra Zredundant_typesr r r �typesl s ��zBareValidator.typesc C s� t �� | _d | _t �� | _t �� | _t|�| _ | j
s:d| _ |d k rPt | |�| _
n(| j
d krxt| jt�rni | _n
tt j��|d kr�tt j��t|t�s�tt j�|���| j�| � d S )NF)r r< r= r> r? r@ rA rB r r; rs r� r r8 rR r9 r r� r ZSCHEMA_ERROR_MISSINGr# ZDOCUMENT_MISSINGZDOCUMENT_FORMATr~ rG �start)r r; r8 r r r Z__init_processing} s$
z BareValidator.__init_processingc G s@ |r6|D ]*}z| j �|� W q tk
r0 Y qX qng | _ dS )z�
Drops rules from the queue of the rules that still need to be evaluated for the
currently processed field. If no arguments are given, the whole queue is
emptied.
N)rJ �remove�
ValueError)r �rulesrl r r r �_drop_remaining_rules� s
z#BareValidator._drop_remaining_rulesFc C s@ | � ||� | �| j| j� | j�| � | jr6|s6dS | jS dS )a
Returns the document normalized according to the specified rules of a schema.
:param document: The document to normalize.
:type document: any :term:`mapping`
:param schema: The validation schema. Defaults to :obj:`None`. If not
provided here, the schema must have been provided at
class instantiation.
:type schema: any :term:`mapping`
:param always_return_document: Return the document, even if an error
occurred. Defaults to: ``False``.
:type always_return_document: :class:`bool`
:return: A normalized copy of the provided mapping or :obj:`None` if an
error occurred during normalization.
N)� _BareValidator__init_processing�!_BareValidator__normalize_mappingr; r8 rG �endr= )r r; r8 �always_return_documentr r r �
normalized� s
zBareValidator.normalizedc C s� t |t�r| �|�}|�� }|D ]}| �|| �||< q | �||� | jr\| js\| �||� | j rn| �
||� | � ||� | � ||� | �
||� | �||� d| _|S )NT)rR r
ro r rn �'_BareValidator__normalize_rename_fieldsrV r9 �_normalize_purge_unknownrW �(_BareValidator__normalize_purge_readonly�(_BareValidator__validate_readonly_fields�(_BareValidator__normalize_default_fields�_normalize_coerce�$_BareValidator__normalize_containersr� �r �mappingr8 r r r r Z__normalize_mapping� s
z!BareValidator.__normalize_mappingc
C s� t j}|D ]�}||krRd|| krR| �|| d ||| || �dd�|�||< q
t| jt�r
d| jkr
| �| jd ||| | j�dd�|�||< q
dS )��
{'oneof': [
{'type': 'callable'},
{'type': 'list',
'schema': {'oneof': [{'type': 'callable'},
{'type': 'string'}]}},
{'type': 'string'}
]}
�coercer* FN)r �COERCION_FAILED� _BareValidator__normalize_coercerI rR r9 r )r r� r8 rp r r r r r� � s*
�
�� �z BareValidator._normalize_coercec
C s� t |t�r| �d|�}nLt |t�rd|}|D ]4}| �|||||�}tj| j�| j |f �kr* q`q*|S z
||�W S t
k
r� } z*|r�|d ks�| � ||t |�� | W Y �S d }~X Y nX d S )NZnormalize_coerce)
rR r
� _BareValidator__get_rule_handlerr
r� r r� r@ �fetch_errors_fromrC � Exceptionrj �str) r Z processorr r r* rp r� r] �er r r Z__normalize_coerce� s(
���
z BareValidator.__normalize_coercec C s� |D ]�}t |�|d��}t|| t�r�d|krD| �|||| d � d|krb| �|||| d � |t d�@ szt| jt�r�z| �|||� W q� tk
r� Y q�X qt|| t �r�qqt|| t
�rd|kr�| � |||� qd|kr| � |||� qd S )Nr � keysrules� valuesrules)r9 rV r8 r8 �items)
r6 rI rR r �/_BareValidator__normalize_mapping_per_keysrules�1_BareValidator__normalize_mapping_per_valuesrulesr9 �,_BareValidator__normalize_mapping_per_schemar( r
r �-_BareValidator__normalize_sequence_per_schema�,_BareValidator__normalize_sequence_per_items)r r� r8 r r� r r r Z__normalize_containers s>
�
��
�z$BareValidator.__normalize_containersc s
t � fdd�|| D ��}t dd� || D ��}| j||df|d�}|j|dd�}|jrx| �|jg dd g� | �|j� |D ]�}||| kr�q||| || kr�td
jd �d d� | j |f D ��|d
�� || | || || < q||| | || || < || |= q|d S )Nc 3 s | ]}|� fV qd S r� r ��.0�k��property_rulesr r � <genexpr>+ s zBBareValidator.__normalize_mapping_per_keysrules.<locals>.<genexpr>c s s | ]}||fV qd S r� r r� r r r r� , s r� �ry rz r8 T�r� rd � zHNormalizing keys of {path}: {key} already exists, its value is replaced.r� c s s | ]}t |�V qd S r� )r� �r� �xr r r r� ; s )r� �key)
r1 r{ r� r= r� rj r r~ �joinrC ) r r r� r� r8 r; � validatorr� r� r r� r Z!__normalize_mapping_per_keysrules* s0 � ��z/BareValidator.__normalize_mapping_per_keysrulesc sl t � fdd�|| D ��}| j||df|d�}|j|| dd�||< |jrh| �|jg dg� | �|j� d S )Nc 3 s | ]}|� fV qd S r� r r� �� value_rulesr r r� E s zDBareValidator.__normalize_mapping_per_valuesrules.<locals>.<genexpr>r� r� Tr� rd )r1 r{ r� r= r� rj )r r r� r� r8 r� r r� r Z#__normalize_mapping_per_valuesrulesD s � �
z1BareValidator.__normalize_mapping_per_valuesrulesc
C s� |� |i �}|s"t| jt�r"| j}| j||df|� di �|� d| j�|� d| j�|� d| j�d�}t|| �}|j|| dd�}||�||< |j r�| �
|j � d S )Nr8 r9 rV r: )ry rz r8 r9 rV r: Tr� ) rI rR r9 r r{ rV r: r, r� r= rj )r r r� r8 r� r� �
value_typeZ result_valuer r r Z __normalize_mapping_per_schemaP s
� z,BareValidator.__normalize_mapping_per_schemac s� t � �fdd�tt|� ��D ���t dd� t|� �D ��}| j� � df�d�}t|� �}|j|dd�}||�� �|� < |jr�| � |jg dg� | �
|j� d S ) Nc 3 s | ]}|�� d fV qdS )r8 Nr r� �r r8 r r r� d s z@BareValidator.__normalize_sequence_per_schema.<locals>.<genexpr>c s s | ]\}}||fV qd S r� r �r� r� �vr r r r� f s r8 r� Tr� rd ) r1 �rangerY rX r{ r, r� �valuesr= r� rj )r r r� r8 r; r� r� r� r r� r Z __normalize_sequence_per_schemab s � � z-BareValidator.__normalize_sequence_per_schemac
C s� || d || }}t |�t |�kr*d S tdd� t|�D ��}tdd� t|�D ��}| j||df|d�}t|| �}|j|dd�} || �� �||< |jr�| �|jg dg� | � |j� d S ) Nr� c s s | ]\}}||fV qd S r� r r� r r r r� u s z?BareValidator.__normalize_sequence_per_items.<locals>.<genexpr>c s s | ]\}}||fV qd S r� r r� r r r r� v s r� Tr� rd )
rY r1 rX r{ r, r� r� r= r� rj )
r r r� r8 r� r� r; r� r� r� r r r Z __normalize_sequence_per_itemsq s � z,BareValidator.__normalize_sequence_per_itemsc s& � fdd�| D �D ]}| � |� q| S )Nc s$ g | ] }� � |i �� d d�r|�qS )r+ F�rI r� �r8 r r �
<listcomp>� s z<BareValidator.__normalize_purge_readonly.<locals>.<listcomp>�rQ �r� r8 r r r� r Z__normalize_purge_readonly� s z(BareValidator.__normalize_purge_readonlyc s& � fdd�| D �D ]}| � |� q| S )�{'type': 'boolean'}c s g | ]}|� kr|�qS r r r� r� r r r� � s z:BareValidator._normalize_purge_unknown.<locals>.<listcomp>r� r� r r� r r� � s z&BareValidator._normalize_purge_unknownc C sb t |�D ]T}||kr2| �|||� | �|||� qt| jt�rd| jkr| �||| ji|� q|S )N�rename_handler)rS �_normalize_rename�_normalize_rename_handlerrR r9 r r� r r r Z__normalize_rename_fields� s
�� �z'BareValidator.__normalize_rename_fieldsc C s* d|| kr&|| ||| d < ||= dS )z{'type': 'hashable'}�renameNr r� r r r r� � s z BareValidator._normalize_renamec C sJ d|| krdS | � || d ||dtj�}||krF|| ||< ||= dS )r� r� NF)r� r ZRENAMING_FAILED)r r� r8 r �new_namer r r r� � s
� z'BareValidator._normalize_rename_handlerc s: � ��fdd��D �D ] }�� �| d |� | � qd S )Nc 3 s. | ]&}|� kr�� �| ��d �r|V qdS )r+ N)rn rI r� �r� r8 r r r r� � s �z;BareValidator.__validate_readonly_fields.<locals>.<genexpr>r+ )�_validate_readonlyr� r r� r Z__validate_readonly_fields� s �
z(BareValidator.__validate_readonly_fieldsc
s2 � �fdd��D �}z�fdd�|D �}W n t k
rB t�Y nX |D ]}| �� �|� qHt� }�fdd�|D �}|�r.|�d�}z| �� �|� W nR tk
r� |�|� Y n6 tk
r� } z| � |t
j t |�� W 5 d }~X Y nX t
t|��} | |k�r"|D ]}| � |t
j d� �q�q.qt|�| � qtd S )Nc s4 g | ],}|� ks,� | d kr�| � dd�s|�qS )Nr* Fr� r� �r� r8 r r r� � s
�z<BareValidator.__normalize_default_fields.<locals>.<listcomp>c s g | ]}d � | kr|�qS )�defaultr r� r� r r r� � s c s g | ]}d � | kr|�qS )�default_setterr r� r� r r r� � s r z)Circular dependencies of default setters.)rZ r( �_normalize_defaultr6 rQ �_normalize_default_setter�KeyError�appendr� rj r ZSETTING_DEFAULT_FAILEDr� �hashrS rh )
r r� r8 Z empty_fieldsZfields_with_defaultr Zknown_fields_statesZfields_with_default_setterr� Zfields_processing_stater r� r Z__normalize_default_fields� s> �
�
&
�z(BareValidator.__normalize_default_fieldsc C s || d ||< dS )z{'nullable': True}r� Nr r� r r r r� � s z BareValidator._normalize_defaultc C s> d|| kr:|| d }t |t�r.| �d|�}||�||< dS )zi
{'oneof': [
{'type': 'callable'},
{'type': 'string'}
]}
r� Znormalize_default_setterN)rR r
r� )r r� r8 r �setterr r r r� � s
z'BareValidator._normalize_default_setterTc C s� || _ t� | _| �||� |r.| �| j| j� | jD ]F}| jrN| j| dkrNq4| j�|�}|dk rp| � ||� q4| �
|� q4| j s�| � | j� | j �
| � t| j� S )aO
Normalizes and validates a mapping against a validation-schema of defined rules.
:param document: The document to normalize.
:type document: any :term:`mapping`
:param schema: The validation schema. Defaults to :obj:`None`. If not
provided here, the schema must have been provided at
class instantiation.
:type schema: any :term:`mapping`
:param update: If ``True``, required fields won't be checked.
:type update: :class:`bool`
:param normalize: If ``True``, normalize the document before validation.
:type normalize: :class:`bool`
:return: ``True`` if validation succeeds, otherwise ``False``. Check
the :func:`errors` property for a list of processing errors.
:rtype: :class:`bool`
N)rE r6 �_unrequired_by_excludesr� r� r; r8 rU rI �$_BareValidator__validate_definitions�'_BareValidator__validate_unknown_fields�(_BareValidator__validate_required_fieldsrG r� r� r= )r r; r8 rE � normalizer � definitionsr r r �validate� s
zBareValidator.validatec O s0 |� dd�}| j||� | jr&|s&dS | jS dS )z�
Wrapper around :meth:`~cerberus.Validator.validate` that returns the normalized
and validated document or :obj:`None` if validation failed.
r� FN)rQ r� r= r; )r rM rN r� r r r � validated' s
zBareValidator.validatedc C sr | j r`| j| }t| j ttf�rn| jr*dnd}| j||| j id�}|||idd�sn| �|j� n| �|t j
� d S )Nr9 Z__allow_unknown__)rz r8 F�r� ) r9 r; rR r r
rs r{ rj r= r rm )r r r rz r� r r r Z__validate_unknown_fields3 s
�z'BareValidator.__validate_unknown_fieldsc s� � ���fdd�}�� � �� �j� �� �fdd��jD �����fdd��jD �� ����fdd�� D �� ��_�jr��j�d�}z||�}|r�W q�W qv tk
r� Y q�Y qvX qv��� d S )
z3Validate a field's value against its defined rules.c s �� d| �}|� �| d ����S )Nr� )r� rI )rl r� )r� r r r r r �
validate_ruleE s z;BareValidator.__validate_definitions.<locals>.validate_rulec s" g | ]}|� ks|�j kr|�qS r )�mandatory_validationsr� )r� r r r r� L s
�z8BareValidator.__validate_definitions.<locals>.<listcomp>c 3 s | ]}|� kr|V qd S r� r r� )� rules_queuer r r� Q s z7BareValidator.__validate_definitions.<locals>.<genexpr>c 3 s, | ]$}|� kr|�j kr|d kr|V qdS ))r9 r: �metare N)�normalization_rulesr� )r� r r r r� T s
�r N) rn r; �priority_validationsrf r� rJ rQ r( r� )r r� r r� rl r� r )r� r r� r r r Z__validate_definitionsB s,
��� z$BareValidator.__validate_definitionsz� {'oneof': [{'type': 'boolean'},
{'type': ['dict', 'string'],
'check_with': 'bulk_schema'}]} c s\ t |t�r@t |t�s@t� fdd�|D ��}|rX| �|tj|� n|� krX| �|tj|� dS )z{'type': 'container'}c 3 s | ]}|� kr|V qd S r� r r� ��allowed_valuesr r r� u s z2BareValidator._validate_allowed.<locals>.<genexpr>N)rR r
r
rS rj r ZUNALLOWED_VALUESZUNALLOWED_VALUE)r r� r r Z unallowedr r� r �_validate_allowedr s z BareValidator._validate_allowedc C s� t |t�rRz| �d|�}W n* tk
rD | �d|�}tdt� Y nX |||� n2t |t�rv|D ]}| �|||� q`n|||| j� dS )r� �
check_withr� ziThe 'validator' rule was renamed to 'check_with'. Please update your schema and method names accordingly.N) rR r
r� r r �DeprecationWarningr
�_validate_check_withrj )r Zchecksr r Z
value_checkerr� r r r r | s
�
z"BareValidator._validate_check_withc C sZ t |t�sdS t |t�r"t |t�r.t|f�}nt|�}|t|� }|rV| �|tj|� dS )z{'empty': False }N)rR r
r
r6 rj r ZMISSING_MEMBERS)r Zexpected_valuesr r Zmissing_valuesr r r �_validate_contains� s
� z BareValidator._validate_containsc C sn t |t�st |ttf�s |f}t |t�r6| �||� nt |t�rL| �||� | j�| j |df �dk rjdS dS )zD{'type': ('dict', 'hashable', 'list'), 'check_with': 'dependencies'}� dependenciesNT)
rR r
r
r r �._BareValidator__validate_dependencies_sequence�-_BareValidator__validate_dependencies_mappingr@ Zfetch_node_fromrD )r r r r r r r �_validate_dependencies� s �
���z$BareValidator._validate_dependenciesc C s� d}i }|� � D ]P\}}t|t�r,t|t�r2|g}| �|�\}}||krR|d7 }q|�||i� q|t|�kr~| �|tj |� d S )Nr rc )
r� rR r r
r� rE rY rj r ZDEPENDENCIES_FIELD_VALUE) r r r Z validated_dependencies_counterZ
error_infoZdependency_nameZdependency_valuesZ wanted_fieldZwanted_field_valuer r r Z __validate_dependencies_mapping� s �
z-BareValidator.__validate_dependencies_mappingc C s0 |D ]&}| � |�d d kr| �|tj|� qd S )Nr )r� rj r ZDEPENDENCIES_FIELD)r r r Z
dependencyr r r Z __validate_dependencies_sequence� s z.BareValidator.__validate_dependencies_sequencec C sB t |t�r>t|�dkr>| �ddddddd� |s>| �|tj� d S )
r� r �allowed� forbiddenr� � minlength� maxlength�regexr� N)rR r rY r� rj r ZEMPTY_NOT_ALLOWED)r r- r r r r r �_validate_empty� s � z BareValidator._validate_emptyc s� t |t�r|g}� j| �d� j�r0� j�|� |D ].}|� jkr4� j| �d� j�r4� j�|� q4t� fdd�|D ��r�d�dd� |D ��}� � |t
j |� dS )z>{'type': ('hashable', 'list'), 'schema': {'type': 'hashable'}}re c 3 s | ]}|� j kV qd S r� �r; )r� �excluded_fieldr� r r r� � s z3BareValidator._validate_excludes.<locals>.<genexpr>z, c s s | ]}d � |�V qdS )z'{0}'N)r~ �r� r r r r r� � s N) rR r r8 rI r: r� rh �anyr� rj r ZEXCLUDES_FIELD)r Zexcluded_fieldsr r r Z
exclusion_strr r� r �_validate_excludes� s
�
�z BareValidator._validate_excludesc C sZ t |t�r>t |t�s>t|�t|�@ }|rV| �|tjt|�� n||krV| �|tj|� dS )z{'type': 'list'}N) rR r r
r6 rj r ZFORBIDDEN_VALUESr4 ZFORBIDDEN_VALUE)r Zforbidden_valuesr r r r r r �_validate_forbidden� s z!BareValidator._validate_forbiddenc C s� t |�t |�kr,| �|tjt |�t |�� n^tdd� t|�D ��}| j||df|d�}|tdd� t|�D ��| jdd�s�| �|tj|j � dS ) z'{'type': 'list', 'check_with': 'items'}c s s | ]\}}||fV qd S r� r )r� r\ �
definitionr r r r� s z0BareValidator._validate_items.<locals>.<genexpr>r� r� c s s | ]\}}||fV qd S r� r )r� r\ r r r r r� s F�rE r� N)
rY rj r Z ITEMS_LENGTHr1 rX r{ rE Z BAD_ITEMSr= )r r� r r� r8 r� r r r �_validate_items s ���z BareValidator._validate_itemsc C s� d}t �� }t|�D ]�\}}||�� i} dD ]4}
|
| | kr,|
| j| kr,| j| |
| | |
< q,d| | kr|| j| | d< | j|||f| dd�} | | j| jdd�r�|d7 }q| � | j
g d g� |� | j
� q||fS )
zl
Validates value against all definitions and logs errors according to the
operator.
r )r9 r, r9 T)rz r8 r9 Fr rc � ) r r< rX r r8 r9 r{ r; rE r� r= rf ) r �operatorr� r r Z
valid_counterr= r\ r r8 rl r� r r r Z__validate_logical s& �
z BareValidator.__validate_logicalc C s8 | � d|||�\}}|dk r4| �|tj||t|�� dS )z${'type': 'list', 'logical': 'anyof'}Zanyofrc N)� _BareValidator__validate_logicalrj r ZANYOFrY �r r� r r Zvalidsr= r r r �_validate_anyof2 s z BareValidator._validate_anyofc C s< | � d|||�\}}|t|�k r8| �|tj||t|�� dS )z${'type': 'list', 'logical': 'allof'}ZallofN)r rY rj r ZALLOFr r r r �_validate_allof8 s z BareValidator._validate_allofc C s8 | � d|||�\}}|dkr4| �|tj||t|�� dS )z%{'type': 'list', 'logical': 'noneof'}Znoneofr N)r rj r ZNONEOFrY r r r r �_validate_noneof> s z BareValidator._validate_noneofc C s8 | � d|||�\}}|dkr4| �|tj||t|�� dS )z${'type': 'list', 'logical': 'oneof'}�oneofrc N)r rj r ZONEOFrY r r r r �_validate_oneofD s z BareValidator._validate_oneofc C s4 z||kr| � |tj� W n tk
r. Y nX dS �z{'nullable': False }N)rj r Z MAX_VALUErZ )r Z max_valuer r r r r �
_validate_maxJ s
zBareValidator._validate_maxc C s4 z||k r| � |tj� W n tk
r. Y nX dS r )rj r Z MIN_VALUErZ )r Z min_valuer r r r r �
_validate_minR s
zBareValidator._validate_minc C s. t |t�r*t|�|kr*| �|tjt|�� dS �z{'type': 'integer'}N)rR r
rY rj r Z
MAX_LENGTH)r Z
max_lengthr r r r r �_validate_maxlengthZ s z!BareValidator._validate_maxlength� c C s. t |t�r*t|�|k r*| �|tjt|�� dS r" )rR r
rY rj r Z
MIN_LENGTH)r Z
min_lengthr r r r r �_validate_minlengtha s z!BareValidator._validate_minlengthc C s@ |dkr<|s| � |tj� | �dddddddd d
d d d
d�
dS )r� Nr r- r r� r� �min�maxr r
r r8 r, r� )rj r Z NOT_NULLABLEr� )r r* r r r r r �_validate_nullablef s$ �z BareValidator._validate_nullablec s| t |t�rx| j||dft� fdd�|�� D ��d�}|tdd� |�� D ��dd�sx| �|jg dd g� | �|tj |j� d
S ) ��
{'type': ['dict', 'string'],
'check_with': 'bulk_schema',
'forbidden': ['rename', 'rename_handler']}
r� c 3 s | ]}|� fV qd S r� r r� r� r r r� � s z4BareValidator._validate_keysrules.<locals>.<genexpr>r� c s s | ]}||fV qd S r� r r� r r r r� � s Fr� rd r� N)
rR r r{ r1 �keysr� r= rj r Z KEYSRULES)r r8 r r r� r r� r �_validate_keysrules{ s
� z!BareValidator._validate_keysrulesc C sH |rD| j s| �|tj� tj| j�| j|f �k}| j rD|rD| �� dS )r� N)r� rj r ZREADONLY_FIELDr@ r� rC r� )r r+ r r Z has_errorr r r r� � s
���
z BareValidator._validate_readonlyc C sF t |t�sdS |�d�s |d7 }t�|�}|�|�sB| �|tj� dS )z{'type': 'string'}N�$) rR r
�endswith�re�compile�matchrj r ZREGEX_MISMATCH)r �patternr r Zre_objr r r �_validate_regex� s
z BareValidator._validate_regexz {'type': 'boolean'} c s� z t �fdd��j�� D ��}W n0 tk
rP �jrJ�jd dkrJt�n� Y nX |�j8 }|t � �fdd�� D �� }|D ]}��|t j
� q|�jr�t � fdd�� D ��}�j� |�rֈj| D ]}��|t j
� q�dS )zy
Validates that required fields are not missing.
:param document: The document being validated.
c 3 s. | ]&\}}� � |��d � j�dkr|V qdS )re TN)rn rI r: )r� r r r� r r r� � s
��z;BareValidator.__validate_required_fields.<locals>.<genexpr>r� r8 c 3 s& | ] }� � |�d k s�js|V qd S r� )rI rU r �r; r r r r� � s �c 3 s | ]}� � |�d k r|V qd S r� r� r r
r r r� � s N) r6 r8 r� �AttributeErrorrs rD r( r� rj r ZREQUIRED_FIELD�
isdisjoint)r r; re Zmissingr Zfieldsr r3 r Z__validate_required_fields� s& �
�
z(BareValidator.__validate_required_fieldsc C sL |dkr dS t |t�r0t |t�s0| �|||� nt |t�rH| �|||� dS )z�
{'type': ['dict', 'string'],
'anyof': [{'check_with': 'schema'},
{'check_with': 'bulk_schema'}]}
N)rR r r
�(_BareValidator__validate_schema_sequencer �'_BareValidator__validate_schema_mapping)r r8 r r r r r �_validate_schema� s
z BareValidator._validate_schemac C s� | � |�}| j| �d| j�}| j| �d| j�}| j||df|||d�}z&||| jdd�sn| �|tj |j
� W n$ t k
r� | �|tj � � Y nX d S )Nr9 r: r8 )ry rz r8 r9 r: Fr )
ro r8 rI r9 r: r{ rE rj r ZMAPPING_SCHEMAr= r( ZBAD_TYPE_FOR_SCHEMA)r r r8 r r9 r: r� r r r Z__validate_schema_mapping� s
�z'BareValidator.__validate_schema_mappingc s� t � fdd�tt|��D ��� | j||df� | jd�}|t dd� t|�D ��| jdd� |jr�| �|jg dg� | � |t
j |j� d S ) Nc 3 s | ]}|� fV qd S r� r )r� r\ r� r r r� � s z;BareValidator.__validate_schema_sequence.<locals>.<genexpr>r8 )ry rz r8 r9 c s s | ]\}}||fV qd S r� r )r� r\ r� r r r r� � s Fr rd ) r1 r� rY r{ r9 rX rE r= r� rj r ZSEQUENCE_SCHEMA)r r r8 r r� r r� r Z__validate_schema_sequence� s ��z(BareValidator.__validate_schema_sequencec C s� |sdS t |t�r|fn|}|D ]R}| j�|�}|dk rTt ||j�oPt ||j� }n| �d|�}||�}|r dS q | �|tj � | �
� dS )zM
{'type': ['string', 'list'],
'check_with': 'type'}
NZ
validate_type) rR r
r� rI Zincluded_typesZexcluded_typesr� rj r ZBAD_TYPEr� ) r Z data_typer r r� Z_typeZtype_definitionZmatchedZ type_handlerr r r �_validate_type s$ � � z BareValidator._validate_typec sr |df}t |t�rn| j||t� fdd�|D ��d�}||| jdd� |jrn| �|jg dg� | �|tj |j� dS ) r) r� c 3 s | ]}|� fV qd S r� r r� r� r r r� - s z6BareValidator._validate_valuesrules.<locals>.<genexpr>r� Fr rd N)
rR r r{ r1 rE r= r� rj r Z VALUESRULES)r r8 r r rz r� r r� r �_validate_valuesrules" s
�z#BareValidator._validate_valuesrules)NN)N)NF)NFT)rr% r& r' r r� r� r �bytes� bytearrayr� r r
r r r r2 r r r6 r� r^ rL � staticmethodrF rH � classmethodrb rj r{ r� r� r� rn ro �propertyr9 r� r: r rU rs r� rV rW rt ru rv r rw r8 r r r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� �__call__r� r� r� r" Z_validate_allow_unknownr� r r r r r r r r r r r r r r r r! r# �_validate_metar% r( r+ r� r2 Z_validate_requiredZ_validate_require_allr� r8 r7 r6 r9 r: �
__classcell__r r rO r r) E s / � 3
Q
/
!
+
* *�
$"r) z7The rule's arguments are validated against this schema:c s4 e Zd ZdZ� fdd�Z� fdd�Zdd� Z� ZS )�InspectedValidatorz Metaclass for all validatorsc s> d|d kr(|d � d|d d ji� tt| �j| f|�� S )Nr rd rc r )rE r rK rC �__new__)ra rM rO r r rD ; s zInspectedValidator.__new__c s � fdd�}t t� �j|� di � _� _|d�D ]@}|�d�r^� j|td�d � f7 _q2� �d| �� j|< q2� jr�tdt � t
dd � |d
�D ��t
dd � |d �D �� � _ � jd
d }� j |d
d d d
d< |d d< dd � � j D �D ]}d� j| d< q�ddi � _
� _� _|d�D ]n}|�d��rV� j
|td�d � f7 _
n>|�d��r�� j|td�d � f7 _n� �d| �� j|< �q(dD ]:}� j| d }� j
|d
d d d
d< |d d< �q�� j� jd d d
d< i � _� j�� j� � j�� j� d S )Nc s t � fdd�t��D ��S )Nc 3 s4 | ],}|� d � d �r|t� �d d� V qdS )r} rd N)r� rY r� ��prefixr r r� B s �zNInspectedValidator.__init__.<locals>.attributes_with_prefix.<locals>.<genexpr>)rS �dirrE r` rE r �attributes_with_prefixA s �z;InspectedValidator.__init__.<locals>.attributes_with_prefixr r� Ztype_Z
_validate_z}Methods for type testing are deprecated, use TypeDefinition and the 'types_mapping'-property of a Validator-instance instead.c s s | ]
}|V qd S r� r r� r r r r� ^ s z.InspectedValidator.__init__.<locals>.<genexpr>r� r� r rc r8 r rd c s s | ]}|d kr|V qdS )r* Nr r� r r r r� d s Tre r� Zcoerce_Zdefault_setter_Z _normalize_)r� r� r� )rK rC rL r� Zvalidation_rulesr� rY �$_InspectedValidator__get_rule_schemar r rS Zcheckersr� ZcoercersZdefault_settersr� r� rE )ra rM rH Z attributer� rl rO r` r rL @ sP
� � � & �*��zInspectedValidator.__init__c C s� t | |�j}|d kri }n@t|kr0|�t�d }zt|�� �}W n tk
rX i }Y nX |s~|dkr~td|�dd�d � |S )Nrc rA z>No validation schema is defined for the arguments of rule '%s'r} rd r� )r� r �RULE_SCHEMA_SEPARATORr� r �stripr� r )ra Z method_nameZ docstringr� r r r Z__get_rule_schema} s
��z$InspectedValidator.__get_rule_schema)r% r& r' r rD rL rI rB r r rO r rC 8 s =rC � Validator)+r Z
__future__r Zastr r r r r. �warningsr Zcerberusr Zcerberus.platformr r
r r r
r r r Zcerberus.schemar r r r Zcerberus.utilsr r r ZToyErrorHandlerrx r" r� r# r( �objectr) rJ r, rC rL r r r r �<module> s:
(
{Z