A simple library for runtime type-checking.
Project description
Typing-validation is a small library to perform runtime validation of Python objects using PEP 484 type hints.
Install
You can install the latest release from PyPI as follows:
pip install --upgrade typing-validationUsage
The core functionality of this library is provided by the validate function:
>>> from typing_validation import validate
The validate function is invoked with a value and a type as its arguments and it returns nothing when the given value is valid for the given type:
>>> validate(12, int) True # no error raised => 12 is a valid int
If the value is invalid for the given type, the validate function raises a TypeError:
>>> validate(12, str) TypeError: Runtime validation error raised by validate(val, t), details below. For type <class 'str'>, invalid value: 12
For nested types (e.g. parametric collection/mapping types), the full chain of validation failures is shown by the type error:
>>> validate([0, 1, "hi"], list[int]) TypeError: Runtime validation error raised by validate(val, t), details below. For type list[int], invalid value at idx: 2 For type <class 'int'>, invalid value: 'hi'
The function is_valid is a variant of the validate function which returns False in case of validation failure, instead of raising TypeError:
>>> from typing_validation import is_valid >>> is_valid([0, 1, "hi"], list[int]) False
The function latest_validation_failure can be used to access detailed information immediately after a failure:
>>> from typing_validation import latest_validation_failure >>> is_valid([0, 1, "hi"], list[int]) False >>> failure = latest_validation_failure() >>> print(failure) Runtime validation error raised by validate(val, t), details below. For type list[int], invalid value at idx: 2 For type <class 'int'>, invalid value: 'hi'
Please note that latest_validation_failure clears the internal failure logs after returning the latest failure, so the latter must be manually stored if it needs to be accessed multiple times.
API
For the full API documentation, see https://typing-validation.readthedocs.io/
Contributing
Please see CONTRIBUTING.md.
License
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for typing-validation-1.2.11.post1.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d6b378e09ec36218995f34e92f205ecd6014b8aed2cbb85c4c492c0e03d4379f |
|
| MD5 | c5095d1e61b8aa8502292c6d21685c41 |
|
| BLAKE2b-256 | 413a54c9cfccf648d2664f1cec026174112dbbc9495c0141261102b21596a6b5 |
Hashes for typing_validation-1.2.11.post1-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 4c491d5f842a48dbb581f2613151e5ab5f9bba5490e655ca2dfcdb7b4030543a |
|
| MD5 | feb578648c8fff2df409b161d38add76 |
|
| BLAKE2b-256 | 76445618aaf177f3aecc6011247363fcdc684481c365067b84e00130ca6abad2 |
