Skip to main content

Highly flexible, no magic input validation library

Project description

pycerberus is a framework to check user data thoroughly so that you can protect your application from malicious (or just garbled) input data.

  • Remove stupid code which converts input values: After values are validated, you can work with real Python types instead of strings - e.g. 42 instead of ‘42’, convert database IDs to model objects transparently.

  • Implement custom validation rules: Writing custom validators is straightforward, everything is well documented and pycerberus only uses very little Python magic.

  • Focus on your value-adding application code: Save time by implementing every input validation rule only once, but 100% right instead of implementing a dozen different half-baked solutions.

  • Ready for global business: i18n support (based on GNU gettext) is built in, adding custom translations is easy.

  • Tune it for your needs: You can implement custom behavior in your validators, e.g. fetch translations from a database instead of using gettext or define custom translations for built-in validators.

  • Use it wherever you like: pycerberus is used in a SMTP server, trac macros as well as web applications - there are no dependencies on a specific context like web development.

Changelog

0.5 (05.08.2013)

  • ‘allow_additional_parameters’ can now be specified in the schema constructor directly as well as a parameter for a declarative schema

  • new ForEach validator to validate a list of items with the same validator

  • added ‘min_length’, ‘max_length’ parameters when instantiating a StringValidator

  • InvalidDataErrors can return a list of errors using ‘.errors()’

  • All validator messages can be overridden during instantiation by specifying messages attribute,

  • new OneOf validator to validate that a value is in a given list of allowed values

  • added constructor parameter ‘filter_unvalidated_parameters’ (default True) for SchemaValidators to pass unvalidated parameters instead of removing them

  • InvalidDataErrors can “unpack” their errors so that an ordinary dict is used as container for sub-errors (instead of another InvalidDataError with an error_dict)

  • new BooleanCheckbox validator to validate typical HTML checkboxes

  • new API method for all validators: ‘.copy()’ returns a clone of the validator

  • new MatchingFields form validator (typically used to verify a password confirmation field)

  • new AgreeToConditionsCheckbox validator which works like a BooleanCheckbox but enforces a trueish value

  • EmailAddressValidator accepts also ‘-’ and ‘+’ characters in local part

API changes:

  • BaseValidator.error() is deprecated now as the name does not really reflect that the method also raised the exception. I added a new method named ‘.raise_error()’ which behaves exactly like the old .error() method. In addition there is a new method ‘.exception()’ which only creates an exception instance.

0.4.2 (05.05.2011)

  • More fixes for source distribution because of missing files in tar.gz

0.4.1 (16.04.2011)

  • Fix source distribution (distribution_helpers.py were not included)

0.4 (13.04.2011)

  • pycerberus now supports Python 3!

  • Fix installation/egg generation without babel

  • Added a schema which can parse positional parameters from a string into a dict before processing the data like a normal schema would do

0.3.3 (04.07.2010)

  • Fix installation issue: pycerberus is actually not zip-safe

0.3.2 (05.06.2010)

  • Fix egg file generation: Include all necessary packages in eggs

  • added babel support to setup.py

  • updated pot file and completed German translation

  • fix exception if translations for preferred locale are not available (fall back to english messages)

0.3.1 (07.04.2010)

  • Fixed bug due to duplicated message in DomainNameValidator/EmailAddressValidator

  • Validator can now strip inputs (False by default)

  • StringValidator now also treats ‘’ as empty value (as well as None)

0.3 (27.03.2010)

  • Python 2.3 compatibility

  • Schema can raise error if unknown items are processed

  • Basic domain name validator

  • Basic email address validator

0.2 (16.03.2010)

  • You now can declare custom messages as a class-level dict

  • Added interface to retrieve error details from InvalidDataErrors

  • Added validation schemas to validate a set of values (typically a web form). Schemas can also inherit from other schemas to avoid code duplication.

  • Validators try to make thread-safety violations obvious

  • Nicer API to retrieve error details from an InvalidDataError

0.1 (30.01.2010)

  • initial release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pycerberus-0.5.tar.gz (150.2 kB view details)

Uploaded Source

Built Distribution

pycerberus-0.5-py2.7.egg (82.3 kB view details)

Uploaded Source

File details

Details for the file pycerberus-0.5.tar.gz.

File metadata

  • Download URL: pycerberus-0.5.tar.gz
  • Upload date:
  • Size: 150.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pycerberus-0.5.tar.gz
Algorithm Hash digest
SHA256 e273e00c2447920cacafbe50e61c5dcc3b9c062be94a731c349b42cc4d03e8e5
MD5 f4f92a342e9fec040fddae52889bc8d3
BLAKE2b-256 68bb252dd5a2381c70f819b91ef49ef4d712c3eac8ff10ce6e67658a38c6c6ea

See more details on using hashes here.

File details

Details for the file pycerberus-0.5-py2.7.egg.

File metadata

  • Download URL: pycerberus-0.5-py2.7.egg
  • Upload date:
  • Size: 82.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pycerberus-0.5-py2.7.egg
Algorithm Hash digest
SHA256 c0117fbeb9b745c899cb1b917359e682618e63f12e4ad88522d3b8aa143fded2
MD5 834fd0e6676aa9f7ea90ec1ceacf8027
BLAKE2b-256 e5e903bcf2a9b265363d024bb0f85ccfcd1984d031ac5fdfc5a50f731a8ff415

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page