Arkweid/lefthook
Lefthook
Lefthook is a Git hook manager and workflow automator that uses a configuration-driven approach to manage scripts triggered by version control events. It functions as a parallel task runner, executing multiple scripts simultaneously to reduce the time required for pre-commit or pre-push checks.
The project provides a containerized hook runner to ensure consistent dependencies and toolsets across different developer machines. It also supports monorepo orchestration by executing scripts within specific subdirectories and managing complex project structures.
The system includes capabilities for pattern-based file filtering to run quality assurance tasks only on modified assets. It further supports manual task execution, command tagging and grouping, and local configuration overrides for environment-specific settings.
Features
- Git Hook Managers - Provides a comprehensive tool for configuring and automating scripts that trigger during Git version control events.
- Configuration File Command Execution - Maps Git hook events to specific shell commands and scripts using structured YAML or JSON configuration files.
- Custom Git Workflow Automations - Implements a configuration-driven approach to managing complex sets of commands linked to specific Git lifecycle events.
- Hook File Filters - Limits which files are processed by commands using patterns, expressions, or predefined lists during hook execution.
- Parallel Command Execution - Provides concurrent execution of multiple shell commands to minimize the time spent waiting for git hook completion.
- Parallel Task Execution - Runs multiple development scripts simultaneously to reduce the total time spent waiting for tests or linters.
- Parallel Task Runners - Functions as a parallel task runner that executes multiple scripts simultaneously to speed up pre-commit checks.
- Parallel Task Spawning - Executes multiple independent shell commands in parallel to minimize the time spent waiting for hook completion.
- Pre-Commit Quality Checks - Filters specific changed files to run linters and tests before code is committed to the repository.
- Pattern-Based Filters - Filters changed files using glob patterns to ensure scripts only run on relevant modified assets.
- Container-Wrapped Toolsets - Wraps command execution inside a container runtime to provide a consistent toolset regardless of the host machine.
- Containerized Development Workflows - Executes hooks and scripts inside containers to ensure all team members use identical toolsets and dependencies.
- Containerized Hook Environments - Executes Git hooks inside containerized environments to ensure consistent toolsets and dependency versions.
- Manual Task Triggering - Enables triggering specific command groups or hooks manually through the command line without a version control event.
- Subdirectory Script Execution - Executes commands within specific relative paths to manage projects that use nested directory structures.
- Monorepo Orchestration - Manages and runs subdirectory scripts within complex project structures to handle multiple nested packages or modules.
- Hook Management Tools - Provides a fast, cross-platform manager for various project types.
