Pre Commit Hooks

This project is a comprehensive collection of pre-commit hooks designed to automate code linting, style enforcement, and file validation before changes are committed to version control. It provides a suite of ready-to-use scripts that serve as quality guards, including static analysis hooks, configuration file validators, and tools for maintaining version control integrity.

The collection distinguishes itself by offering specialized guards for repository health and security. This includes detection of leaked credentials and private keys, prevention of large file commits, and enforcement of branch protection to ensure a pull-request workflow. It also handles filesystem-specific issues such as OS-incompatible filenames, case-insensitive name conflicts, and the validation of symbolic links.

Broadly, the project covers automated code formatting to normalize whitespace, line endings, and quote styles, as well as syntax validation for Python, JSON, YAML, TOML, and XML. It further provides static analysis utilities to detect debugger statements, merge conflict markers, and incorrect test naming conventions.

Features

Code Formatting and Linting - Provides an automated suite of scripts for enforcing code style and linting standards before version control submission.
Pre-commit Hooks - Provides a comprehensive collection of ready-to-use pre-commit hooks for automated linting and validation.
Code Formatting - Implements automated tools for enforcing consistent code formatting and style via pre-commit hooks.
Regex Pattern Matching - Uses regular expressions to identify prohibited patterns, sensitive secrets, or formatting inconsistencies in files.
Configuration File Validators - Provides automated verification of syntax and structure for project configuration files.
Coding Style Tools - Ships scripts for normalizing line endings, trimming whitespace, and formatting structured data files.
Syntax and Type Verification - Verifies that Python files parse as valid code to prevent syntax errors in the repository.
Git Repository Maintenance Tools - Ensures repository health by detecting OS-incompatible filenames, broken symlinks, and oversized files.
Shell Orchestrators - Orchestrates the execution of discrete script-based hooks and processes their exit codes to gate commits.
Text Transformations - Implements a pipeline of idempotent rules for normalizing file contents across the codebase.
Static Syntax Validation - Automatically checks various file formats for syntax errors to prevent broken code from entering version control.
Secret Detection Tools - Provides automated scanning to detect leaked private keys and cloud credentials before they are committed to version control.
Secret Leak Prevention - Scans source code for private keys and cloud credentials to prevent accidental exposure of secrets.
Syntax Validation - Provides AST-based syntax validation to ensure code is grammatically correct before commits.
Static Analysis - Implements automated checks to detect syntax errors, debugger statements, and secrets before commit.
Pre-Commit Quality Checks - Prevents large files, case conflicts, and broken symlinks from being committed via quality guards.
Automated Version Control Workflows - Enforces quality standards and repository structure by blocking direct commits to protected branches.
Line Ending Standards - Standardizes mixed line endings and ensures every file ends with exactly one newline character.
Quote Style Configurations - Normalizes string quote styles by replacing double quotes with single quotes for consistency.
JSON Formatting and Sorting - Pretty-prints JSON files with sorted keys and consistent indentation for improved readability.
TOML Syntax Validators - Provides automated syntax validation for TOML files to ensure structural correctness before commits.
XML Syntax Validators - Provides automated syntax validation for XML files to ensure structural correctness before commits.
CI Conflict Detection - Detects merge conflict markers in files to prevent unresolved conflicts from being committed.
YAML Key Sorting - Sorts top-level keys in YAML files while preserving comments and block structures.
YAML Syntax Validation - Provides automated syntax validation for YAML files to ensure structural correctness before commits.
Branch Protections - Blocks direct commits to specified branches to enforce a strict pull-request workflow.
Whitespace Cleaners - Automatically removes trailing whitespace from the ends of lines while preserving specific markup.
Commit Blockers - Implements commit blocking to prevent files exceeding a specified size threshold from entering the repository.
JSON Syntax Validators - Provides automated syntax validation for JSON files to ensure structural correctness before commits.
Filesystem Metadata Inspection - Inspects file permissions, symbolic links, and naming conventions to ensure cross-platform repository compatibility.
Debugger Statement Detection - Scans source code for debugger imports and breakpoint calls to prevent shipping debug code.

astral-sh/ruff

48,177View on GitHub

Ruff is a high-performance static analysis and code formatting tool designed for Python. Built in Rust, it functions as a comprehensive engine that scans source code to detect programming errors, security vulnerabilities, and deviations from established coding standards. By parsing source code into a structured tree representation, it provides both automated linting and style enforcement across entire projects. The tool distinguishes itself through its speed and deep integration into the development lifecycle. It utilizes parallelized file processing to maximize throughput on large codebases

j178/prek

6,297View on GitHub

Prek is a Git hook manager written in Rust that runs configured hooks as a single binary without requiring Python or other external runtimes. It executes hooks faster than standard tools through parallel processing and bundled Rust implementations, and includes a built-in hook repository that enables fully offline operation without network access or environment setup. The tool supports both TOML and YAML configuration formats with identical semantics, and can run hooks from existing pre-commit configuration files without modification. Prek distinguishes itself through workspace-aware monorepo

prettier/prettier

52,088View on GitHub

Prettier is an opinionated code formatter that parses source code and reprints it from scratch to enforce a consistent, project-wide visual style. By transforming code into an abstract syntax tree and applying a recursive document printing process, it eliminates manual style debates and ensures that all source files adhere to a unified appearance. The project is distinguished by its extensible, plugin-based architecture, which decouples language-specific parsing logic from the core engine. This modular design allows for uniform style enforcement across diverse programming languages and comple

antfu/eslint-config

6,210View on GitHub

Anthony's ESLint config preset

Anthony's ESLint config preset

pre-commitpre-commit-hooks

Features