lint

.pre-commit-config.yaml

@@ -0,0 +1,12 @@
+repos:
+  - repo: local
+    hooks:
+      - id: lintrunner
+        name: Run Lintrunner in an isolated venv before every push. The first run may be slow...
+        entry: python scripts/run_lintrunner.py   # wrapper below
+        language: python                          # pre‑commit manages venv for the wrapper
+        additional_dependencies: []               # wrapper handles lintrunner install
+        always_run: true
+        stages: [pre-push]                        # fire only on pre‑push
+        pass_filenames: false                     # Lintrunner gets no per‑file args
+        verbose: true                             # stream output as it is produced...allegedly anyways

scripts/run_lintrunner.py

@@ -0,0 +1,91 @@
+#!/usr/bin/env python3
+"""
+Pre‑push hook wrapper for Lintrunner.
+
+✓ Installs Lintrunner once (`pip install lintrunner`) if missing
+✓ Stores a hash of .lintrunner.toml in the venv
+✓ Re-runs `lintrunner init` if that file's hash changes
+✓ Pure Python – works on macOS, Linux, and Windows
+"""
+
+from __future__ import annotations
+
+import hashlib
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+TOML_PATH = REPO_ROOT / ".lintrunner.toml"
+
+# This is the path to the pre-commit-managed venv
+VENV_ROOT = Path(sys.executable).parent.parent
+MARKER_PATH = VENV_ROOT / ".lintrunner_plugins_hash"
+
+
+def ensure_lintrunner() -> None:
+    """Fail if Lintrunner is not on PATH."""
+    if shutil.which("lintrunner"):
+        print("✅ lintrunner is already installed")
+        return
+    sys.exit(
+        "❌ lintrunner is required but was not found on your PATH. Please run the `python scripts/setup_hooks.py` to install to configure lintrunner before using this script."
+    )
+
+
+def compute_file_hash(path: Path) -> str:
+    """Returns SHA256 hash of a file's contents."""
+    hasher = hashlib.sha256()
+    with path.open("rb") as f:
+        while chunk := f.read(8192):
+            hasher.update(chunk)
+    return hasher.hexdigest()
+
+
+def read_stored_hash(path: Path) -> str | None:
+    if not path.exists():
+        return None
+    try:
+        return path.read_text().strip()
+    except Exception:
+        return None
+
+
+def maybe_initialize_lintrunner() -> None:
+    """Runs lintrunner init if .lintrunner.toml changed since last run."""
+    if not TOML_PATH.exists():
+        print("⚠️ No .lintrunner.toml found. Skipping init.")
+        return
+
+    current_hash = compute_file_hash(TOML_PATH)
+    stored_hash = read_stored_hash(MARKER_PATH)
+
+    if current_hash == stored_hash:
+        print("✅ Lintrunner plugins already initialized and up to date.")
+        return
+
+    print("🔁 Running `lintrunner init` …", file=sys.stderr)
+    subprocess.check_call(["lintrunner", "init"])
+    MARKER_PATH.write_text(current_hash)
+
+
+def main() -> None:
+    print(f"🐍 Lintrunner is using Python: {sys.executable}", file=sys.stderr)
+
+    # 1. Ensure lintrunner binary is available
+    ensure_lintrunner()
+
+    # 2. Check for plugin updates and re-init if needed
+    maybe_initialize_lintrunner()
+
+    # 3. Run lintrunner with any passed arguments and propagate its exit code
+    args = sys.argv[1:]  # Forward all arguments to lintrunner
+    result = subprocess.call(["lintrunner"] + args)
+    sys.exit(result)
+
+
+if __name__ == "__main__":
+    main()

scripts/setup_hooks.py

