pathwaycom/pathway · error · ValueError

'{param_name}' must be {constraint}, got {value!r}

Error message

'{param_name}' must be {constraint}, got {value!r}

What it means

Error "'{param_name}' must be {constraint}, got {value!r}" thrown in pathwaycom/pathway.

Source

Thrown at python/pathway/io/_utils.py:129

            for parameters where zero can never be meaningful (e.g. timeouts).

    Returns:
        The duration expressed as a float number of seconds.
    """
    if isinstance(value, datetime.timedelta):
        seconds = value.total_seconds()
    elif isinstance(value, (int, float)) and not isinstance(value, bool):
        seconds = float(value)
    else:
        raise TypeError(
            f"'{param_name}' must be a number of seconds (int or float) or a "
            f"datetime.timedelta, got {type(value).__name__}"
        )
    if not math.isfinite(seconds):
        raise ValueError(f"'{param_name}' must be finite, got {value!r}")
    if seconds < 0 or (seconds == 0 and not allow_zero):
        constraint = "non-negative" if allow_zero else "positive"
        raise ValueError(f"'{param_name}' must be {constraint}, got {value!r}")
    return seconds


class RawDataSchema(pw.Schema):
    data: bytes


class PlaintextDataSchema(pw.Schema):
    data: str


class MetadataSchema(Schema):
    _metadata: dict


def get_data_format_type(format: str, supported_formats: set[str]):
    if format not in _DATA_FORMAT_MAPPING or format not in supported_formats:
        raise ValueError(f"data format `{format}` not supported")

View on GitHub (pinned to fa2f74a464)

Solutions

1. Pass a value that satisfies the stated constraint (e.g. positive, non-negative) for this parameter.

Example fix

pw.io.kafka.read(rdkafka_settings, topic='t', autocommit_duration_ms=1000)

When it happens

Trigger: Thrown at python/pathway/io/_utils.py:129 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of pathwaycom/pathway@fa2f74a464 (2026-08-15). Data as JSON: /api/errors/c181a8202eeb7f76. Report an issue: GitHub.