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)datedatetimeN)warn)errors)
_int_types _str_type ContainerHashableIterableMappingSequenceSized)schema_registryrules_set_registryDefinitionSchema SchemaError)drop_item_from_tuplereadonly_classpropertyTypeDefinitionc C s dd }|}| |_ |S )Nc S s t dd S )NzcDummy method called. Its purpose is to hold justvalidation constraints for a rule in its docstring.) RuntimeError)self
constraintfieldvalue r C/opt/alt/python38/lib/python3.8/site-packages/cerberus/validator.pydummy* 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 ZdZdZdZedeefdede fdede
fe fede fded e
fded
efded eefded efded
efe fedeefe fedefdede fdd Ze Z fddZedd Zdd Zedd Zdd Zdd 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 Z4ddRdSZ5dTdU Z6ddWdXZ7dYdZ 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| ZIdd~dZJeJZKdd ZLdd ZMdd ZNeOdZPdd ZQdd ZRdd ZSdd ZTdd ZUdd ZVdd ZWdd ZXdd ZYdd ZZdd Z[dd Z\dd Z]dd Z^dd Z_dd Z`dd Zadd ZbeOdZcdd Zddd Zedd Zfdd Zgdd ZheOdZieOdZjdd Zkdd Zldd Zmdd Zndd Zodd 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* readonlytypeemptybinaryr boolean containerr r dictfloatintegerlistnumbersetstring) 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 Fschema
allow_unknown require_all)documentr ErrorList_errors recent_errorDocumentErrorTreedocument_error_treeSchemaErrorTreeschema_error_tree
document_path schema_pathupdate"_BareValidator__init_error_handler
error_handler _BareValidator__store_configgetr8 r9 r: _remaining_rulessuperr) __init__)r argskwargs __class__r r rL s
zBareValidator.__init__c C sb | dtj}t|tr"|\}}ni }t|trFt|tjrF|f |S t|tjrV|S tdd S )NrG zInvalid error_handler.) popr ZBasicErrorHandler
isinstancetupler,
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_unknownpurge_readonlyNz.__init__ got multiple values for argument '%s') enumeratelen TypeError_config)r rM rN Z signatureipr r r Z__store_config s z BareValidator.__store_configc C s | j dS )z'Purge the cache of known valid schemas.N)_valid_schemasclearclsr r r clear_caches s zBareValidator.clear_cachesc G s t |dkr\| j|d | j |d D ](}| j| | j| | j| q.n:t |dkrt |d t
r| |d t j
|d nt |dkr|d }|d j}|d j}|dd }| j|f }| j}|t jjkr|dk r|||f7 }|sd} n^| | | j| }
|dkr4|
|d} n0|dkr\|
|| j} ||
krdd}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* FrequiredZ__require_all__)rY r= extendsortr@ addrB rG emitrR r
_errorr ZCUSTOMcoderulerC 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__``
Tis_childrG root_allow_unknownroot_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.)formatreplacegetattrr )r Zdomainrl Z
methodnameresultr r r Z__get_rule_handlert s z BareValidator.__get_rule_handlerc C s t | j}t | j}|D ]b}t|ddD ]}t|j|| |_q(t|ddD ]}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 | dr.|dd }| dr&| 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 pathcontextpartspartr r r
_lookup_field s
zBareValidator._lookup_fieldc C s( t |tr|S t |tr$| 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 |tr|S t |tr$| j|S d S r )rR r r
r rI r r8 r r r ro s
z BareValidator._resolve_schemac C s | j ddS )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 Fr[ rI r r r r r9 s zBareValidator.allow_unknownc C s0 | j s"t|ttfs"t| d|i || jd< d S )Nr9 )rs rR boolr r[ r r r r r r9 s c C s | j ddS )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 | | jS )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 ddS )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 ddS )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 ddS )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 ddS )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 ddS )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| jS )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| jS )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| jS )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 dtS )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| jS )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|tr(|| _ n t| || _ d S r )r rs rR r r r r r r8 U s
c C s | j dtS )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 | jt | 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| jtrni | _n
tt j|d krtt jt|tstt 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 |tr| |}| }|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| jtr
d| jkr
| | jd ||| | jdd|||< 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 |tr| d|}nLt |trd|}|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|| trd|krD| |||| d d|krb| |||| d |t d@ szt| jtrz| ||| W q tk
r Y qX qt|| t rqqt|| t
rd|kr| ||| qd|kr| ||| qd S )Nr keysrules valuesrules)r9 rV r8 r8 items)
r6 rI rR r /_BareValidator__normalize_mapping_per_keysrules1_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 ]}||| krq||| || krtd
jd d d | j |f D |d
|| | || || < q||| | || || < || |= q|d S )Nc 3 s | ]}| fV qd S r r .0kproperty_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 Tr 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| jtr"| j}| j||df| di | d| j| d| j| d| jd}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 fddtt| D t dd t| D }| j dfd}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 dr|qS )r+ FrI 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| jtrd| jkr| ||| ji| q|S )Nrename_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: fddD 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 fddD }zfdd|D }W n t k
rB tY 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|} | |kr"|D ]}| |t
j d qq.qt|| qtd S )Nc s4 g | ],}| ks, | d kr| dds|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_setterKeyErrorappendr 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 |tr.| 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 ttfrn| jr*dnd}| j||| j id}|||iddsn| |j n| |t j
d S )Nr9 Z__allow_unknown__)rz r8 Fr ) 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 fddjD fddjD fdd D _jrjd}z||}|rW qW qv tk
r Y qY 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 |tr@t |ts@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 |trRz| d|}W n* tk
rD | d|}tdt Y nX ||| n2t |trv|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 |tsdS t |tr"t |tr.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 |tst |ttfs |f}t |tr6| || nt |trL| || | 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|tr,t|tr2|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 |tr>t|dkr>| ddddddd |s>| |tj d S )
r r allowed forbiddenr minlength maxlengthregexr 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 |tr|g} j| d jr0 j| |D ].}| jkr4 j| d jr4 j| q4t fdd|D rddd |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 |tr>t |ts>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 | jdds| |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 FrE 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| jddr|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 |tr*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 |tr*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 minmaxr 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 |trx| j||dft fdd| D d}|tdd | D ddsx| |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 |tsdS |ds |d7 }t|}||sB| |tj dS )z{'type': 'string'}N$) rR r
endswithrecompilematchrj r ZREGEX_MISMATCH)r patternr r Zre_objr r r _validate_regex s
z BareValidator._validate_regexz {'type': 'boolean'} c s z t fddj D }W n0 tk
rP jrJjd dkrJtn Y nX |j8 }|t fdd D }|D ]}|t j
q|jrt fdd D }j |rֈj| D ]}|t j
qdS )zy
Validates that required fields are not missing.
:param document: The document being validated.
c 3 s. | ]&\}} |d jdkr|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 sjs|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 |tr0t |ts0| ||| nt |trH| ||| 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&||| jddsn| |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 fddtt|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 |tr|fn|}|D ]R}| j|}|dk rTt ||joPt ||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 |trn| 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 fddZ fddZdd 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 _ _|dD ]@}|dr^ j|tdd f7 _q2 d| j|< q2 jrtdt 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< qddi _
_ _|dD ]n}|drV j
|tdd f7 _
n>|dr j|tdd 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 fddtD 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|td }zt| }W n tk
rX i }Y nX |s~|dkr~td|ddd |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