create_quality_config

Public callable

Create the default quality policy used during FabricOps checks.

This helper is typically called in 00_env_config to define baseline severity and failure-routing behavior consumed later by quality notebooks. The returned object only stores policy defaults and performs no IO.

Parameters:

Name	Type	Description	Default
default_severity	str	Baseline severity for checks that do not set an explicit level. Supported values are "info", "warning", and "critical".	"warning"
fail_on_critical	bool	Whether critical findings should fail readiness/quality outcomes.	True
quarantine_on_failure	bool	Whether downstream workflows should quarantine failed data when quarantine handling is available.	False

Returns:

Type	Description
QualityConfig	Immutable quality-policy configuration for framework composition.

Raises:

Type	Description
ValueError	Raised when default_severity is not one of the supported values.

Notes

This function validates and normalizes config values only. It does not create Fabric resources, move data, or write to storage.

Examples:

>>> quality = create_quality_config(default_severity="critical", fail_on_critical=True)
>>> quality.default_severity
'critical'

Source code in src/fabricops_kit/config.py

def create_quality_config(
    default_severity: str = "warning",
    fail_on_critical: bool = True,
    quarantine_on_failure: bool = False,
) -> QualityConfig:
    """Create the default quality policy used during FabricOps checks.

    This helper is typically called in ``00_env_config`` to define baseline
    severity and failure-routing behavior consumed later by quality notebooks.
    The returned object only stores policy defaults and performs no IO.

    Parameters
    ----------
    default_severity : str, default="warning"
        Baseline severity for checks that do not set an explicit level.
        Supported values are ``"info"``, ``"warning"``, and ``"critical"``.
    fail_on_critical : bool, default=True
        Whether critical findings should fail readiness/quality outcomes.
    quarantine_on_failure : bool, default=False
        Whether downstream workflows should quarantine failed data when
        quarantine handling is available.

    Returns
    -------
    QualityConfig
        Immutable quality-policy configuration for framework composition.

    Raises
    ------
    ValueError
        Raised when ``default_severity`` is not one of the supported values.

    Notes
    -----
    This function validates and normalizes config values only. It does not
    create Fabric resources, move data, or write to storage.

    Examples
    --------
    >>> quality = create_quality_config(default_severity="critical", fail_on_critical=True)
    >>> quality.default_severity
    'critical'
    """
    severity = str(default_severity).strip().lower()
    if severity not in {"info", "warning", "critical"}:
        raise ValueError("default_severity must be one of: info, warning, critical.")
    return QualityConfig(
        default_severity=severity,
        fail_on_critical=bool(fail_on_critical),
        quarantine_on_failure=bool(quarantine_on_failure),
    )