pyvalidYR 0.1.0

A lightweight Python validation library for checking data before using it.

PyValidX

PyValidX is a small Python validation library that helps developers check data before using it.

It is useful for form input, API request bodies, configuration files, and any place where incoming data should follow clear rules.

Installation

pip install pyvalidx

Quick Start

from pyvalidx import validate

validate("[e-mail]", ["required", "email"])
validate("secure-password", ["required", "min:8"])
validate(25, ["required", "between:18,100"])

If the value is invalid, PyValidX raises a ValidationError.

from pyvalidx import ValidationError, validate

try:
    validate("", ["required"])
except ValidationError as error:
    print(error)

Available Rules

Rule	Example	Meaning
required	required	Value cannot be empty
email	email	Value must look like an email address
min	min:8	Value length or number must be at least 8
max	max:100	Value length or number must be at most 100
between	between:18,100	Number must be between 18 and 100
regex	regex:^[A-Z]+$	Value must match a regular expression
in	in:admin,user	Value must be one of the allowed options

Validate Dictionaries

from pyvalidx import validate_data

rules = {
    "name": ["required", "min:2"],
    "email": ["required", "email"],
    "age": ["required", "between:18,100"],
}

validate_data(
    {"name": "Jane", "email": "[e-mail]", "age": 30},
    rules,
)

Custom Validators

from pyvalidx import validate

def starts_with_a(value):
    return str(value).startswith("A")

validate("Alice", [starts_with_a])

Custom validators can return:

• True for valid
• False for invalid
• A string error message for invalid

Development

python -m pip install -e . pytest build twine
python -m pytest
python -m build
python -m twine check dist/*

Publish to PyPI

First test with TestPyPI:

python -m twine upload --repository testpypi dist/*

Then upload to PyPI:

python -m twine upload dist/*