from valhalla import Schema

s = Schema(match=['password', 'password_confirm'])
s.email_address.email()
s.first_name.text()
s.last_name.text()
s.password.text(min_len=8, max_len=20)
s.password_confirm
s.location.require(False)

test_data = {
    'email_address': '[email protected]',
    'first_name': 'Peter',
    'last_name': 'Elias',
    'password': '1234',
    'password_confirm': '12345'
}

s.validate(test_data)
assert_false(s.valid) # True
assert_false(s.password.valid) # True
print s.password.errors # This field must match [password_confirm]
assert_true(s.location.valid) # True, field is not required

print s.results # {u'email_address': u'[email protected]'} etc... only yields valid values.

# Field-wide options may specified at the Schema-level or at the Field-level, field-level takes precedence.
s = Schema(require=['some_field'])
s.some_field.require(False) # overrides the schema setting

# a more useful example...

s = Schema(require='all')
s.i_am_required
s.not_me_though.require(False)

# Field-wide options: [blank, require, match, alts]
s = Schema(match=[('match_me', 'to_me'), ('and_me', 'to_other_me')], 
		   blank='all', required='all', 
		   alts=[('match_me', 'some_random_name')])

# these two must match
s.match_me 
s.to_me

# and these two must match
s.and_me
s.to_other_me

# May also be used declaratively
s = Schema()
s.i_am_required.require(True) # all fields are required by default though
s.i_can_be_blank.blank(True) # all fields CANNOT be blank by default
s.i_should_match.match('i_am_required')

'''
The difference between BLANK and REQUIRED is that a field must be included in the supplied DATA in order to be considered "present". If a value is not "present", and the field is required, an error is raised. If the value is "present", but BLANK (meaning some kind of empty value), and the field does NOT allow blanks, then an error is raised.

So, if a field is NOT REQUIRED, and NOT BLANK. Then you can omit the field entirely, but you cannot supply it with an empty value either.
'''
s.some_field.blank(False).require(False)
# either supply me with a real value or leave me alone. this is the default.

my_definition = {
	'email': ['require', ('alt', 'email_address'), 'email'], # email address with alternate name
	'age': ['require', 'numeric', ('range', 13, 100)] # age must be numeric between 13 and 100
	'password': [('text', 10, 50)],
	'password_confirm': [('match', 'password')]
}

s = Schema.from_dict(my_definition)
s.validate(some_data) # Bam!

s = Schema()
s.my_happy_place.require().text(min_len=15, max_len=25)

sdict = {
	'my_happy_place': ['require', ('text', 15, 25)]
}

s = Schema.from_dict(sdict)

@classmethod
Schema.from_dict(cls, dict_schema, **kwargs)

Schema.__init__(self, match=[], require=[], blank=[],
				alts=[], extras='discard', force_unicode=True,
				strip_missing=True, strip_blank=True)
@property
Schema.errors

@property
Schema.valid

@property
Schema.results

Schema.add_filter_chain(self, name, filter_chain)

Schema.validate(self, data_dict, **kwargs)

Schema.reset(self)