@@ -0,0 +1,117 @@
+#!/usr/bin/env python3
+"""
+Bootstrap Git pre‑push hook.
+
+✓ Installs pipx automatically (via Homebrew on macOS)
+✓ Installs/updates pre‑commit with pipx  (global, venv‑proof)
+✓ Registers the repo's pre‑push hook and freezes hook versions
+
+Run this from the repo root (inside or outside any project venv):
+
+    python scripts/setup_hooks.py
+"""
+
+from __future__ import annotations
+
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+
+# ───────────────────────────────────────────
+# Helper utilities
+# ───────────────────────────────────────────
+def run(cmd: list[str]) -> None:
+    print(f"$ {' '.join(cmd)}")
+    subprocess.check_call(cmd)
+
+
+def which(cmd: str) -> bool:
+    return shutil.which(cmd) is not None
+
+
+# ───────────────────────────────────────────
+# 1. Ensure pipx exists (install via brew on macOS)
+# ───────────────────────────────────────────
+def ensure_pipx() -> None:
+    if which("pipx"):
+        return
+    # If we're on a mac
+    if sys.platform == "darwin":
+        # Try Homebrew installation
+        if which("brew"):
+            print("pipx not found – installing with Homebrew …")
+            run(["brew", "install", "pipx"])
+            run(["pipx", "ensurepath"])
+        else:
+            sys.exit(
+                "\n❌  pipx is required but neither pipx nor Homebrew were found.\n"
+                "    Please install Homebrew (https://brew.sh) or pipx manually:\n"
+                "    https://pipx.pypa.io/stable/installation/\n"
+            )
+    else:
+        # Non‑macOS: ask user to install pipx manually
+        sys.exit(
+            "\n❌  pipx is required but was not found on your PATH.\n"
+            "    Install pipx first (https://pipx.pypa.io/stable/installation/),\n"
+            "    then rerun  python scripts/setup_hooks.py\n"
+        )
+    if not which("pipx"):
+        sys.exit(
+            "\n❌  pipx installation appeared to succeed, but it's still not on PATH.\n"
+            "    Restart your terminal or add pipx's bin directory to PATH and retry.\n"
+        )
+
+
+def ensure_tool_installed(tool: str, force_update: bool = False) -> None:
+    if force_update or not which(tool):
+        print(f"Ensuring latest {tool} via pipx …")
+        run(["pipx", "install", "--quiet", "--force", tool])
+        if not which(tool):
+            sys.exit(
+                f"\n❌  {tool} installation appeared to succeed, but it's still not on PATH.\n"
+                "    Restart your terminal or add pipx's bin directory to PATH and retry.\n"
+            )
+
+
+ensure_pipx()
+
+# Ensure the path pipx installs binaries to is part of the system path.
+# Modifies the shell's configuration files (like ~/.bashrc, ~/.zshrc, etc.)
+#  to include the directory where pipx installs executables in your PATH
+#  variable.
+run(["pipx", "ensurepath"])
+
+# Ensure pre-commit is installed globally via pipx
+ensure_tool_installed("pre-commit", force_update=True)
+# Don't force a lintrunner update because it might break folks
+# who already have it installed in a different way
+ensure_tool_installed("lintrunner")
+
+# ───────────────────────────────────────────
+# 3. Activate (or refresh) the pre‑push hook
+# ───────────────────────────────────────────
+# ── Activate (or refresh) the repo’s pre‑push hook ──────────────────────────
+# Creates/overwrites .git/hooks/pre‑push with a tiny shim that will call
+# `pre-commit run --hook-stage pre-push` on every `git push`.
+# This is why we need to install pre-commit globally.
+#
+# The --allow-missing-config flag lets pre-commit succeed if someone changes to
+# a branch that doesn't have pre-commit installed
+run(["pre-commit", "install", "--hook-type", "pre-push", "--allow-missing-config"])
+
+# ── Pin remote‑hook versions for reproducibility ────────────────────────────
+# 1. `autoupdate` bumps every remote hook’s `rev:` in .pre-commit-config.yaml
+#    to the latest commit on its default branch.
+#    (Note: we don't have remote hooks right now, but this future-proofs
+#    this script)
+# 2. `--freeze` immediately rewrites each `rev:` to the exact commit SHA,
+#    ensuring all contributors and CI run identical hook code.
+run(["pre-commit", "autoupdate", "--freeze"])
+
+
+print(
+    "\n✅  pre‑commit is installed globally via pipx and the pre‑push hook is active.\n"
+    "   Lintrunner will now run automatically on every `git push`.\n"
+)

scripts/test_camyll.py

@@ -0,0 +1,5 @@
+#!/usr/bin/env python3
+
+
+def main():
+    print("hello world")