Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Python versions Black code style

Cerberus is a lightweight and extensible data validation library for Python.

>>> v = Validator({'name': {'type': 'string'}})
>>> v.validate({'name': 'john doe'})
True

Features

Cerberus provides type checking and other base functionality out of the box and is designed to be non-blocking and easily and widely extensible, allowing for custom validation. It has no dependencies, but has the potential to become yours.

Versioning & Interpreter support

Starting with Cerberus 1.2, it is maintained according to semantic versioning. So, a major release sheds off the old and defines a space for the new, minor releases ship further new features and improvements (you know the drill, new bugs are inevitable too), and micro releases polish a definite amount of features to glory.

We intend to test Cerberus against all CPython interpreters at least until half a year after their end of life and against the most recent PyPy interpreter as a requirement for a release. If you still need to use it with a potential security hole in your setup, it should most probably work with the latest minor version branch from the time when the interpreter was still tested. Subsequent minor versions have good chances as well. In any case, you are advised to run the contributed test suite on your target system.

Funding

Cerberus is an open source, collaboratively funded project. If you run a business and are using Cerberus in a revenue-generating product, it would make business sense to sponsor its development: it ensures the project that your product relies on stays healthy and actively maintained. Individual users are also welcome to make a recurring pledge or a one time donation if Cerberus has helped you in your work or personal projects.

Every single sign-up makes a significant impact towards making Eve possible. To learn more, check out our funding page.

Documentation

Complete documentation is available at http://docs.python-cerberus.org

Installation

Cerberus is on PyPI, so all you need to do is:

$ pip install cerberus

Testing

Just run:

$ python setup.py test

Or you can use tox to run the tests under all supported Python versions. Make sure the required python versions are installed and run:

$ pip install tox  # first time only
$ tox

Contributing

Please see the Contribution Guidelines.

Download files

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

Source Distribution

Cerberus-1.3.5.dev0.tar.gz (31.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

Cerberus-1.3.5.dev0-py3-none-any.whl (30.9 kB view details)

Uploaded Python 3

File details

Details for the file Cerberus-1.3.5.dev0.tar.gz.

File metadata

  • Download URL: Cerberus-1.3.5.dev0.tar.gz
  • Upload date:
  • Size: 31.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for Cerberus-1.3.5.dev0.tar.gz
Algorithm Hash digest
SHA256 24ee35f491cb1a6da67985615af0c7f1827ab1c52e1fdb8b661cb55e2b63e9d7
MD5 4ed14837633d1e33a50ceb3a6e275990
BLAKE2b-256 dbfedcb05454bc7fcea64d53e3a2c2970ee9cd05978831976ab4cebbc3aaa8cf

See more details on using hashes here.

File details

Details for the file Cerberus-1.3.5.dev0-py3-none-any.whl.

File metadata

  • Download URL: Cerberus-1.3.5.dev0-py3-none-any.whl
  • Upload date:
  • Size: 30.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for Cerberus-1.3.5.dev0-py3-none-any.whl
Algorithm Hash digest
SHA256 4e71e6107164117b1460893ca042c4fe87938feb09a9678a1a4cd05b842896d0
MD5 e1fded890579b1b9f3dd5c360c2a2726
BLAKE2b-256 b087f1f3135c88507670f6670e22e67f764bf4d44f43a6960d764c9ccad28c9f

See more details on using hashes here.

Release history Release notifications | RSS feed

1.3.8

2 files

1.3.7

2 files

1.3.6

2 files

1.3.5

2 files

This release

1.3.5.dev0 This release

2 files

1.3.4

1 file

1.3.3

2 files

1.3.2

1 file

1.3.1

1 file

1.3

1 file

1.2

1 file

1.1

1 file

1.0.1

1 file

0.9.2

1 file

0.9.1

1 file

0.9

1 file

0.8.1

1 file

0.8

1 file

0.7.2

1 file

0.7.1

1 file

0.7

1 file

0.6

1 file

0.5

1 file

0.4.0

1 file

0.3.0

1 file

0.2.0

1 file

0.1.0

1 file

0.0.3

1 file

0.0.2

1 file

0.0.1

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page