| Server IP : 185.124.137.11 / Your IP : 216.73.217.26 Web Server : LiteSpeed System : Linux id-dci-web1986.main-hosting.eu 5.14.0-611.26.1.el9_7.x86_64 #1 SMP PREEMPT_DYNAMIC Thu Jan 29 05:24:47 EST 2026 x86_64 User : u686484674 ( 686484674) PHP Version : 8.0.30 Disable Function : system, exec, shell_exec, passthru, mysql_list_dbs, ini_alter, dl, symlink, link, chgrp, leak, popen, apache_child_terminate, virtual, mb_send_mail MySQL : OFF | cURL : ON | WGET : ON | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : /opt/alt/python311/lib/python3.11/site-packages/validators/ |
Upload File : |
"""Utils."""
# standard
from functools import wraps
from inspect import getfullargspec
from itertools import chain
from os import environ
from typing import Any, Callable, Dict
class ValidationError(Exception):
"""Exception class when validation failure occurs."""
def __init__(self, function: Callable[..., Any], arg_dict: Dict[str, Any], message: str = ""):
"""Initialize Validation Failure."""
if message:
self.reason = message
self.func = function
self.__dict__.update(arg_dict)
def __repr__(self):
"""Repr Validation Failure."""
return (
f"ValidationError(func={self.func.__name__}, "
+ f"args={ ({k: v for (k, v) in self.__dict__.items() if k != 'func'}) })"
)
def __str__(self):
"""Str Validation Failure."""
return repr(self)
def __bool__(self):
"""Bool Validation Failure."""
return False
def _func_args_as_dict(func: Callable[..., Any], *args: Any, **kwargs: Any):
"""Return function's positional and key value arguments as an ordered dictionary."""
return dict(
list(zip(dict.fromkeys(chain(getfullargspec(func)[0], kwargs.keys())), args))
+ list(kwargs.items())
)
def validator(func: Callable[..., Any]):
"""A decorator that makes given function validator.
Whenever the given `func` returns `False` this
decorator returns `ValidationError` object.
Examples:
>>> @validator
... def even(value):
... return not (value % 2)
>>> even(4)
True
>>> even(5)
ValidationError(func=even, args={'value': 5})
Args:
func:
Function which is to be decorated.
Returns:
(Callable[..., ValidationError | Literal[True]]):
A decorator which returns either `ValidationError`
or `Literal[True]`.
Raises:
(ValidationError): If `r_ve` or `RAISE_VALIDATION_ERROR` is `True`
"""
@wraps(func)
def wrapper(*args: Any, **kwargs: Any):
raise_validation_error = False
if "r_ve" in kwargs:
raise_validation_error = True
del kwargs["r_ve"]
if environ.get("RAISE_VALIDATION_ERROR", "False") == "True":
raise_validation_error = True
try:
if raise_validation_error:
if func(*args, **kwargs):
return True
else:
raise ValidationError(func, _func_args_as_dict(func, *args, **kwargs))
else:
return (
True
if func(*args, **kwargs)
else ValidationError(func, _func_args_as_dict(func, *args, **kwargs))
)
except (ValueError, TypeError, UnicodeError) as exp:
if raise_validation_error:
raise ValidationError(
func, _func_args_as_dict(func, *args, **kwargs), str(exp)
) from exp
else:
return ValidationError(func, _func_args_as_dict(func, *args, **kwargs), str(exp))
return wrapper