runner
sqllocks_spindle.verify.runner
¶
VerifyRunner — orchestrates validation gates and produces a VerifyResult.
Classes¶
VerifyRunner
¶
Run a curated set of validation gates against synthetic data tables.
Without a schema: only records row counts (nothing to validate against). With a schema: adds schema conformance, null constraint, PK uniqueness, and FK checks. With statistical=True: also runs distribution gate (requires scipy).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
schema
|
SpindleSchema | None
|
Parsed SpindleSchema for validation. Optional. |
None
|
statistical
|
bool
|
Include distribution drift checks (KS test / chi-squared). |
False
|
data_path
|
str
|
Original data path (for reporting). Optional. |
''
|
schema_path
|
str | None
|
Original schema path (for reporting). Optional. |
None
|
Methods:¶
run(tables)
¶
Run gates against tables and return a VerifyResult.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
tables
|
dict[str, DataFrame]
|
Dict mapping table name to DataFrame. |
required |
Returns:
| Type | Description |
|---|---|
VerifyResult
|
VerifyResult with gate outcomes, row counts, and metadata. |