Skip to content

Form Validators

validators

validate_percent_decimal(value)

Validate that a value is between 0 and 1 (inclusive).

Use for percentage fields stored as decimals (e.g. 0.75 = 75%).

Parameters:

Name Type Description Default
value

Numeric value to validate.

required

Raises:

Type Description
ValidationError

If value is outside the 0-1 range.

validate_percent(value)

Validate that a value is between 0 and 100 (inclusive).

Use for percentage fields stored as whole numbers (e.g. 75 = 75%).

Parameters:

Name Type Description Default
value

Numeric value to validate.

required

Raises:

Type Description
ValidationError

If value is outside the 0-100 range.

validate_greater_than_zero(value)

Validate that a value is strictly greater than zero.

Parameters:

Name Type Description Default
value

Numeric value to validate. Empty strings are allowed.

required

Raises:

Type Description
ValidationError

If value is zero or negative.

validate_path_chars(value)

Validate that a string contains only URL-safe path characters.

Allows letters, digits, underscores, and hyphens only.

Parameters:

Name Type Description Default
value

String value to validate.

required

Raises:

Type Description
ValidationError

If value contains characters other than [A-Za-z0-9_-].

validate_non_negative(value)

Validate that a value is zero or positive.

Parameters:

Name Type Description Default
value

Numeric value to validate. Empty strings are allowed.

required

Raises:

Type Description
ValidationError

If value is negative.