evilmartians/lefthook

Features

• Git Hook Definitions - Defines automation steps and scripts to execute during Git events via structured configuration files.
• Git Hook Managers - Automates the installation and execution of Git hooks to validate or modify the development workflow.
• Configuration Layering Systems - Merges global, remote, and local configuration files to support environment-specific overrides of hook behaviors.
• Input Filtering - Restricts hook execution to specific files using glob patterns and file type filters.
• File Filtering Utilities - Restricts files passed to commands using glob patterns and skips execution when no matches are found.
• Parallel Command Execution - Executes multiple commands and scripts concurrently to significantly reduce total execution time.
• Parallel Execution - Runs multiple shell commands concurrently using a worker model to reduce total workflow latency.
• Pre-commit Hooks - Automates the execution of linters, tests, and formatters as quality checks before commits.
• Shell Script Execution Engines - Executes specified shell scripts or commands as part of a workflow to automate quality checks.
• Configuration-Defined Scripts - Maps version control events to user-defined scripts via YAML or JSON configuration files.
• Configuration Merging - Combines local and external configuration files using glob patterns to share and synchronize settings across teams.
• Command Argument Templates - Substitutes placeholders in commands with real-time data like staged or tracked file paths.
• Monorepo Script Coordination - Executes commands within specified relative paths to support monorepo structures and separated folders.
• Command - Substitutes placeholders in command strings with real-time data such as staged file paths before execution.
• Argument Injection Utilities - Substitutes command templates with real-time data such as staged files or hook arguments during execution.
• CLI Output Controllers - Filters console logs and suppresses standard output to only show errors during hook execution.
• Task Runner Extensions - Supports executing tasks in different environments, including native shells and containers.
• Hook Argument Injection - Appends custom arguments or templates to commands to modify script behavior or override configurations.
• Commit Message Validation - Checks commit messages against a predefined set of rules to ensure they follow a consistent format.
• Configuration Importing - Downloads and merges configuration files from external repositories to share setup across projects.
• Dynamic File Target Selection - Executes custom shell commands to determine which files or directories should be passed to a hook.
• Environment Configuration - Loads custom configuration files via environment variables to modify behavior without changing version-controlled settings.
• Index Staging Operations - Automatically adds modified files to the Git index after a script completes to ensure changes are committed.
• Git Hook Bypassing Mechanisms - Allows users to temporarily skip the execution of configured hooks using environment variables.
• Binary Shims - Implements a lightweight binary shim in the git hooks directory to delegate execution to the main manager.
• Manual Task Triggering - Allows running specific groups of commands or custom tasks on demand via the CLI.
• Subdirectory Script Execution - Supports monorepo structures by allowing script execution within specific subdirectories.
• Local Overrides - Supports user-specific configuration files that override global project settings to isolate developer environments.
• Local Hook Configuration Overrides - Enables the creation of secondary configuration files for hooks that remain local to the machine.
• Real-Time Output Streaming - Displays the standard output of running scripts in real time rather than waiting for completion.
• Remote Configuration Synchronization - Fetches the latest configuration from a remote source on every execution to keep scripts up to date.
• Script Management Tools - Allows specifying a directory for script files excluded from version control to enable machine-specific automation.
• Task Filtering - Assigns labels to commands to selectively include or exclude tasks during the execution of hooks.
• Task Tagging Systems - Assigns labels to commands to allow selective execution or exclusion of related tasks.
• Scripted Interaction Prompts - Connects executed scripts to the terminal TTY to support real-time user interaction and prompts.
• Command Configuration Overrides - Allows local overrides of global command definitions to adapt execution environments for specific users.
• Working Directory Configuration - Controls the filesystem context for task execution and filters file paths to optimize hook runs.
• Commit Message Generation - Prompts users to create structured commit messages based on specific conventions to maintain project history.
• Conditional Command Executions - Runs specific commands or hooks only when defined conditions are met, such as matching a branch pattern.
• Sequential and Parallel Job Groups - Executes sets of scripts simultaneously or sequentially with shared environment settings to coordinate complex steps.
• Environment Variable Configurations - Defines custom environment variables and extends the system path to ensure scripts have necessary tool access.
• Git Ref-Based Execution Filters - Limits the execution of hooks to specific branches or tags to prevent scripts from running in unwanted environments.
• Hook Execution Skipping - Provides mechanisms to prevent specific scripts from running based on the active branch or system state.
• Development Environment Standardization - Enables team-wide consistency by sharing and synchronizing hook configurations via remote files.
• Execution Failure Policies - Halts the execution of subsequent commands in a sequence if any single task fails.
• Execution Filters - The tool executes specific scripts based on file properties such as MIME types or binary status.
• Worktree State Enforcement - Triggers a non-zero exit status when tracked files are modified to signal failure in CI environments.

Star history