python-claude 0.3.1

Python hooks for Claude Code

python-claude

Python hooks for Claude Code for projects using:

• poetry
• ruff
• mypy
• pytest

The hooks ensure that the quality tools are automatically used:

Each time a file is edited:

• Record the file for later processing

When Claude is ready to stop:

• Reformat edited files with ruff format
• Repair lints of edited files with ruff check --fix
• Type-check edited files with mypy
• Run the tests with pytest

Note: We defer ruff format and ruff check until Claude stops to avoid changing files while Claude is working. Changing files during editing would spoil Claude's edits and force it to reread files.

Installation

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 (used in PostToolUse hook)
• git status - Shows git status
• mypy - Runs mypy type checking on edited files (used in Stop hook)
• pytest - Runs pytest
• ruff check - Runs ruff check on collected files with auto-fix (used in Stop hook)
• ruff format - Runs ruff format on collected files (used in Stop hook)
• session start - Prints introductory message about automatic hooks

Claude Code Settings

Add hooks to your Claude Code settings.json:

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "poetry run python-claude session start"
          },
          {
            "type": "command",
            "command": "poetry run python-claude git status"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "poetry run python-claude ruff format"
          },
          {
            "type": "command",
            "command": "poetry run python-claude ruff check"
          },
          {
            "type": "command",
            "command": "poetry run python-claude mypy"
          },
          {
            "type": "command",
            "command": "poetry run python-claude pytest"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "poetry run python-claude edited"
          }
        ]
      }
    ]
  }
}

Development

poetry install
poetry run pytest
poetry run ruff check
poetry run mypy src