lefthook

Node.js、Ruby、Python、その他多くの種類のプロジェクトのGit Hooks Manager。

• 速い。 GOで書かれています。コマンドを並行して実行できます。
• 強力。これにより、コマンドに渡す実行とファイルを制御できます。
• 単純。これは、あらゆる環境で機能する単一の依存関係のないバイナリです。

ドキュメント

はじめに投稿を読んでください

インストール

Go （> = 1.23）：

go install github.com/evilmartians/lefthook@latest

NPMで：

npm install lefthook --save-dev

Rubyの場合：

gem install lefthook

Pythonの場合：

pip install lefthook

Lefthook：Apt、Brew、Wingetなどをインストールする方法を備えたインストールガイド。

使用法

フックを構成し、それらを一度インストールして忘れてください。その下の魔法に頼ってください。

tl; dr

 # Configure your hooks
vim lefthook.yml

# Install them to the git project
lefthook install

# Enjoy your work with git
git add -A && git commit -m ' ... ' 

詳細

• lefthook.yml構成オプションの構成。
• Lefthook CLIオプション、サポートされているENVS、および使用のヒントの使用。
• 質問、アイデア、提案のための議論。

なぜレフスック

• 並列実行

より多くの速度を与えます。ドキュメント

 pre-push :
  parallel : true

• ファイルの柔軟なリスト

独自のリストが必要な場合。カスタムおよび事前に構築された例。

 pre-commit :
  commands :
    frontend-linter :
      run : yarn eslint {staged_files}
    backend-linter :
      run : bundle exec rubocop --force-exclusion {all_files}
    frontend-style :
      files : git diff --name-only HEAD @{push}
      run : yarn stylelint {files}

• GlovおよびRegexpフィルター

ファイルのリストをフィルタリングする場合。ここでは、より多くのグローブパターンの例を見つけることができます。

 pre-commit :
  commands :
    backend-linter :
      glob : " *.rb " # glob filter
      exclude : ' (^|/)(application|routes).rb$ ' # regexp filter
      run : bundle exec rubocop --force-exclusion {all_files}

• サブディレクトリで実行します

相対パスでコマンドを実行したい場合

 pre-commit :
  commands :
    backend-linter :
      root : " api/ " # Careful to have only trailing slash
      glob : " *.rb " # glob filter
      run : bundle exec rubocop {all_files}

• スクリプトを実行します

Onelineコマンドで十分でない場合は、ファイルを実行できます。ドキュメント

 commit-msg :
  scripts :
    " template_checker " :
      runner : bash

• タグ

コマンドのグループを制御したい場合。ドキュメント

 pre-push :
  commands :
    packages-audit :
      tags :
        - frontend
        - linters
      run : yarn lint
    gems-audit :
      tags :
        - backend
        - security
      run : bundle audit

• Dockerをサポートします

Docker環境にいる場合。ドキュメント

 pre-commit :
  scripts :
    " good_job.js " :
      runner : docker run -it --rm <container_id_or_name> {cmd}

• ローカル構成

フロントエンド/バックエンド開発者であり、不必要なコマンドをスキップしたり、何かをDockerにオーバーライドしたい場合。ドキュメント

 # lefthook-local.yml
pre-push :
  exclude_tags :
    - frontend
  commands :
    packages-audit :
      skip : true

• 直接制御

フックグループを直接実行したい場合。

$ lefthook run pre-commit

• あなた自身のタスク

特定のコマンドのグループを直接実行する場合。

 fixer :
  commands :
    ruby-fixer :
      run : bundle exec rubocop --force-exclusion --safe-auto-correct {staged_files}
    js-fixer :
      run : yarn eslint --fix {staged_files} 

$ lefthook run fixer

• 制御出力

Refthookプリントを出力オプションで制御できます。

 output :
  - execution
  - failure

---

ガイド

• node.jsでインストールします
• Rubyとともにインストールします
• HomeBrewでインストールします
• Wingetでインストールします
• DebianベースのLinuxのインストール
• RPMベースのLinuxのインストール
• Arch Linuxのインストール
• Alpine Linuxのインストール
• 使用法
• 構成

例

例を確認してください

記事

• 自動化のためにLefthookを構成する5つのクールな（そして驚くべき）方法
• Lefthook：チームのコードを形に戻します
• Lefthook +クリスタルボール
• docsify、lefthook、および友人とOSSのドキュメントをチェックしておく
• Dockerコンテナを自動的に並べます
• Lefthookを使用したDockerDev環境でのスムーズなpostgreSQLアップグレード
• React/ReactネイティブアプリのLefthook