HasLength

class

class HasLength(
    column_names: ColumnNamesWithAltSpec | None = None,
    min_len: LenSpec = 0,
    max_len: LenSpec = sys.maxsize,
    on_missing_column: OnInvalidColumnSpec = 'ignore',
    on_wrong_type: OnInvalidColumnSpec = 'ignore',
    tags: TagsSpec | None = field(default=None, kw_only=True),
    on_wrong_value: OnInvalidValueSpec = 'ignore',
)

Bases: BoolClassifier

Categories: dq-classifier

A boolean classifier that checks whether a value's length is within a range. Applies to string columns.

Examples

HasLength(["value"], min_len=2, max_len=5)

Parameters

parameter

column_namesColumnNamesWithAltSpec | None (list[str | tuple[str, str | None]] | None)

Columns to classify. Each entry is a column name, or a (column, verdict_column) tuple naming the column the verdict lands in; the two forms can be mixed. None (the default) classifies every user column, skipping the types this classifier does not support (see on_wrong_type). A verdict column that is not named explicitly is the source column plus this classifier's suffix (a column amount lands in amount_has_length).

parameter

min_lenLenSpec (StrictInt)

Minimum length, inclusive; a non-negative whole number (default 0).

parameter

max_lenLenSpec (StrictInt)

Maximum length, inclusive; a non-negative whole number. Must be the same type as min_len and not less than it.

parameter

on_missing_columnOnInvalidColumnSpec (Literal['ignore', 'fail'])

What to do when a named column is not in the table: "ignore" (the default) leaves it out, "fail" aborts the check.

parameter

on_wrong_typeOnInvalidColumnSpec (Literal['ignore', 'fail'])

What to do when a column's data type is not one this classifier supports: "ignore" (the default) leaves it out, "fail" aborts the check.

parameter

tagsTagsSpec | None (list[str] | None)

Optional labels for this classifier. An operator given the same tag applies only to the classifiers carrying it; untagged operators apply to all of them.

parameter

on_wrong_valueOnInvalidValueSpec (Literal['ignore', 'fail'])

Fixed to "ignore": this classifier takes no value to compare against, so there is no wrong value to report.

Methods

method

supported_dtypes

def supported_dtypes() -> frozenset