haive.core.schema.compatibility.validators¶

Field and model validation framework with async support.

Classes¶

`CommonValidators`	Collection of common validators.
`FieldValidator`	Validator for individual fields.
`ModelValidator`	Validator for entire models/schemas.
`ValidationContext`	Context passed through validation chain.
`Validator`	Base validator class.
`ValidatorBuilder`	Builder for creating validators.
`ValidatorChain`	Chain multiple validators together.

Functions¶

create_validator(schema_info[, custom_validators])

Create a model validator from schema info.

Module Contents¶

class haive.core.schema.compatibility.validators.CommonValidators[source]¶

Collection of common validators.

static is_email(value)[source]¶

Basic email validation.

Parameters:: value (str)
Return type:: bool

static is_url(value)[source]¶

Basic URL validation.

Parameters:: value (str)
Return type:: bool

static is_uuid(value)[source]¶

UUID validation.

Parameters:: value (str)
Return type:: bool

static not_empty(value)[source]¶

Check value is not empty.

Parameters:: value (Any)
Return type:: bool

class haive.core.schema.compatibility.validators.FieldValidator(field_name, validators=None, error_messages=None)[source]¶

Bases: Validator

Validator for individual fields.

Init .

Parameters:

field_name (str) – [TODO: Add description]
validators (list[collections.abc.Callable[[Any], bool]] | None) – [TODO: Add description]
error_messages (dict[str, str] | None) – [TODO: Add description]

add_validator(validator, error_message=None)[source]¶

Add a validator function.

Parameters:

validator (collections.abc.Callable[[Any], bool])
error_message (str | None)

Return type:

None

validate(value, context)[source]¶

Validate field value.

Parameters:

value (Any)
context (ValidationContext)

Return type:

haive.core.schema.compatibility.types.ValidationResult

class haive.core.schema.compatibility.validators.ModelValidator(schema_info=None, field_validators=None, cross_field_validators=None)[source]¶

Bases: Validator

Validator for entire models/schemas.

Init .

Parameters:

schema_info (haive.core.schema.compatibility.types.SchemaInfo | None) – [TODO: Add description]
field_validators (dict[str, FieldValidator] | None) – [TODO: Add description]
cross_field_validators (list[collections.abc.Callable] | None) – [TODO: Add description]

add_cross_field_validator(validator)[source]¶

Add a cross-field validator.

Parameters:: validator (collections.abc.Callable)
Return type:: None

add_field_validator(field_name, validator)[source]¶

Add a field validator.

Parameters:

field_name (str)
validator (FieldValidator)

Return type:

None

validate(value, context)[source]¶

Validate entire model.

Parameters:

value (Any)
context (ValidationContext)

Return type:

haive.core.schema.compatibility.types.ValidationResult

class haive.core.schema.compatibility.validators.ValidationContext(/, **data)[source]¶

Bases: pydantic.BaseModel

Context passed through validation chain.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

Parameters:: data (Any)

class Config[source]¶: Pydantic config.

pop_path()[source]¶

Pop a path segment.

Return type:: str | None

push_path(segment)[source]¶

Push a path segment.

Parameters:: segment (str)
Return type:: None

property current_path_str: str¶

Get current path as string.

Return type:: str

class haive.core.schema.compatibility.validators.Validator[source]¶

Bases: abc.ABC

Base validator class.

async avalidate(value, context)[source]¶

Async validation (optional).

Parameters:

value (Any)
context (ValidationContext)

Return type:

haive.core.schema.compatibility.types.ValidationResult

abstractmethod validate(value, context)[source]¶

Validate a value.

Parameters:

value (Any)
context (ValidationContext)

Return type:

haive.core.schema.compatibility.types.ValidationResult

property supports_async: bool¶

Whether this validator supports async validation.

Return type:: bool

class haive.core.schema.compatibility.validators.ValidatorBuilder[source]¶

Builder for creating validators.

static combine(*validators)[source]¶

Combine multiple validators into a chain.

Parameters:: validators (Validator)
Return type:: ValidatorChain

static for_length(min_length=None, max_length=None, field_name='value')[source]¶

Create length validator.

Parameters:

min_length (int | None)
max_length (int | None)
field_name (str)

Return type:

FieldValidator

static for_pattern(pattern, field_name='value')[source]¶

Create regex pattern validator.

Parameters:

pattern (str)
field_name (str)

Return type:

FieldValidator

static for_range(min_value=None, max_value=None, field_name='value')[source]¶

Create range validator.

Parameters:

min_value (float | None)
max_value (float | None)
field_name (str)

Return type:

FieldValidator

static for_type(type_hint)[source]¶

Create validator for a specific type.

Parameters:: type_hint (type)
Return type:: FieldValidator

class haive.core.schema.compatibility.validators.ValidatorChain[source]¶

Chain multiple validators together.

async avalidate(value, context=None)[source]¶

Async validation of chain.

Parameters:

value (Any)
context (ValidationContext | None)

Return type:

haive.core.schema.compatibility.types.ValidationResult

validate(value, context=None)[source]¶

Run all validators in chain.

Parameters:

value (Any)
context (ValidationContext | None)

Return type:

haive.core.schema.compatibility.types.ValidationResult

haive.core.schema.compatibility.validators.create_validator(schema_info, custom_validators=None)[source]¶

Create a model validator from schema info.

Parameters:

schema_info (haive.core.schema.compatibility.types.SchemaInfo)
custom_validators (dict[str, list[collections.abc.Callable]] | None)

Return type:

ModelValidator