More than 3 years have passed since last update.

Gitコマンドの前に特定の処理を挟む方法

Posted at 2021-02-27

はじめに

Gitを使ってる際に、コミット前に静的チェックを実施するためにあれこれ調べたので、記事にまとめました。

package.jsonに下記を指定することで、git commit前に静的チェック(lint)を実行できる。

package.json

  "husky": {
    "hooks": {
      "pre-commit": "npm run lint"
    }
  },

最初に、Gitのコマンドを検知する仕組みについて紹介します。

Gitには、Gitの特定アクションを検知してカスタムスクリプトを叩く仕組みである「Gitフック」が提供されています。
この「Gitフック」を利用することで、gitコマンド実行時に処理を割り込ませることができます。

Gフックの例

フック	タイミング
pre-commit	コミットメッセージが入力される前に実行
prepare-commit-msg	コミットメッセージエディターが起動する直前、デフォルトメッセージが生成された直後に実行
post-commit	コミットプロセスが全て完了した後

Gフックを利用して、特定処理を挟むサポートをしてくれるパッケージは主に下記があります。
・GHooks(https://github.com/ghooks-org/ghooks)
・Husky(https://github.com/typicode/husky#readme)
・Pre-Commit(https://github.com/observing/pre-commit)

パッケージを比較してみると、Huskyが最も人気がありアップデート頻度も高いので、Huskyで実装していきます。

下記コマンドを実行し、huskeyをインストールする。

npm install husky --save-dev

下記のように、package.jsonに"husky"の設定を追記すればOKです。

例：git commit前にnpm run lintを実行する。

package.json

  "husky": {
    "hooks": {
      "pre-commit": "npm run lint"
    }
  },

huskyを使えば、簡単に任意のコマンドをGitの特定アクション前後に挟むことができます。