Python library for input validation designed for (but not restricted to) JSON-based APIs, neatly integrating with dataclasses.
Status: Beta.
validataclass is available on PyPI.
To install it using pip, just run:
pip install validataclass
If you add the package to your dependencies, it is recommended to use compatible release version specifiers to make sure you always get the latest version of the library but without running into breaking changes:
pip install validataclass~=0.11.0
However, keep in mind that the library still is in its beta phase (as indicated by the major version of 0). There can and will be smaller breaking changes between 0.x minor versions, but we will try to keep them at a minimum and save the big breaking changes for the release of version 1.0.0.
See docs/
for documentation on how to use
this library and for examples.
(Note: The documentation is mostly done now, but still a work in progress.)
To setup a virtualenv for development of the library, run make venv
.
Alternatively you can manually run the following commands (which do the same as the make target):
$ virtualenv venv
$ source venv/bin/activate
$ pip install -r requirements.txt
$ pip install -e .
Unit tests can be run using make tox
or by directly executing tox
.
For this to work you need to either be inside the virtualenv (see above) or to have tox installed in your system locally.