PyValitron is a light-weight python inputs validation library.
To install PyValitron run this command:
pip3 install pyvalitron
After installing the library, Read the following usage criteria:
To validate a list of values:
from pyvalitron.form import Form
form = Form({
'test_field1': {
'value': 'Hello World',
'validate': {
'length_between': {
'param': [1, 12],
'error': 'Input lenght must be between 1 and 12 characters'
}
}
},
'test_field2': {
'value': 'Hello World',
'validate': {
'length_between': {
'param': [1, 9],
'error': 'Input lenght must be between 1 and 9 characters'
}
}
}
})
form.process()
errors = form.get_errors()
print(errors['test_field2']) # Input lenght must be between 1 and 9 charactersTo sanitize a list of values:
from __future__ import print_function
from pyvalitron.form import Form
form = Form({
'test_field': {
'value': 'Hello& W"or"ld<br>.',
'sanitize': {
'escape': {}
}
}
})
form.process()
inputs = form.get_inputs()
print(inputs['test_field']) # {'is_exact': False, 'svalue': 'Hello& W"or"ld<br>.', 'sanitize': {'escape': {}}, 'value': 'Hello& W"or"ld<br>.'}
print(inputs['test_field']['is_exact']) # False
print(inputs['test_field']['svalue']) # Hello& W"or"ld<br>.
print(inputs['test_field']['value']) # Hello& W"or"ld<br>.from __future__ import print_function
from pyvalitron.form import Form
form = Form({
'test_field': {
'value': 'Hello World.',
'sanitize': {
'escape': {}
}
}
})
form.process()
inputs = form.get_inputs()
print(inputs['test_field']) # {'is_exact': True, 'svalue': 'Hello World.', 'sanitize': {'escape': {}}, 'value': 'Hello World.'}
print(inputs['test_field']['is_exact']) # True
print(inputs['test_field']['svalue']) # Hello World.
print(inputs['test_field']['value']) # Hello World.To validate and sanitize a list of values:
from __future__ import print_function
from pyvalitron.form import Form
form = Form({
'test_field': {
'value': 'hello@clivern.com',
'sanitize': {
'escape': {}
},
'validate': {
'email': {
'error': 'Please provide a valid email.'
}
}
}
})
form.process()
inputs = form.get_inputs()
errors = form.get_errors()
print(errors) # {'test_field': []}
print(errors['test_field']) # []
print(inputs['test_field']) # {'status': True, 'is_exact': True, 'value': 'hello@clivern.com', 'sanitize': {'escape': {}}, 'svalue': 'hello@clivern.com', 'validate': {'email': {'error': 'Please provide a valid email.'}}}
print(inputs['test_field']['status']) # True
print(inputs['test_field']['is_exact']) # True
print(inputs['test_field']['value']) # hello@clivern.com
print(inputs['test_field']['svalue']) # hello@clivern.comfrom __future__ import print_function
from pyvalitron.form import Form
form = Form({
'test_field': {
'value': 'hello@cliv@ern.com',
'sanitize': {
'escape': {}
},
'validate': {
'email': {
'error': 'Please provide a valid email.'
}
}
}
})
form.process()
inputs = form.get_inputs()
errors = form.get_errors()
print(errors) # {'test_field': ['Please provide a valid email.']}
print(errors['test_field']) # ['Please provide a valid email.']
print(inputs['test_field']) # {'status': False, 'is_exact': True, 'value': 'hello@cliv@ern.com', 'sanitize': {'escape': {}}, 'svalue': 'hello@cliv@ern.com', 'validate': {'email': {'error': 'Please provide a valid email.'}}}
print(inputs['test_field']['status']) # False
print(inputs['test_field']['is_exact']) # True
print(inputs['test_field']['value']) # hello@cliv@ern.com
print(inputs['test_field']['svalue']) # hello@cliv@ern.comFlask Framework
from flask import Flask
from flask import request
from pyvalitron.form import Form
app = Flask(__name__)
@app.route("/")
def hello():
form = Form({
'test_field1': {
'value': request.args.get('test_field1'),
'validate': {
'length_between': {
'param': [1, 12],
'error': 'Input lenght must be between 1 and 12 characters'
}
}
},
'test_field2': {
'value': request.args.get('test_field2'),
'validate': {
'length_between': {
'param': [1, 9],
'error': 'Input lenght must be between 1 and 9 characters'
}
}
}
}, 'values')
form.process()
errors = form.get_errors()
if 'Input lenght must be between 1 and 9 characters' in errors['test_field2']:
return 'error'
else:
return 'success'
if __name__ == "__main__":
app.run(debug=True)Here is a list of all available validators:
empty: Validate if input or a value is empty.not_empty: Validate if input or a value is not empty.length_between: Validate if input or a value length is between provided lengths. It requires two parameters[from_length, to_length]like[1, 13].min_length: Validate if input or a value min lenght is like provided one. It requires one parameter[min_length]like[1].max_length: Validate if input or a value max lenght is like provided one. It requires one parameter[max_length]like[12].exact_length: Validate if input or a value lenght is equal to provided one. It requires one parameter[exact_length]like[9].greater_than: Validate if input or a value is greater than provided one. It requires one parameter[number]like[5].greater_than_equal: Validate if input or a value is greater than or equal provided one. It requires one parameter[number]like[4].less_than: Validate if input or a value is less than provided one. It requires one parameter[number]like[5].less_than_equal: Validate if input or a value is less than or equal provided one. It requires one parameter[number]like[5].equal: Validate if input or a value is equal to provided one. It requires one parameter[number]like[5].same_as: Validate if input or a value is same as provided one. It requires one parameter[text]like['Hello World']any_of: Validate if input or a value is any of the provided list. It requires one parameter[[options]]like[1,5,'text'].all_of: Validate if input or a value is all of the provided list. It requires one parameter[[options]]like[1,5,'text'].none_of: Validate if input or a value is none of the provided list. It requires one parameter[[options]]like[1,5,'text'].alpha: Validate if input or a value is alphabetical.alpha_numeric: Validate if input or a value is alphanumeric.digit: Validate if input or a value is digits.email: Validate if input or a value is email.emails: Validate if input or a value is a list of emails. It requires one parameter[separator]like[','].url: Validate if input or a value is a URL. It requires one parameter (a list of protocols)[[protocols]]like[['http', 'https']].ip: Validate if input or a value is IP. It requires one parameter (a list of formats)[[formats]]like['ipv4']ipv4: Validate if input or a value is IPv4.uuid: Validate if input or a value is universally unique identifier (UUID)matches: Validate if input or a value matches provided regex. It requires one parameter[regex]like[r'^[_a-z0-9-]+$'].
Here is a list of all available sanitizers:
strip: Strip the input value. It accepts one parameter[[chars]]like[[',', '.', '\s']].lstrip: Left strip the input value. It accepts one parameter[[chars]]like[[',', '.', '\s']].rstrip: Right strip the input value. It accepts one parameter[[chars]]like[[',', '.', '\s']].escape: Escape the input value to prevent evil scripts. It accepts one parameter (a list of chars to escape). currently it support these characters['&', '"', '\'', '>', '<'].
To define a new validator:
from pyvalitron.validator import Validator
from pyvalitron.form import Form
class MyValidator(Validator):
def username(self):
if not isinstance(self._input, (str)):
return False
current_input = self._input.strip()
if len(current_input) > 5 and current_input.isalpha():
return True
return False
def otherrule(self):
return True
#...and so one
form = Form()
form.add_validator(MyValidator())
form.add_inputs({
'user_name': {
'value': '',
'validate': {
'username': {
'error': 'Invalid Username'
}
}
}
})
form.process()
errors = form.get_errors() #{'user_name': ['Invalid Username']}To define a new sanitizer:
from __future__ import print_function
from pyvalitron.sanitizer import Sanitizer
from pyvalitron.form import Form
class MySanitizer(Sanitizer):
def clear_spaces(self):
if not isinstance(self._input, (str)):
self._sinput = str(self._input)
else:
self._sinput = self._input
self._sinput = self._sinput.replace(" ", "")
return self._sinput
def lower_case(self):
if not isinstance(self._input, (str)):
self._sinput = str(self._input)
else:
self._sinput = self._input
self._sinput = self._sinput.lower()
return self._sinput
form = Form({
'test_field': {
'value': 'Hello World',
'sanitize': {
'clear_spaces':{},
'lower_case': {}
}
}
}, 'values')
form.add_sanitizer(MySanitizer())
form.process()
inputs = form.get_inputs()
print(inputs['test_field']['svalue']) #helloworldVersion 1.1.3:
Fix issue with validation extensions.
Version 1.1.2:
Fix import issues.
Version 1.1.1:
New Validation Rules.
Add python lint check.
Version 1.0.0:
Initial Release.
© 2019, Silverback. Released under MIT License.
PyValitron is authored and maintained by @silverbackhq.