build_quality_result_records

Public callable

Convert quality-rule execution output into metadata evidence records.

Parameters:

Name	Type	Description	Default
quality_result	Any	Value used by this callable.	required

Returns:

Type	Description
list[dict]	Structured output produced by this callable.

Source code in src/fabricops_kit/metadata.py

def build_quality_result_records(
    quality_result: dict | list[dict],
    *,
    run_id: str,
    dataset_name: str,
    table_name: str,
    table_stage: str,
) -> list[dict]:
    """Convert quality-rule execution output into metadata evidence records.

        Parameters
        ----------
        quality_result : Any
            Value used by this callable.

        Returns
        -------
        list[dict]
            Structured output produced by this callable.
    """
    results: list[dict[str, Any]]
    if isinstance(quality_result, dict):
        results = list(quality_result.get("results", []))
    else:
        results = list(quality_result)

    rows = []
    for result in results:
        rows.append(
            to_jsonable(
                {
                    "run_id": run_id,
                    "dataset_name": dataset_name,
                    "table_name": table_name,
                    "table_stage": table_stage,
                    "rule_id": result.get("rule_id"),
                    "rule_type": result.get("rule_type"),
                    "column_name": result.get("column_name"),
                    "columns": to_jsonable(result.get("columns")),
                    "severity": result.get("severity"),
                    "status": result.get("status"),
                    "failed_count": result.get("failed_count"),
                    "total_count": result.get("total_count"),
                    "failed_pct": result.get("failed_pct"),
                    "message": result.get("message"),
                }
            )
        )
    return rows