feat: initial version

Author: joshuanapoli

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: Continuous Integration
+
+on:
+  push:
+    paths:
+      - .github/workflows/ci.yml
+      - poetry.lock
+      - pyproject.toml
+      - src/**
+      - tests/**
+  pull_request:
+    paths:
+      - .github/workflows/ci.yml
+      - poetry.lock
+      - pyproject.toml
+      - src/**
+      - tests/**
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - uses: CVector-Energy/python-test@main
+        with:
+          python-version: ${{ matrix.python-version }}
+          src-dirs: .

CLAUDE.md

@@ -0,0 +1 @@
+- Name files for their main export, transforming Python names from PascalCase to underscore_case. For example, the file that defines the CollectEditedFilesHook class should be named collect_edited_files.py.

README.md

@@ -0,0 +1,71 @@
+# python-claude
+
+Python hooks for Claude Code.
+
+## Installation
+
+```bash
+poetry add python-claude
+```
+
+## Usage
+
+This package provides hooks that can be used with Claude Code's hook system.
+
+### Available Commands
+
+- `edited` - Tracks edited Python files for deferred processing
+- `git status` - Shows git status
+- `mypy` - Runs mypy type checking on edited files
+- `pytest` - Runs pytest
+- `ruff check` - Runs ruff check on collected files with auto-fix
+- `ruff format` - Runs ruff format on edited files
+
+### Claude Code Settings
+
+Add hooks to your Claude Code settings.json:
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "poetry run python-claude ruff format"
+          },
+          {
+            "type": "command",
+            "command": "poetry run python-claude edited"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "poetry run python-claude ruff check"
+          },
+          {
+            "type": "command",
+            "command": "poetry run python-claude pytest"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Development
+
+```bash
+poetry install
+poetry run pytest
+poetry run ruff check
+poetry run mypy src
+```

poetry.lock

@@ -0,0 +1,26 @@
+[project]
+name = "python-claude"
+version = "0.1.0"
+description = "Python hooks for Claude Code"
+authors = [{name = "CVector", email = "support@cvector.com"}]
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = []
+
+[project.scripts]
+python-claude = "python_claude.cli:main"
+
+[tool.poetry]
+packages = [{ include = "python_claude", from = "src" }]
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.3.5"
+mypy = "^1.15.0"
+ruff = "^0.11.10"
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.mypy]
+strict = true

pyproject.toml

@@ -0,0 +1,3 @@
+"""Python hooks for Claude Code."""
+
+__version__ = "0.1.0"

src/python_claude/__init__.py

@@ -0,0 +1,58 @@
+"""Command-line interface for python-claude hooks."""
+
+import sys
+
+from python_claude.hooks import (
+    CollectEditedFilesHook,
+    GitStatusHook,
+    MypyHook,
+    PytestHook,
+    RuffCheckHook,
+    RuffFormatHook,
+)
+from python_claude.hooks.base import Hook
+
+HOOKS: dict[str, type[Hook]] = {
+    "edited": CollectEditedFilesHook,
+    "git status": GitStatusHook,
+    "mypy": MypyHook,
+    "pytest": PytestHook,
+    "ruff check": RuffCheckHook,
+    "ruff format": RuffFormatHook,
+}
+
+
+def _print_available_hooks() -> None:
+    """Print available hooks to stderr."""
+    hooks = ", ".join(sorted(HOOKS.keys()))
+    print(f"Available hooks: {hooks}", file=sys.stderr)
+
+
+def main() -> None:
+    """Main entry point for the CLI."""
+    if len(sys.argv) < 2:
+        print("Usage: python-claude <command>", file=sys.stderr)
+        _print_available_hooks()
+        sys.exit(1)
+
+    # Try two-word command first, then single word
+    if len(sys.argv) >= 3:
+        hook_name = f"{sys.argv[1]} {sys.argv[2]}"
+        if hook_name not in HOOKS:
+            hook_name = sys.argv[1]
+    else:
+        hook_name = sys.argv[1]
+
+    if hook_name not in HOOKS:
+        print(f"Unknown command: {hook_name}", file=sys.stderr)
+        _print_available_hooks()
+        sys.exit(1)
+
+    hook_class = HOOKS[hook_name]
+    hook = hook_class()
+    exit_code = hook.run()
+    sys.exit(exit_code)
+
+
+if __name__ == "__main__":
+    main()

src/python_claude/__pycache__/__init__.cpython-313.pyc

@@ -0,0 +1,17 @@
+"""Claude Code hook implementations."""
+
+from python_claude.hooks.collect_edited_files import CollectEditedFilesHook
+from python_claude.hooks.git_status import GitStatusHook
+from python_claude.hooks.mypy import MypyHook
+from python_claude.hooks.pytest import PytestHook
+from python_claude.hooks.ruff_check import RuffCheckHook
+from python_claude.hooks.ruff_format import RuffFormatHook
+
+__all__ = [
+    "CollectEditedFilesHook",
+    "GitStatusHook",
+    "MypyHook",
+    "PytestHook",
+    "RuffCheckHook",
+    "RuffFormatHook",
+]