Fast Argument validation for functions using decorators
Project description
Validation Decorators
Simple and fast type-checking and parameter validation.
Install with
pip install decorator-validation
Why?
Do you want to remove visual clutter in your python function? Do you want to check types fast without a lot of boilerplate?
Then this package is right for you.
Not convinced? Check out the following:
# classic
def foo(bar: int, message: str, some_additional_info: dict):
if not isinstance(bar, int):
raise TypeError(...)
if not isinstance(message, str):
raise TypeError(...)
if not isinstance(some_additional_info, dict):
raise TypeError(...)
# now begin to code...
# now
@check_types
def foo(bar: int, message: str, some_additional_info: dict):
# begin to code
Checkout the codebase for more examples and built in decorators!
NOTE:
check_types
has limitations for python versions lower than 3.9 due to lack of built in language support for type-checking. Use with caution with special types and None-Types!
More Examples
Note:
check_types
is only available since release 2.2.0. for previous releases checkoutvalidate_types
If of course also supports multiple types:
from pathlib import Path
@check_types
def foo(path: str | Path, message: str):
# begin to code
Do you want to convert your input-types fast and without clutter?
def from_dict(dict_: dict):
return (dict_.get('bar'), dict_.get('message'), dict_.get('some_additional_info')), {}
@convert_with(from_dict)
def foo(bar: int, message:str, some_additional_info: dict):
...
Skip Type-checks by providing the SkipTypecheck
class as a type, this is very usefull for methods.
from decorator_validation.decorators import validate_types
from decorator_validation.types import SkipTypeCheck
class FileReader:
@validate_types((SkipTypeCheck,), file_path=(str,))
def __init__(self, file_path: str):
...
Of course, sometimes you want to have custom error messages. Then, just use the following code:
from decorator_validation.decorators import validate_with
from pathlib import Path
def my_validation_func(obj, file_path:str) -> True:
if not isinstance(file_path, str):
raise TypeError(...)
if not Path(file_path).resolve().is_file():
raise ValueError(...)
return True
class FileReader:
@validate_with(my_validation_func)
def __init__(self, file_path: str):
...
Map Multiple functions for subtypes
You can also directly map different validation functions to your arguments.
from decorator_validation.decorators import validate_map
from decorator_validation.std_validators import is_file
class FileReader:
@validate_map(None, file_path=is_file)
def __init__(self, file_path: str):
...
Validate Arbitrary Arguments
Starting with version 2.0.0
, the package allows for a single use decorator called validate
.
Depending on the argument, it will either check the type or use a function to validate. If a tuple is used, the standard typecheck will be applied, if not it expectes a Callable that returns a boolean value. All of the examples above can be directly copied and just the name of the decorator has to be changed.
An example.
from decorator_validation.decorators import validate
from decorator_validation.std_validators import is_file
class Logger:
@validate(file_path=is_file, message=(str,))
def log(file_path: str, message:str):
...
Project details
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 decorator_validation-2.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6cd2789a55e8138fd615c14d81cfb63911dbc57678f3e97fbc6974ff68134297 |
|
MD5 | b689e0fe801439982eb9ecc39760a347 |
|
BLAKE2b-256 | f0505c3e673664ae5d0500aa9ff2833db49f581371734f3b2c08fbe10f2969e1 |
Hashes for decorator_validation-2.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f232a86052679d15f7c0a6c51d645e78e1f8c9c37da83fec141bd0920649757c |
|
MD5 | ee3ed8479757e68dcb4131a655ccdfde |
|
BLAKE2b-256 | bfe8a0870781bed37cea1f142ff339baba50d74ae26ae66009eb075f3d9924cf |