git-hooks-manager - Git Hooks管理器

Metadata

Description

English

A Git hooks manager that simplifies installing, configuring, and sharing Git hooks across teams. Includes pre-built templates for linting, testing, branch naming validation, commit message validation, and custom hook orchestration.

中文

Git Hooks管理器，简化团队间Git钩子的安装、配置和共享。包含预置模板：代码检查、测试运行、分支名验证、提交信息验证和自定义钩子编排。

Requirements

• Python 3.8+
• Git >= 2.30
• click >= 8.0.0
• colorama >= 0.4.6

Configuration

Environment Variables

HOOKS_MANAGER_STRICT=true
HOOKS_MANAGER_SKIP_LINT=false

Usage

Install Hooks

# Install all recommended hooks
python scripts/hooks_manager.py install --all

# Install specific hook
python scripts/hooks_manager.py install pre-commit

# Install from template
python scripts/hooks_manager.py install pre-commit --template lint-and-test

Create Custom Hook

from git_hooks_manager import HookManager

manager = HookManager()

# Define a custom pre-commit hook
@manager.hook("pre-commit")
def my_pre_commit():
    # Run custom checks
    result = manager.run_command("pytest", ["tests/smoke/"])
    if result.returncode != 0:
        print("Smoke tests failed!")
        return False
    return True

manager.install()

Validate Commit Messages

python scripts/hooks_manager.py validate-message "feat: add user login"

API Reference

HookManager

• install(hook_name, template=None) - Install a hook
• uninstall(hook_name) - Remove a hook
• list_hooks() - List installed hooks
• validate_commit_message(msg) - Validate conventional commits format
• validate_branch_name(name) - Validate branch naming convention
• run_command(cmd, args) - Run a shell command and return result

Built-in Templates

• lint-and-test - Run linters and unit tests
• conventional-commits - Validate commit messages
• branch-guard - Enforce branch naming rules
• security-scan - Run basic security checks
• ci-simulation - Simulate CI pipeline locally

Examples

See examples/ directory for complete examples.

Testing

cd /root/.openclaw/workspace/skills/git-hooks-manager
python -m pytest tests/ -v

License

MIT License