Skip to main content
Version: 1.9.1

HasLength

class HasLength(
column_names: str | tuple[str, str | None] | Annotated[list[str], <class 'Strict'>] | Annotated[list[tuple[str, str | None]], <class 'Strict'>] | NoneType = None,
min_len: Annotated[int, Strict(strict=True), FieldInfo(annotation=NoneType, required=True, metadata=[Ge(ge=0)])] = 0,
max_len: Annotated[int, Strict(strict=True), FieldInfo(annotation=NoneType, required=True, metadata=[Ge(ge=0)])] = 9223372036854775807,
on_missing_column: Literal['ignore', 'fail'] = 'ignore',
on_wrong_type: Literal['ignore', 'fail'] = 'ignore',
tags: str | list[str] | NoneType = None,
)

Bases: BoolClassifier

Categories: dq-classifier

A boolean classifier that checks if the length of a value is within a given range.

Initializes the HasLength classifier.

Parameters

parameter
column_names

The column(s) to check.

parameter
min_len

The minimum allowed length (inclusive).

parameter
max_len

The maximum allowed length (inclusive).

parameter
on_missing_column

What to do if a column name is missing.

parameter
on_wrong_type

Behavior when a column’s type is incompatible with the classifier.

parameter
tags

Optional tags for the classifier.

Properties

property
column_nameslist[tuple[str, str | None]] | None

Returns the list of columns the classifier applies to, including optional destination column names.

property
maxint

Returns the maximum allowed length.

property
minint

Returns the minimum allowed length.

property
on_missing_columnLiteral['ignore', 'fail']

Returns what do if the column is missing.

property
on_wrong_typeLiteral['ignore', 'fail']

Returns what do if the column type is incompatible with the classifier.

property
on_wrong_valueLiteral['ignore', 'fail']

Returns what do if the column type is incompatible with the classifier.

property
tagslist[str] | None

Returns the list of tags associated with the classifier.

Methods

supported_dtypes
def supported_dtypes() -> FrozenSet[Type]

Returns the set of data types supported by HasLength classifier.