pre-commit-hooks

July 8, 2025 · View on GitHub

A collection of pre-commit hooks for various languages and tools to ensure code quality, security, and consistency.

Features

🔍 Multi-language support: Hooks for Python, JavaScript, Go, Rust, Nix, and more
🛡️ Security scanning: Integration with security tools
📊 Code quality: Linting, formatting, and style checks
🚀 CI/CD ready: Works seamlessly with GitHub Actions
📦 Multiple installation methods: pre-commit, npm, pip, or direct download

Installation

Using pre-commit (Recommended)

Add this to your .pre-commit-config.yaml:

repos:
  - repo: https://github.com/aRustyDev/pre-commit-hooks
    rev: v0.1.0  # Use the latest release
    hooks:
      - id: shellcheck
      - id: shfmt
      # Add more hooks as needed

Then run:

pre-commit install
pre-commit run --all-files

Using npm

npm install --save-dev @arustydev/pre-commit-hooks

Using pip

pip install arustydev-pre-commit-hooks

Direct Installation

curl -sSL https://github.com/aRustyDev/pre-commit-hooks/releases/latest/download/install.sh | bash

Available Hooks

Shell/Bash

shellcheck - Shell script analysis
shfmt - Shell script formatting

Git/Commits

commitizen - Conventional commit messages
commitlint - Commit message linting
gitlint - Git commit message linter

Nix

nix-fmt - Nix code formatter
nix-lint - Nix linter
nix-build - Nix build validation

Web Development

eslint - JavaScript linting
jshint - JavaScript code quality
fixmyjs - JavaScript auto-fixing
csslint - CSS linting
scss-lint - SCSS linting

CI/CD

github-action-lint - GitHub Actions workflow linting

Configuration

yamlfmt - YAML formatting

Security

witness - Supply chain security

Usage Examples

Basic Setup

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/aRustyDev/pre-commit-hooks
    rev: v0.1.0
    hooks:
      # Shell scripts
      - id: shellcheck
        args: [-x]
      - id: shfmt
        args: [-i, '2', -ci]

      # JavaScript
      - id: eslint
        files: \.js$

      # Commits
      - id: commitlint
        stages: [commit-msg]

Advanced Configuration

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/aRustyDev/pre-commit-hooks
    rev: v0.1.0
    hooks:
      # Run on specific files
      - id: nix-fmt
        files: \.nix$

      # Custom arguments
      - id: shellcheck
        args: [--severity=warning]

      # Exclude patterns
      - id: eslint
        exclude: ^vendor/

Development

Prerequisites

Python 3.6+
Node.js 14+
Bash 4+
pre-commit

Setup

# Clone the repository
git clone https://github.com/aRustyDev/pre-commit-hooks.git
cd pre-commit-hooks

# Install dependencies
npm install
pip install -e .[dev]
pre-commit install

# Run tests
./tests/run_tests.sh

Contributing

See CONTRIBUTING.md for guidelines.

Testing

Tests are written using bats:

# Run all tests
./tests/run_tests.sh

# Run specific test
bats tests/commits/test_gitlint.bats

# Run with coverage
kcov coverage bats tests/