A function decorator that is using the inspect library to validate arguments passed in the decorated function.
It allows writing complex and re-usable argument validation rules injected directly in the function signature.
The validation is not based on type annotations, which allows to go beyond the basic type validations.
NOTE: pydantic is a far more advanced and very well supported library, but requires to model your arguments. If you haven't already, make sure you check it out.
Source Code: https://github.com/kolitiri/validargs
PyPI: https://pypi.org/project/validargs/
Python 3.8+
pip install validargsFor best results, use the argument definitions syntax as of python v3.8.
Use "/" and "*" to distinguish between "positional only", "positional or keyword" and "keyword only" arguments.
Define custom validation rules using the Validator class.
""" my_app.py """
from typing import Any
from validargs import validated, Validator
def positive_number(argument: int) -> None:
if argument is None:
return None
if type(argument) is not int:
raise TypeError("Number must be an integer")
if argument <= 0:
raise Exception("Number must be a positive integer")
def short_str(argument: str) -> None:
if argument is None:
return None
if len(argument) > 20:
raise Exception("String too long")Use the validated decorator to decorate the functions that you want validated.
@validated
def my_function(
positive_number: int = Validator(positive_number),
/,
short_string: str = Validator(short_str),
*,
another_short_string: str = Validator(short_str),
):
passYou can mix and match arguments with and without validators and also assign default values.
@validated
def my_function(
positive_number: int = Validator(positive_number, default_value=10), # Validator with default value
non_validated_arg: int = 0, # Regular argument with default value
/,
short_string: str = Validator(short_str), # Validator without default value
*,
another_validated_argument: str, # Regular argument without default value
):
passIf you want to contribute to the package, please have a look at the CONTRIBUTING.md file for some basic instructions. Feel free to reach me in my email or my twitter account, which you can find in my github profile!
This project is licensed under the terms of the MIT license.
Christos Liontos