# -*- coding: utf-8 -*-
import re
import sys
from datetime import datetime, date
from random import choice
from string import ascii_lowercase
from pytest import mark
from cerberus import errors, Validator
from cerberus.tests import \
(assert_bad_type, assert_fail, assert_has_error, assert_not_has_error,
assert_success, assert_document_error)
def test_empty_document():
assert_document_error(None, None, None,
errors.DOCUMENT_MISSING)
def test_bad_document_type():
document = "not a dict"
assert_document_error(
document, None, None, errors.DOCUMENT_FORMAT.format(
document)
)
def test_unknown_field(validator):
field = 'surname'
assert_fail({field: 'doe'}, validator=validator,
error=(field, (), errors.UNKNOWN_FIELD, None))
assert validator.errors == {field: ['unknown field']}
def test_empty_field_definition(document):
field = 'name'
schema = {field: {}}
assert_success(document, schema)
def test_required_field(schema):
field = 'a_required_string'
required_string_extension = {
'a_required_string': {'type': 'string',
'minlength': 2,
'maxlength': 10,
'required': True}}
schema.update(required_string_extension)
assert_fail({'an_integer': 1}, schema,
error=(field, (field, 'required'), errors.REQUIRED_FIELD,
True))
def test_nullable_field():
assert_success({'a_nullable_integer': None})
assert_success({'a_nullable_integer': 3})
assert_success({'a_nullable_field_without_type': None})
assert_fail({'a_nullable_integer': "foo"})
assert_fail({'an_integer': None})
assert_fail({'a_not_nullable_field_without_type': None})
def test_readonly_field():
field = 'a_readonly_string'
assert_fail({field: 'update me if you can'},
error=(field, (field, 'readonly'), errors.READONLY_FIELD, True))
def test_readonly_field_first_rule():
# test that readonly rule is checked before any other rule, and blocks.
# See #63.
schema = {
'a_readonly_number': {
'type': 'integer',
'readonly': True,
'max': 1
}
}
v = Validator(schema)
v.validate({'a_readonly_number': 2})
# it would be a list if there's more than one error; we get a dict
# instead.
assert 'read-only' in v.errors['a_readonly_number'][0]
def test_readonly_field_with_default_value():
schema = {
'created': {
'type': 'string',
'readonly': True,
'default': 'today'
},
'modified': {
'type': 'string',
'readonly': True,
'default_setter': lambda d: d['created']
}
}
assert_success({}, schema)
expected_errors = [('created', ('created', 'readonly'),
errors.READONLY_FIELD,
schema['created']['readonly']),
('modified', ('modified', 'readonly'),
errors.READONLY_FIELD,
schema['modified']['readonly'])]
assert_fail({'created': 'tomorrow', 'modified': 'today'},
schema, errors=expected_errors)
assert_fail({'created': 'today', 'modified': 'today'},
schema, errors=expected_errors)
def test_nested_readonly_field_with_default_value():
schema = {
'some_field': {
'type': 'dict',
'schema': {
'created': {
'type': 'string',
'readonly': True,
'default': 'today'
},
'modified': {
'type': 'string',
'readonly': True,
'default_setter': lambda d: d['created']
}
}
}
}
assert_success({'some_field': {}}, schema)
expected_errors = [
(('some_field', 'created'),
('some_field', 'schema', 'created', 'readonly'),
errors.READONLY_FIELD,
schema['some_field']['schema']['created']['readonly']),
(('some_field', 'modified'),
('some_field', 'schema', 'modified', 'readonly'),
errors.READONLY_FIELD,
schema['some_field']['schema']['modified']['readonly'])]
assert_fail({'some_field': {'created': 'tomorrow', 'modified': 'now'}},
schema, errors=expected_errors)
assert_fail({'some_field': {'created': 'today', 'modified': 'today'}},
schema, errors=expected_errors)
def test_not_a_string():
assert_bad_type('a_string', 'string', 1)
def test_not_a_binary():
# 'u' literal prefix produces type `str` in Python 3
assert_bad_type('a_binary', 'binary', u"i'm not a binary")
def test_not_a_integer():
assert_bad_type('an_integer', 'integer', "i'm not an integer")
def test_not_a_boolean():
assert_bad_type('a_boolean', 'boolean', "i'm not a boolean")
def test_not_a_datetime():
assert_bad_type('a_datetime', 'datetime', "i'm not a datetime")
def test_not_a_float():
assert_bad_type('a_float', 'float', "i'm not a float")
def test_not_a_number():
assert_bad_type('a_number', 'number', "i'm not a number")
def test_not_a_list():
assert_bad_type('a_list_of_values', 'list', "i'm not a list")
def test_not_a_dict():
assert_bad_type('a_dict', 'dict', "i'm not a dict")
def test_bad_max_length(schema):
field = 'a_string'
max_length = schema[field]['maxlength']
value = "".join(choice(ascii_lowercase) for i in range(max_length + 1))
assert_fail({field: value},
error=(field, (field, 'maxlength'), errors.MAX_LENGTH,
max_length, (len(value),)))
def test_bad_max_length_binary(schema):
field = 'a_binary'
max_length = schema[field]['maxlength']
value = b'\x00' * (max_length + 1)
assert_fail({field: value},
error=(field, (field, 'maxlength'), errors.MAX_LENGTH,
max_length, (len(value),)))
def test_bad_min_length(schema):
field = 'a_string'
min_length = schema[field]['minlength']
value = "".join(choice(ascii_lowercase) for i in range(min_length - 1))
assert_fail({field: value},
error=(field, (field, 'minlength'), errors.MIN_LENGTH,
min_length, (len(value),)))
def test_bad_min_length_binary(schema):
field = 'a_binary'
min_length = schema[field]['minlength']
value = b'\x00' * (min_length - 1)
assert_fail({field: value},
error=(field, (field, 'minlength'), errors.MIN_LENGTH,
min_length, (len(value),)))
def test_bad_max_value(schema):
def assert_bad_max_value(field, inc):
max_value = schema[field]['max']
value = max_value + inc
assert_fail({field: value},
error=(field, (field, 'max'), errors.MAX_VALUE, max_value))
field = 'an_integer'
assert_bad_max_value(field, 1)
field = 'a_float'
assert_bad_max_value(field, 1.0)
field = 'a_number'
assert_bad_max_value(field, 1)
def test_bad_min_value(schema):
def assert_bad_min_value(field, inc):
min_value = schema[field]['min']
value = min_value - inc
assert_fail({field: value},
error=(field, (field, 'min'),
errors.MIN_VALUE, min_value))
field = 'an_integer'
assert_bad_min_value(field, 1)
field = 'a_float'
assert_bad_min_value(field, 1.0)
field = 'a_number'
assert_bad_min_value(field, 1)
def test_bad_schema(validator):
field = 'a_dict'
schema_field = 'address'
value = {schema_field: 34}
assert_fail(
{field: value}, validator=validator,
errors=[
((field, schema_field), (field, 'schema', schema_field, 'type'),
errors.BAD_TYPE, 'string'),
((field, 'city'), (field, 'schema', 'city', 'required'),
errors.REQUIRED_FIELD, True)
])
handler = errors.BasicErrorHandler
assert field in validator.errors
assert schema_field in validator.errors[field][-1]
assert handler.messages[errors.BAD_TYPE.code].format(constraint='string') \
in validator.errors[field][-1][schema_field]
assert 'city' in validator.errors[field][-1]
assert (handler.messages[errors.REQUIRED_FIELD.code]
in validator.errors[field][-1]['city'])
def test_bad_valueschema():
field = 'a_dict_with_valueschema'
schema_field = 'a_string'
value = {schema_field: 'not an integer'}
exp_child_errors = [
((field, schema_field), (field, 'valueschema', 'type'), errors.BAD_TYPE,
'integer')]
assert_fail({field: value},
error=(field, (field, 'valueschema'), errors.VALUESCHEMA,
{'type': 'integer'}), child_errors=exp_child_errors)
def test_bad_list_of_values(validator):
field = 'a_list_of_values'
value = ['a string', 'not an integer']
assert_fail({field: value}, validator=validator,
error=(field, (field, 'items'), errors.BAD_ITEMS,
[{'type': 'string'}, {'type': 'integer'}]),
child_errors=[((field, 1), (field, 'items', 1, 'type'),
errors.BAD_TYPE, 'integer')])
assert (errors.BasicErrorHandler.messages[errors.BAD_TYPE.code].
format(constraint='integer')
in validator.errors[field][-1][1])
value = ['a string', 10, 'an extra item']
assert_fail({field: value},
error=(field, (field, 'items'), errors.ITEMS_LENGTH,
[{'type': 'string'}, {'type': 'integer'}], (2, 3)))
def test_bad_list_of_integers():
field = 'a_list_of_integers'
value = [34, 'not an integer']
assert_fail({field: value})
def test_bad_list_of_dicts(schema, validator):
field = 'a_list_of_dicts'
subschema = schema['a_list_of_dicts']['schema']
value = [{'sku': 'KT123', 'price': '100'}]
exp_child_errors = [((field, 0, 'price'),
(field, 'schema', 'schema', 'price', 'type'),
errors.BAD_TYPE, 'integer')]
assert_fail({field: value}, validator=validator,
error=(field, (field, 'schema'), errors.SEQUENCE_SCHEMA,
subschema),
child_errors=exp_child_errors)
assert field in validator.errors
assert 0 in validator.errors[field][-1]
assert 'price' in validator.errors[field][-1][0][-1]
exp_msg = errors.BasicErrorHandler.messages[errors.BAD_TYPE.code] \
.format(constraint='integer')
assert exp_msg in validator.errors[field][-1][0][-1]['price']
value = ["not a dict"]
exp_child_errors = [((field, 0), (field, 'schema', 'type'),
errors.BAD_TYPE, 'dict', ())]
assert_fail({field: value},
error=(field, (field, 'schema'), errors.SEQUENCE_SCHEMA,
subschema),
child_errors=exp_child_errors)
def test_array_unallowed():
field = 'an_array'
value = ['agent', 'client', 'profit']
assert_fail({field: value},
error=(field, (field, 'allowed'), errors.UNALLOWED_VALUES,
['agent', 'client', 'vendor'], ['profit']))
def test_string_unallowed():
field = 'a_restricted_string'
value = 'profit'
assert_fail({field: value},
error=(field, (field, 'allowed'), errors.UNALLOWED_VALUE,
['agent', 'client', 'vendor'], value))
def test_integer_unallowed():
field = 'a_restricted_integer'
value = 2
assert_fail({field: value},
error=(field, (field, 'allowed'), errors.UNALLOWED_VALUE,
[-1, 0, 1], value))
def test_integer_allowed():
assert_success({'a_restricted_integer': -1})
def test_validate_update():
assert_success({'an_integer': 100,
'a_dict': {'address': 'adr'},
'a_list_of_dicts': [{'sku': 'let'}]
}, update=True)
def test_string():
assert_success({'a_string': 'john doe'})
def test_string_allowed():
assert_success({'a_restricted_string': 'client'})
def test_integer():
assert_success({'an_integer': 50})
def test_boolean():
assert_success({'a_boolean': True})
def test_datetime():
assert_success({'a_datetime': datetime.now()})
def test_float():
assert_success({'a_float': 3.5})
assert_success({'a_float': 1})
def test_number():
assert_success({'a_number': 3.5})
assert_success({'a_number': 3})
def test_array():
assert_success({'an_array': ['agent', 'client']})
def test_set():
assert_success({'a_set': set(['hello', 1])})
def test_one_of_two_types(validator):
field = 'one_or_more_strings'
assert_success({field: 'foo'})
assert_success({field: ['foo', 'bar']})
exp_child_errors = [((field, 1), (field, 'schema', 'type'),
errors.BAD_TYPE, 'string')]
assert_fail({field: ['foo', 23]}, validator=validator,
error=(field, (field, 'schema'), errors.SEQUENCE_SCHEMA,
{'type': 'string'}),
child_errors=exp_child_errors)
assert_fail({field: 23},
error=((field,), (field, 'type'), errors.BAD_TYPE,
['string', 'list']))
assert validator.errors == {field: [{1: ['must be of string type']}]}
def test_regex(validator):
field = 'a_regex_email'
assert_success({field: 'valid.email@gmail.com'}, validator=validator)
assert_fail({field: 'invalid'}, update=True,
error=(field, (field, 'regex'), errors.REGEX_MISMATCH,
'^[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+$'))
def test_a_list_of_dicts():
assert_success(
{
'a_list_of_dicts': [
{'sku': 'AK345', 'price': 100},
{'sku': 'YZ069', 'price': 25}
]
}
)
def test_a_list_of_values():
assert_success({'a_list_of_values': ['hello', 100]})
def test_a_list_of_integers():
assert_success({'a_list_of_integers': [99, 100]})
def test_a_dict():
assert_success({'a_dict': {'address': 'i live here',
'city': 'in my own town'}})
assert_fail({'a_dict': {'address': 8545}}, errors=[
(('a_dict', 'address'), ('a_dict', 'schema', 'address', 'type'),
errors.BAD_TYPE, 'string'),
(('a_dict', 'city'), ('a_dict', 'schema', 'city', 'required'),
errors.REQUIRED_FIELD, True)
])
def test_a_dict_with_valueschema(validator):
assert_success({'a_dict_with_valueschema':
{'an integer': 99, 'another integer': 100}})
error = (
'a_dict_with_valueschema', ('a_dict_with_valueschema', 'valueschema'),
errors.VALUESCHEMA, {'type': 'integer'})
child_errors = [
(('a_dict_with_valueschema', 'a string'),
('a_dict_with_valueschema', 'valueschema', 'type'),
errors.BAD_TYPE, 'integer')]
assert_fail({'a_dict_with_valueschema': {'a string': '99'}},
validator=validator, error=error, child_errors=child_errors)
assert 'valueschema' in \
validator.schema_error_tree['a_dict_with_valueschema']
v = validator.schema_error_tree
assert len(v['a_dict_with_valueschema']['valueschema'].descendants) == 1
def test_a_dict_with_keyschema():
assert_success({'a_dict_with_keyschema': {'key': 'value'}})
assert_fail({'a_dict_with_keyschema': {'KEY': 'value'}})
def test_a_list_length(schema):
field = 'a_list_length'
min_length = schema[field]['minlength']
max_length = schema[field]['maxlength']
assert_fail({field: [1] * (min_length - 1)},
error=(field, (field, 'minlength'), errors.MIN_LENGTH,
min_length, (min_length - 1,)))
for i in range(min_length, max_length):
value = [1] * i
assert_success({field: value})
assert_fail({field: [1] * (max_length + 1)},
error=(field, (field, 'maxlength'), errors.MAX_LENGTH,
max_length, (max_length + 1,)))
def test_custom_datatype():
class MyValidator(Validator):
def _validate_type_objectid(self, value):
if re.match('[a-f0-9]{24}', value):
return True
schema = {'test_field': {'type': 'objectid'}}
validator = MyValidator(schema)
assert_success({'test_field': '50ad188438345b1049c88a28'},
validator=validator)
assert_fail({'test_field': 'hello'}, validator=validator,
error=('test_field', ('test_field', 'type'), errors.BAD_TYPE,
'objectid'))
def test_custom_datatype_rule():
class MyValidator(Validator):
def _validate_min_number(self, min_number, field, value):
""" {'type': 'number'} """
if value < min_number:
self._error(field, 'Below the min')
def _validate_type_number(self, value):
if isinstance(value, int):
return True
schema = {'test_field': {'min_number': 1, 'type': 'number'}}
validator = MyValidator(schema)
assert_fail({'test_field': '0'}, validator=validator,
error=('test_field', ('test_field', 'type'), errors.BAD_TYPE,
'number'))
assert_fail({'test_field': 0}, validator=validator,
error=('test_field', (), errors.CUSTOM, None,
('Below the min',)))
assert validator.errors == {'test_field': ['Below the min']}
def test_custom_validator():
class MyValidator(Validator):
def _validate_isodd(self, isodd, field, value):
""" {'type': 'boolean'} """
if isodd and not bool(value & 1):
self._error(field, 'Not an odd number')
schema = {'test_field': {'isodd': True}}
validator = MyValidator(schema)
assert_success({'test_field': 7}, validator=validator)
assert_fail({'test_field': 6}, validator=validator,
error=('test_field', (), errors.CUSTOM, None,
('Not an odd number',)))
assert validator.errors == {'test_field': ['Not an odd number']}
@mark.parametrize('value, _type',
(('', 'string'), ((), 'list'), ({}, 'dict'), ([], 'list')))
def test_empty_values(value, _type):
field = 'test'
schema = {field: {'type': _type}}
document = {field: value}
assert_success(document, schema)
schema[field]['empty'] = False
assert_fail(document, schema,
error=(field, (field, 'empty'),
errors.EMPTY_NOT_ALLOWED, False))
schema[field]['empty'] = True
assert_success(document, schema)
def test_ignore_none_values():
field = 'test'
schema = {field: {'type': 'string', 'empty': False, 'required': False}}
document = {field: None}
# Test normal behaviour
validator = Validator(schema, ignore_none_values=False)
assert_fail(document, validator=validator)
validator.schema[field]['required'] = True
validator.schema.validate()
_errors = assert_fail(document, validator=validator)
assert_not_has_error(_errors, field, (field, 'required'),
errors.REQUIRED_FIELD, True)
# Test ignore None behaviour
validator = Validator(schema, ignore_none_values=True)
validator.schema[field]['required'] = False
validator.schema.validate()
assert_success(document, validator=validator)
validator.schema[field]['required'] = True
_errors = assert_fail(schema=schema, document=document, validator=validator)
assert_has_error(_errors, field, (field, 'required'), errors.REQUIRED_FIELD,
True)
assert_not_has_error(_errors, field, (field, 'type'), errors.BAD_TYPE,
'string')
def test_unknown_keys():
schema = {}
# test that unknown fields are allowed when allow_unknown is True.
v = Validator(allow_unknown=True, schema=schema)
assert_success({"unknown1": True, "unknown2": "yes"}, validator=v)
# test that unknown fields are allowed only if they meet the
# allow_unknown schema when provided.
v.allow_unknown = {'type': 'string'}
assert_success(document={'name': 'mark'}, validator=v)
assert_fail({"name": 1}, validator=v)
# test that unknown fields are not allowed if allow_unknown is False
v.allow_unknown = False
assert_fail({'name': 'mark'}, validator=v)
def test_unknown_key_dict(validator):
# https://github.com/nicolaiarocci/cerberus/issues/177
validator.allow_unknown = True
document = {'a_dict': {'foo': 'foo_value', 'bar': 25}}
assert_success(document, {}, validator=validator)
def test_unknown_key_list(validator):
# https://github.com/nicolaiarocci/cerberus/issues/177
validator.allow_unknown = True
document = {'a_dict': ['foo', 'bar']}
assert_success(document, {}, validator=validator)
def test_unknown_keys_list_of_dicts(validator):
# test that allow_unknown is honored even for subdicts in lists.
# https://github.com/nicolaiarocci/cerberus/issues/67.
validator.allow_unknown = True
document = {'a_list_of_dicts': [{'sku': 'YZ069', 'price': 25,
'extra': True}]}
assert_success(document, validator=validator)
def test_unknown_keys_retain_custom_rules():
# test that allow_unknown schema respect custom validation rules.
# https://github.com/nicolaiarocci/cerberus/issues/#66.
class CustomValidator(Validator):
def _validate_type_foo(self, value):
if value == "foo":
return True
validator = CustomValidator({})
validator.allow_unknown = {"type": "foo"}
assert_success(document={"fred": "foo", "barney": "foo"},
validator=validator)
def test_nested_unknown_keys():
schema = {
'field1': {
'type': 'dict',
'allow_unknown': True,
'schema': {'nested1': {'type': 'string'}}
}
}
document = {
'field1': {
'nested1': 'foo',
'arb1': 'bar',
'arb2': 42
}
}
assert_success(document=document, schema=schema)
schema['field1']['allow_unknown'] = {'type': 'string'}
assert_fail(document=document, schema=schema)
def test_novalidate_noerrors(validator):
"""
In v0.1.0 and below `self.errors` raised an exception if no
validation had been performed yet.
"""
assert validator.errors == {}
def test_callable_validator():
"""
Validator instance is callable, functions as a shorthand
passthrough to validate()
"""
schema = {'test_field': {'type': 'string'}}
v = Validator(schema)
assert v.validate({'test_field': 'foo'})
assert v({'test_field': 'foo'})
assert not v.validate({'test_field': 1})
assert not v({'test_field': 1})
def test_dependencies_field():
schema = {'test_field': {'dependencies': 'foo'},
'foo': {'type': 'string'}}
assert_success({'test_field': 'foobar', 'foo': 'bar'}, schema)
assert_fail({'test_field': 'foobar'}, schema)
def test_dependencies_list():
schema = {
'test_field': {'dependencies': ['foo', 'bar']},
'foo': {'type': 'string'},
'bar': {'type': 'string'}
}
assert_success({'test_field': 'foobar', 'foo': 'bar', 'bar': 'foo'},
schema)
assert_fail({'test_field': 'foobar', 'foo': 'bar'}, schema)
def test_dependencies_list_with_required_field():
schema = {
'test_field': {'required': True, 'dependencies': ['foo', 'bar']},
'foo': {'type': 'string'},
'bar': {'type': 'string'}
}
# False: all dependencies missing
assert_fail({'test_field': 'foobar'}, schema)
# False: one of dependencies missing
assert_fail({'test_field': 'foobar', 'foo': 'bar'}, schema)
# False: one of dependencies missing
assert_fail({'test_field': 'foobar', 'bar': 'foo'}, schema)
# False: dependencies are validated and field is required
assert_fail({'foo': 'bar', 'bar': 'foo'}, schema)
# False: All dependencies are optional but field is still required
assert_fail({}, schema)
# True: dependency missing
assert_fail({'foo': 'bar'}, schema)
# True: dependencies are validated but field is not required
schema['test_field']['required'] = False
assert_success({'foo': 'bar', 'bar': 'foo'}, schema)
def test_dependencies_list_with_subodcuments_fields():
schema = {
'test_field': {'dependencies': ['a_dict.foo', 'a_dict.bar']},
'a_dict': {
'type': 'dict',
'schema': {
'foo': {'type': 'string'},
'bar': {'type': 'string'}
}
}
}
assert_success({'test_field': 'foobar',
'a_dict': {'foo': 'foo', 'bar': 'bar'}}, schema)
assert_fail({'test_field': 'foobar', 'a_dict': {}}, schema)
assert_fail({'test_field': 'foobar',
'a_dict': {'foo': 'foo'}}, schema)
def test_dependencies_dict():
schema = {
'test_field': {'dependencies': {'foo': 'foo', 'bar': 'bar'}},
'foo': {'type': 'string'},
'bar': {'type': 'string'}
}
assert_success({'test_field': 'foobar', 'foo': 'foo', 'bar': 'bar'},
schema)
assert_fail({'test_field': 'foobar', 'foo': 'foo'}, schema)
assert_fail({'test_field': 'foobar', 'foo': 'bar'}, schema)
assert_fail({'test_field': 'foobar', 'bar': 'bar'}, schema)
assert_fail({'test_field': 'foobar', 'bar': 'foo'}, schema)
assert_fail({'test_field': 'foobar'}, schema)
def test_dependencies_dict_with_required_field():
schema = {
'test_field': {
'required': True,
'dependencies': {'foo': 'foo', 'bar': 'bar'}
},
'foo': {'type': 'string'},
'bar': {'type': 'string'}
}
# False: all dependencies missing
assert_fail({'test_field': 'foobar'}, schema)
# False: one of dependencies missing
assert_fail({'test_field': 'foobar', 'foo': 'foo'}, schema)
assert_fail({'test_field': 'foobar', 'bar': 'bar'}, schema)
# False: dependencies are validated and field is required
assert_fail({'foo': 'foo', 'bar': 'bar'}, schema)
# False: All dependencies are optional, but field is still required
assert_fail({}, schema)
# False: dependency missing
assert_fail({'foo': 'bar'}, schema)
assert_success({'test_field': 'foobar', 'foo': 'foo', 'bar': 'bar'},
schema)
# True: dependencies are validated but field is not required
schema['test_field']['required'] = False
assert_success({'foo': 'bar', 'bar': 'foo'}, schema)
def test_dependencies_dict_with_subodcuments_fields():
schema = {
'test_field': {'dependencies': {'a_dict.foo': ['foo', 'bar'],
'a_dict.bar': 'bar'}},
'a_dict': {
'type': 'dict',
'schema': {
'foo': {'type': 'string'},
'bar': {'type': 'string'}
}
}
}
assert_success({'test_field': 'foobar',
'a_dict': {'foo': 'foo', 'bar': 'bar'}}, schema)
assert_success({'test_field': 'foobar',
'a_dict': {'foo': 'bar', 'bar': 'bar'}}, schema)
assert_fail({'test_field': 'foobar', 'a_dict': {}}, schema)
assert_fail({'test_field': 'foobar',
'a_dict': {'foo': 'foo', 'bar': 'foo'}}, schema)
assert_fail({'test_field': 'foobar', 'a_dict': {'bar': 'foo'}},
schema)
assert_fail({'test_field': 'foobar', 'a_dict': {'bar': 'bar'}},
schema)
def test_root_relative_dependencies():
# https://github.com/nicolaiarocci/cerberus/issues/288
schema = {'package': {'allow_unknown': True,
'schema': {'version': {'dependencies': '^repo'}}},
'repo': {}}
assert_fail({'package': {'repo': 'somewhere', 'version': 0}}, schema,
error=(('package', 'version'),
('package', 'schema', 'version', 'dependencies'),
errors.DEPENDENCIES_FIELD, '^repo', ('^repo',)))
assert_success({'repo': 'somewhere', 'package': {'version': 1}}, schema)
def test_dependencies_errors():
v = Validator({'field1': {'required': False},
'field2': {'required': True,
'dependencies': {'field1': ['one', 'two']}}})
assert_fail({'field1': 'three', 'field2': 7}, validator=v,
error=('field2', ('field2', 'dependencies'),
errors.DEPENDENCIES_FIELD_VALUE,
{'field1': ['one', 'two']}, ({'field1': 'three'},)))
def test_options_passed_to_nested_validators(validator):
validator.schema = {'sub_dict': {'type': 'dict',
'schema': {'foo': {'type': 'string'}}}}
validator.allow_unknown = True
assert_success({'sub_dict': {'foo': 'bar', 'unknown': True}},
validator=validator)
def test_self_root_document():
""" Make sure self.root_document is always the root document.
See:
* https://github.com/nicolaiarocci/cerberus/pull/42
* https://github.com/nicolaiarocci/eve/issues/295
"""
class MyValidator(Validator):
def _validate_root_doc(self, root_doc, field, value):
""" {'type': 'boolean'} """
if ('sub' not in self.root_document or
len(self.root_document['sub']) != 2):
self._error(field, 'self.context is not the root doc!')
schema = {
'sub': {
'type': 'list',
'root_doc': True,
'schema': {
'type': 'dict',
'schema': {
'foo': {
'type': 'string',
'root_doc': True
}
}
}
}
}
assert_success({'sub': [{'foo': 'bar'}, {'foo': 'baz'}]},
validator=MyValidator(schema))
def test_validator_rule(validator):
def validate_name(field, value, error):
if not value.islower():
error(field, 'must be lowercase')
validator.schema = {
'name': {'validator': validate_name},
'age': {'type': 'integer'}
}
assert_fail({'name': 'ItsMe', 'age': 2}, validator=validator,
error=('name', (), errors.CUSTOM, None, ('must be lowercase',)))
assert validator.errors == {'name': ['must be lowercase']}
assert_success({'name': 'itsme', 'age': 2}, validator=validator)
def test_validated(validator):
validator.schema = {'property': {'type': 'string'}}
document = {'property': 'string'}
assert validator.validated(document) == document
document = {'property': 0}
assert validator.validated(document) is None
def test_anyof():
# prop1 must be either a number between 0 and 10
schema = {'prop1': {'min': 0, 'max': 10}}
doc = {'prop1': 5}
assert_success(doc, schema)
# prop1 must be either a number between 0 and 10 or 100 and 110
schema = {'prop1': {'anyof':
[{'min': 0, 'max': 10}, {'min': 100, 'max': 110}]}}
doc = {'prop1': 105}
assert_success(doc, schema)
# prop1 must be either a number between 0 and 10 or 100 and 110
schema = {'prop1': {'anyof':
[{'min': 0, 'max': 10}, {'min': 100, 'max': 110}]}}
doc = {'prop1': 50}
assert_fail(doc, schema)
# prop1 must be an integer that is either be
# greater than or equal to 0, or greater than or equal to 10
schema = {'prop1': {'type': 'integer',
'anyof': [{'min': 0}, {'min': 10}]}}
assert_success({'prop1': 10}, schema)
# test that intermediate schemas do not sustain
assert 'type' not in schema['prop1']['anyof'][0]
assert 'type' not in schema['prop1']['anyof'][1]
assert 'allow_unknown' not in schema['prop1']['anyof'][0]
assert 'allow_unknown' not in schema['prop1']['anyof'][1]
assert_success({'prop1': 5}, schema)
exp_child_errors = [
(('prop1',), ('prop1', 'anyof', 0, 'min'), errors.MIN_VALUE, 0),
(('prop1',), ('prop1', 'anyof', 1, 'min'), errors.MIN_VALUE, 10)
]
assert_fail({'prop1': -1}, schema,
error=(('prop1',), ('prop1', 'anyof'), errors.ANYOF,
[{'min': 0}, {'min': 10}]),
child_errors=exp_child_errors)
doc = {'prop1': 5.5}
assert_fail(doc, schema)
doc = {'prop1': '5.5'}
assert_fail(doc, schema)
def test_allof():
# prop1 has to be a float between 0 and 10
schema = {'prop1': {'allof': [
{'type': 'float'}, {'min': 0}, {'max': 10}]}}
doc = {'prop1': -1}
assert_fail(doc, schema)
doc = {'prop1': 5}
assert_success(doc, schema)
doc = {'prop1': 11}
assert_fail(doc, schema)
# prop1 has to be a float and an integer
schema = {'prop1': {'allof': [{'type': 'float'}, {'type': 'integer'}]}}
doc = {'prop1': 11}
assert_success(doc, schema)
doc = {'prop1': 11.5}
assert_fail(doc, schema)
doc = {'prop1': '11'}
assert_fail(doc, schema)
def test_unicode_allowed():
# issue 280
doc = {'letters': u'♄εℓł☺'}
schema = {'letters': {'type': 'string', 'allowed': ['a', 'b', 'c']}}
assert_fail(doc, schema)
schema = {'letters': {'type': 'string', 'allowed': [u'♄εℓł☺']}}
assert_success(doc, schema)
schema = {'letters': {'type': 'string', 'allowed': ['♄εℓł☺']}}
doc = {'letters': '♄εℓł☺'}
assert_success(doc, schema)
@mark.skipif(sys.version_info[0] < 3,
reason='requires python 3.x')
def test_unicode_allowed_py3():
""" All strings are unicode in Python 3.x. Input doc and schema
have equal strings and validation yield success."""
# issue 280
doc = {'letters': u'♄εℓł☺'}
schema = {'letters': {'type': 'string', 'allowed': ['♄εℓł☺']}}
assert_success(doc, schema)
@mark.skipif(sys.version_info[0] > 2,
reason='requires python 2.x')
def test_unicode_allowed_py2():
""" Python 2.x encodes value of allowed using default encoding if
the string includes characters outside ASCII range. Produced string
does not match input which is an unicode string."""
# issue 280
doc = {'letters': u'♄εℓł☺'}
schema = {'letters': {'type': 'string', 'allowed': ['♄εℓł☺']}}
assert_fail(doc, schema)
def test_oneof():
# prop1 can only only be:
# - greater than 10
# - greater than 0
# - equal to -5, 5, or 15
schema = {'prop1': {'type': 'integer', 'oneof': [
{'min': 0},
{'min': 10},
{'allowed': [-5, 5, 15]}]}}
# document is not valid
# prop1 not greater than 0, 10 or equal to -5
doc = {'prop1': -1}
assert_fail(doc, schema)
# document is valid
# prop1 is less then 0, but is -5
doc = {'prop1': -5}
assert_success(doc, schema)
# document is valid
# prop1 greater than 0
doc = {'prop1': 1}
assert_success(doc, schema)
# document is not valid
# prop1 is greater than 0
# and equal to 5
doc = {'prop1': 5}
assert_fail(doc, schema)
# document is not valid
# prop1 is greater than 0
# and greater than 10
doc = {'prop1': 11}
assert_fail(doc, schema)
# document is not valid
# prop1 is greater than 0
# and greater than 10
# and equal to 15
doc = {'prop1': 15}
assert_fail(doc, schema)
def test_noneof():
# prop1 can not be:
# - greater than 10
# - greater than 0
# - equal to -5, 5, or 15
schema = {'prop1': {'type': 'integer', 'noneof': [
{'min': 0},
{'min': 10},
{'allowed': [-5, 5, 15]}]}}
# document is valid
doc = {'prop1': -1}
assert_success(doc, schema)
# document is not valid
# prop1 is equal to -5
doc = {'prop1': -5}
assert_fail(doc, schema)
# document is not valid
# prop1 greater than 0
doc = {'prop1': 1}
assert_fail(doc, schema)
# document is not valid
doc = {'prop1': 5}
assert_fail(doc, schema)
# document is not valid
doc = {'prop1': 11}
assert_fail(doc, schema)
# document is not valid
# and equal to 15
doc = {'prop1': 15}
assert_fail(doc, schema)
def test_anyof_allof():
# prop1 can be any number outside of [0-10]
schema = {'prop1': {'allof': [{'anyof': [{'type': 'float'},
{'type': 'integer'}]},
{'anyof': [{'min': 10},
{'max': 0}]}
]}}
doc = {'prop1': 11}
assert_success(doc, schema)
doc = {'prop1': -1}
assert_success(doc, schema)
doc = {'prop1': 5}
assert_fail(doc, schema)
doc = {'prop1': 11.5}
assert_success(doc, schema)
doc = {'prop1': -1.5}
assert_success(doc, schema)
doc = {'prop1': 5.5}
assert_fail(doc, schema)
doc = {'prop1': '5.5'}
assert_fail(doc, schema)
def test_anyof_schema(validator):
# test that a list of schemas can be specified.
valid_parts = [{'schema': {'model number': {'type': 'string'},
'count': {'type': 'integer'}}},
{'schema': {'serial number': {'type': 'string'},
'count': {'type': 'integer'}}}]
valid_item = {'type': ['dict', 'string'], 'anyof': valid_parts}
schema = {'parts': {'type': 'list', 'schema': valid_item}}
document = {'parts': [{'model number': 'MX-009', 'count': 100},
{'serial number': '898-001'},
'misc']}
# document is valid. each entry in 'parts' matches a type or schema
assert_success(document, schema, validator=validator)
document['parts'].append({'product name': "Monitors", 'count': 18})
# document is invalid. 'product name' does not match any valid schemas
assert_fail(document, schema, validator=validator)
document['parts'].pop()
# document is valid again
assert_success(document, schema, validator=validator)
document['parts'].append({'product name': "Monitors", 'count': 18})
document['parts'].append(10)
# and invalid. numbers are not allowed.
exp_child_errors = [
(('parts', 3), ('parts', 'schema', 'anyof'), errors.ANYOF,
valid_parts),
(('parts', 4), ('parts', 'schema', 'type'), errors.BAD_TYPE,
['dict', 'string'])
]
_errors = assert_fail(document, schema, validator=validator,
error=('parts', ('parts', 'schema'),
errors.SEQUENCE_SCHEMA, valid_item),
child_errors=exp_child_errors)
assert_not_has_error(_errors, ('parts', 4), ('parts', 'schema', 'anyof'),
errors.ANYOF, valid_parts)
v_errors = validator.errors
assert 'parts' in v_errors
assert 3 in v_errors['parts'][-1]
assert 'anyof' in v_errors['parts'][-1][3][-1]
assert v_errors['parts'][-1][3][-1]['anyof'][0] == "no definitions validate"
scope = v_errors['parts'][-1][3][-1]['anyof'][-1]
assert 'anyof definition 0' in scope
assert 'anyof definition 1' in scope
assert scope['anyof definition 0'] == ["unknown field"]
assert scope['anyof definition 1'] == ["unknown field"]
assert v_errors['parts'][-1][4] == ["must be of ['dict', 'string'] type"]
def test_anyof_2():
# these two schema should be the same
schema1 = {'prop': {'anyof': [{'type': 'dict',
'schema': {
'val': {'type': 'integer'}}},
{'type': 'dict',
'schema': {
'val': {'type': 'string'}}}]}}
schema2 = {'prop': {'type': 'dict', 'anyof': [
{'schema': {'val': {'type': 'integer'}}},
{'schema': {'val': {'type': 'string'}}}]}}
doc = {'prop': {'val': 0}}
assert_success(doc, schema1)
assert_success(doc, schema2)
doc = {'prop': {'val': '0'}}
assert_success(doc, schema1)
assert_success(doc, schema2)
doc = {'prop': {'val': 1.1}}
assert_fail(doc, schema1)
assert_fail(doc, schema2)
def test_anyof_type():
schema = {'anyof_type': {'anyof_type': ['string', 'integer']}}
assert_success({'anyof_type': 'bar'}, schema)
assert_success({'anyof_type': 23}, schema)
def test_oneof_schema():
schema = {'oneof_schema': {'type': 'dict',
'oneof_schema':
[{'digits': {'type': 'integer',
'min': 0, 'max': 99}},
{'text': {'type': 'string',
'regex': '^[0-9]{2}$'}}]}}
assert_success({'oneof_schema': {'digits': 19}}, schema)
assert_success({'oneof_schema': {'text': '84'}}, schema)
assert_fail({'oneof_schema': {'digits': 19, 'text': '84'}}, schema)
def test_nested_oneof_type():
schema = {'nested_oneof_type':
{'valueschema': {'oneof_type': ['string', 'integer']}}}
assert_success({'nested_oneof_type': {'foo': 'a'}}, schema)
assert_success({'nested_oneof_type': {'bar': 3}}, schema)
def test_no_of_validation_if_type_fails(validator):
valid_parts = [{'schema': {'model number': {'type': 'string'},
'count': {'type': 'integer'}}},
{'schema': {'serial number': {'type': 'string'},
'count': {'type': 'integer'}}}]
validator.schema = {'part': {'type': ['dict', 'string'],
'anyof': valid_parts}}
document = {'part': 10}
_errors = assert_fail(document, validator=validator)
assert len(_errors) == 1
def test_issue_107(validator):
schema = {'info': {'type': 'dict',
'schema': {'name': {'type': 'string',
'required': True}}}}
document = {'info': {'name': 'my name'}}
assert_success(document, schema, validator=validator)
v = Validator(schema)
assert_success(document, schema, v)
# it once was observed that this behaves other than the previous line
assert v.validate(document)
def test_dont_type_validate_nulled_values(validator):
assert_fail({'an_integer': None}, validator=validator)
assert validator.errors == {'an_integer': ['null value not allowed']}
def test_dependencies_error(validator):
schema = {'field1': {'required': False},
'field2': {'required': True,
'dependencies': {'field1': ['one', 'two']}}}
validator.validate({'field2': 7}, schema)
exp_msg = errors.BasicErrorHandler \
.messages[errors.DEPENDENCIES_FIELD_VALUE.code] \
.format(field='field2', constraint={'field1': ['one', 'two']})
assert validator.errors == {'field2': [exp_msg]}
def test_dependencies_on_boolean_field_with_one_value():
# https://github.com/nicolaiarocci/cerberus/issues/138
schema = {'deleted': {'type': 'boolean'},
'text': {'dependencies': {'deleted': False}}}
try:
assert_success({'text': 'foo', 'deleted': False}, schema)
assert_fail({'text': 'foo', 'deleted': True}, schema)
assert_fail({'text': 'foo'}, schema)
except TypeError as e:
if str(e) == "argument of type 'bool' is not iterable":
raise AssertionError(
"Bug #138 still exists, couldn't use boolean in dependency "
"without putting it in a list.\n"
"'some_field': True vs 'some_field: [True]")
else:
raise
def test_dependencies_on_boolean_field_with_value_in_list():
# https://github.com/nicolaiarocci/cerberus/issues/138
schema = {'deleted': {'type': 'boolean'},
'text': {'dependencies': {'deleted': [False]}}}
assert_success({'text': 'foo', 'deleted': False}, schema)
assert_fail({'text': 'foo', 'deleted': True}, schema)
assert_fail({'text': 'foo'}, schema)
def test_document_path():
class DocumentPathTester(Validator):
def _validate_trail(self, constraint, field, value):
""" {'type': 'boolean'} """
test_doc = self.root_document
for crumb in self.document_path:
test_doc = test_doc[crumb]
assert test_doc == self.document
v = DocumentPathTester()
schema = {'foo': {'schema': {'bar': {'trail': True}}}}
document = {'foo': {'bar': {}}}
assert_success(document, schema, validator=v)
def test_excludes():
schema = {'this_field': {'type': 'dict',
'excludes': 'that_field'},
'that_field': {'type': 'dict'}}
assert_success({'this_field': {}}, schema)
assert_success({'that_field': {}}, schema)
assert_success({}, schema)
assert_fail({'that_field': {}, 'this_field': {}}, schema)
def test_mutual_excludes():
schema = {'this_field': {'type': 'dict',
'excludes': 'that_field'},
'that_field': {'type': 'dict',
'excludes': 'this_field'}}
assert_success({'this_field': {}}, schema)
assert_success({'that_field': {}}, schema)
assert_success({}, schema)
assert_fail({'that_field': {}, 'this_field': {}}, schema)
def test_required_excludes():
schema = {'this_field': {'type': 'dict',
'excludes': 'that_field',
'required': True},
'that_field': {'type': 'dict',
'excludes': 'this_field',
'required': True}}
assert_success({'this_field': {}}, schema, update=False)
assert_success({'that_field': {}}, schema, update=False)
assert_fail({}, schema)
assert_fail({'that_field': {}, 'this_field': {}}, schema)
def test_multiples_exclusions():
schema = {'this_field': {'type': 'dict',
'excludes': ['that_field', 'bazo_field']},
'that_field': {'type': 'dict',
'excludes': 'this_field'},
'bazo_field': {'type': 'dict'}}
assert_success({'this_field': {}}, schema)
assert_success({'that_field': {}}, schema)
assert_fail({'this_field': {}, 'that_field': {}}, schema)
assert_fail({'this_field': {}, 'bazo_field': {}}, schema)
assert_fail({'that_field': {}, 'this_field': {}, 'bazo_field': {}}, schema)
assert_success({'that_field': {}, 'bazo_field': {}}, schema)
def test_bad_excludes_fields(validator):
validator.schema = {'this_field': {'type': 'dict',
'excludes': ['that_field', 'bazo_field'],
'required': True},
'that_field': {'type': 'dict',
'excludes': 'this_field',
'required': True}}
assert_fail({'that_field': {}, 'this_field': {}}, validator=validator)
handler = errors.BasicErrorHandler
assert (validator.errors ==
{'that_field':
[handler.messages[errors.EXCLUDES_FIELD.code].format(
"'this_field'", field="that_field")],
'this_field':
[handler.messages[errors.EXCLUDES_FIELD.code].format(
"'that_field', 'bazo_field'", field="this_field")]})
def test_boolean_is_not_a_number():
# https://github.com/nicolaiarocci/cerberus/issues/144
assert_fail({'value': True}, {'value': {'type': 'number'}})
def test_min_max_date():
schema = {'date': {'min': date(1900, 1, 1), 'max': date(1999, 12, 31)}}
assert_success({'date': date(1945, 5, 8)}, schema)
assert_fail({'date': date(1871, 5, 10)}, schema)
def test_dict_length():
schema = {'dict': {'minlength': 1}}
assert_fail({'dict': {}}, schema)
assert_success({'dict': {'foo': 'bar'}}, schema)
def test_forbidden():
schema = {'user': {'forbidden': ['root', 'admin']}}
assert_fail({'user': 'admin'}, schema)
assert_success({'user': 'alice'}, schema)
def test_mapping_with_sequence_schema():
schema = {'list': {'schema': {'allowed': ['a', 'b', 'c']}}}
document = {'list': {'is_a': 'mapping'}}
assert_fail(document, schema,
error=('list', ('list', 'schema'), errors.BAD_TYPE_FOR_SCHEMA,
schema['list']['schema']))
def test_sequence_with_mapping_schema():
schema = {'list': {'schema': {'foo': {'allowed': ['a', 'b', 'c']}},
'type': 'dict'}}
document = {'list': ['a', 'b', 'c']}
assert_fail(document, schema)
def test_type_error_aborts_validation():
schema = {'foo': {'type': 'string', 'allowed': ['a']}}
document = {'foo': 0}
assert_fail(document, schema,
error=('foo', ('foo', 'type'), errors.BAD_TYPE, 'string'))
def test_dependencies_in_oneof():
# https://github.com/nicolaiarocci/cerberus/issues/241
schema = {'a': {'type': 'integer',
'oneof': [
{'allowed': [1], 'dependencies': 'b'},
{'allowed': [2], 'dependencies': 'c'}
]},
'b': {},
'c': {}}
assert_success({'a': 1, 'b': 'foo'}, schema)
assert_success({'a': 2, 'c': 'bar'}, schema)
assert_fail({'a': 1, 'c': 'foo'}, schema)
assert_fail({'a': 2, 'b': 'bar'}, schema)
def test_allow_unknown_with_oneof_rules(validator):
# https://github.com/nicolaiarocci/cerberus/issues/251
schema = {
'test': {
'oneof': [
{
'type': 'dict',
'allow_unknown': True,
'schema': {'known': {'type': 'string'}}
},
{
'type': 'dict',
'schema': {'known': {'type': 'string'}}
},
]
}
}
# check regression and that allow unknown does not cause any different
# than expected behaviour for one-of.
document = {'test': {'known': 's'}}
validator(document, schema)
_errors = validator._errors
assert len(_errors) == 1
assert_has_error(_errors, 'test', ('test', 'oneof'),
errors.ONEOF, schema['test']['oneof'])
assert len(_errors[0].child_errors) == 0
# check that allow_unknown is actually applied
document = {'test': {'known': 's', 'unknown': 'asd'}}
assert_success(document, validator=validator)