mirror of
https://github.com/kuhyx/testsAndMisc.git
synced 2026-07-04 18:23:07 +02:00
Krzysztof kuhy Rudnicki
038e08d2be
Split diet_guard/_gatelock.py, wake_alarm/_alarm.py, and the usage_report.py/_usage_report_parsing.py pair into focused sub-modules so every Python file is <= 500 lines, satisfying test_file_length.py. Install python-kasa into .venv (declared in requirements but missing after the 3.13->3.14 venv upgrade), fixing 8 failing smart_plug tests and restoring 100% coverage. Also includes prior in-progress work from the working tree: the wake_alarm Progress/View/Hardware field-grouping refactor, brother_printer query module + tests, diet_guard foodbank/state/cli updates, new shared coerce/logging_setup helpers, morning_routine orchestrator tweaks, dwm window-manager config, gaming scripts, and misc maintenance/digital-wellbeing script updates. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
80 lines
2.3 KiB
Python
Executable File
80 lines
2.3 KiB
Python
Executable File
#!/usr/bin/env python3
|
|
"""Validate a workflow-contract artifact against the required schema.
|
|
|
|
Used by the ``check_agent_contract.sh`` pre-commit hook: given one contract JSON
|
|
path as ``argv[1]``, it prints ``<path>: contract schema OK`` and exits 0 when the
|
|
file is valid, or writes each problem to stderr and exits 1 otherwise.
|
|
|
|
Kept as a standalone module (not inline ``python <<PY`` in the shell hook) so the
|
|
repository's Python tooling applies; see CLAUDE.md "Shell Style".
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import sys
|
|
from typing import TYPE_CHECKING
|
|
|
|
from _schema_validation import (
|
|
check_string_lists,
|
|
is_nonempty_str,
|
|
load_and_check_required,
|
|
run_cli,
|
|
)
|
|
|
|
if TYPE_CHECKING:
|
|
from pathlib import Path
|
|
|
|
# Top-level keys every contract must define.
|
|
_REQUIRED_KEYS = (
|
|
"title",
|
|
"objective",
|
|
"acceptance_criteria",
|
|
"out_of_scope",
|
|
"verifier",
|
|
)
|
|
# Keys whose value must be a non-empty string.
|
|
_STRING_KEYS = ("title", "objective", "verifier")
|
|
# Keys whose value must be a non-empty list of non-empty strings.
|
|
_STRING_LIST_KEYS = ("acceptance_criteria", "out_of_scope")
|
|
|
|
|
|
def _check_required_keys(data: dict[str, object]) -> list[str]:
|
|
"""Report any required top-level keys that are absent."""
|
|
missing = [key for key in _REQUIRED_KEYS if key not in data]
|
|
if missing:
|
|
return [f"missing required fields: {', '.join(missing)}"]
|
|
return []
|
|
|
|
|
|
def _check_strings(data: dict[str, object]) -> list[str]:
|
|
"""Each scalar field must be a non-empty string."""
|
|
return [
|
|
f"{key} must be non-empty string"
|
|
for key in _STRING_KEYS
|
|
if not is_nonempty_str(data.get(key))
|
|
]
|
|
|
|
|
|
def validate(path: Path) -> list[str]:
|
|
"""Return a list of schema problems for ``path`` (empty when it is valid)."""
|
|
data, _text, errors = load_and_check_required(path, _check_required_keys)
|
|
if data is None:
|
|
return errors
|
|
errors += _check_strings(data)
|
|
errors += check_string_lists(data, _STRING_LIST_KEYS, "items")
|
|
return errors
|
|
|
|
|
|
def main() -> int:
|
|
"""Validate the contract named by ``argv[1]``; return a process exit code."""
|
|
return run_cli(
|
|
sys.argv[1:],
|
|
usage="usage: validate_contract.py <contract.json>",
|
|
validate=validate,
|
|
success_message="contract schema OK",
|
|
)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
sys.exit(main())
|