chore: add pre-commit config, ADR index guard and fast test subset

Author: Arturo R Montesinos

.pre-commit-config.yaml

@@ -0,0 +1,39 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-added-large-files
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.5.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+  - repo: local
+    hooks:
+      - id: import-smoke
+        name: Import smoke (ods2sql)
+        entry: python -c "import ods2sql; print('import ok')"
+        language: system
+        pass_filenames: false
+        stages: [commit]
+      - id: adr-index-sync
+        name: ADR index includes newest ADR file
+        entry: python scripts/check_adr_index.py
+        language: system
+        pass_filenames: false
+        stages: [commit]
+      - id: no-debug-prints
+        name: Disallow debug print in src
+        entry: bash -c "! grep -R 'print(' src/ods2sql.py || (echo 'Remove debug print statements before committing.' >&2; exit 1)"
+        language: system
+        pass_filenames: false
+        stages: [commit]
+      - id: run-selected-tests
+        name: Fast sanity tests
+        entry: bash scripts/fast_tests.sh
+        language: system
+        pass_filenames: false
+        stages: [push]

requirements-dev.txt

@@ -1,3 +1,4 @@
 pytest>=7.0
 ruff>=0.4.0
 mypy>=1.8.0
+pre-commit>=3.7.0

scripts/check_adr_index.py

@@ -0,0 +1,37 @@
+#!/usr/bin/env python3
+"""Ensure docs/adr/README.md index lists the highest-numbered ADR present.
+
+Policy: every ADR file 000N-*.md must appear as a line in the index.
+Exit 1 if mismatch so pre-commit blocks.
+"""
+from __future__ import annotations
+import re
+from pathlib import Path
+import sys
+
+ADR_DIR = Path('docs/adr')
+INDEX_FILE = ADR_DIR / 'README.md'
+
+rx = re.compile(r'^(\d{4})-([a-z0-9-]+)\.md$')
+
+missing: list[str] = []
+try:
+    index_text = INDEX_FILE.read_text(encoding='utf-8')
+except FileNotFoundError:
+    print('ADR index missing', file=sys.stderr)
+    sys.exit(1)
+
+for p in sorted(ADR_DIR.glob('*.md')):
+    if p.name in {'README.md', 'TEMPLATE.md'}:
+        continue
+    if not rx.match(p.name):
+        print(f'Bad ADR filename: {p.name}', file=sys.stderr)
+        sys.exit(1)
+    if p.name not in index_text:
+        missing.append(p.name)
+
+if missing:
+    print('ADR index missing entries for: ' + ', '.join(missing), file=sys.stderr)
+    sys.exit(1)
+
+sys.exit(0)

scripts/fast_tests.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# Minimal fast test subset for pre-push hook.
+pytest -q tests/test_parser_edges.py::test_aliases tests/test_dialects.py::test_index_name_truncation