前一篇提到了透過 invoke 簡化繁瑣的指令
但人類是懶惰的
即使已經更簡便了,沒被督促常常還是會忘了執行
就像這次的系列文,如果沒被寫作松督促,不知道什麼時候才會出現(笑
這次來聊聊如何透過 pre-commit 強制做檢查

pre-commit

pre-commit 讓我們能方便的加入 Git Hook,並在各種 git 的相關操作前進行檢查

正如它的命名,它可以在進行 git commit 前執行一些操作
不過並不僅限於 commit 前,也可以在其它 git 的階段進行
之所以要這麼做就是為了讓不符合要求的程式碼,從最一開始就不會進入到版本庫 (pre commit)或 git 伺服器 (pre push)

使用 pre-commit 進行檢查

# 安裝 pre-commit
pipenv install pre-commit --dev

接著可以透過設定檔 .pre-commit-config.yaml,告訴 pre-commit 要做哪些檢查
需要注意的是,專案必須要是一個 git 專案
這些 git hook 都會被寫入 .git/hooks/

e.g.,

repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v2.5.0
    hooks:
      - id: end-of-file-fixer
      - id: trailing-whitespace
        args: [--markdown-linebreak-ext=md]

以上面的例子來說

  • repos 告訴 pre-commit 要去哪邊找到這些 hook
    • repo: 去找專案 pre-commit-hooks
    • rev: 在專案 pre-commit-hooks 找到 rev v2.3.0
    • hooks: 在 pre-commit-hooks rev v2.3.0 的 .pre-commit-hooks.yaml 中尋找指定的 hook
      • id: hook id
      • args: 執行這個 hook 的額外參數

pre-commit 整理了將常見並較為通用的 hook 都被整理在 pre-commit-hooks
除此之外,如 blackflake8 等工具也都有提供 pre commit hook

另外,建議 rev 不要使用 master,而應該使用版本號等明確的 rev
原因是預設 pre-commit 會在執行時將 hook 專案 clone 下來
如果沒有特別設定, pre-commit 不會把最新版 pull 下來
指到的 master 就會是第一次 pre-commit 抓到時的 master,不是最新版的 master

寫完設定檔後,接著就是把 pre-commit hook 安裝到 git 專案中

# 將 pre-commit hook 安裝到 git 專案
pipenv run pre-commit install

需要注意的是每次重新 clone 之後,都必須要執行一次
雖然可以將 .pre-commit-config.yaml 加入版本控制
.git/hook/ 是不能被加入版本控制的

執行完會出現以下訊息

pre-commit installed at .git/hooks/pre-commit

第一次進行 git commit 時,會將 pre-commit-hooks clone 到 pre-commit 統一管理的地方
之後就會進行 Fix End of FilesTrim Trailing Whitespace 的檢查

[INFO] Initializing environment for https://github.com/pre-commit/pre-commit-hooks.
[INFO] Installing environment for https://github.com/pre-commit/pre-commit-hooks.
[INFO] Once installed this environment will be reused.
[INFO] This may take a few minutes...
Fix End of Files.........................................................Passed
Trim Trailing Whitespace.................................................Passed

如果沒有通過, git 會阻止你進行 commit

另外需要注意的是 pre-commit 每次都只會針對要 commit 的檔案做檢查
所以建議第一次引入 pre-commit 時,可以先檢查所有的檔案

pipenv run pre-commit run --all-files

使用自定義的 pre-commit hook

除了使用現成的 pre-commit hook,也可以寫客製化的檢查

下面的例子就是在 commit 前,要進行 pytest 的檢查

repos:
  - repo: local
    hooks:
      - id: pytest
        name: pytest
        stages: [commit]
        language: system
        entry: pipenv run pytest
        pass_filenames: false
        types: [python]
  • repo: local: 直接在本地資料夾執行
    • hooks: 有哪些 hook 要執行
      • id, name: hook 的 id / name 是 pytest
      • stages: 在 commit 前執行
      • language: 直接使用系統執行 entry 內的指令
      • entry: 這個 hook 要執行的指令是 pipenv run pytest
      • types: 只有在 python 這種檔案類型才進行檢查
      • pass_filenames: 是否要將 commit 的檔案名稱作為 entry 中指令的參數

其中 stages 總共有六種

  • commit
  • merge-commit
  • push
  • prepare-commit-msg
  • commit-msg
  • manual

這裡需要注意的是當執行 pipenv run pre-commit commit
預設只會寫入 .git/hooks/pre-commit
如果要加入其他階段,則必須要在後面加入參數 -t [hook-type]

e.g.,

pipenv install pre-commit install pre-push

支援 6 種 hook-type

  • pre-commit
  • pre-merge-commit
  • pre-push
  • prepare-commit-msg
  • commit-msg

像是 pytest 這種需要執行比較久的
我就不見得會在 commit 這個 stage 做檢查
而是會把 stages 改成 push
並安裝 pre-push 的 hook (i.e. pipenv run pre-commit install -t pre-push)

如果不想要每個 hook 都各自做設定,可以在 .pre-commit-config.yaml 加上 default_stages

default_stages: [push]

表示如果沒有特定指定 stages 的 hook 都只在 push 的階段做檢查

為自己的工具加上 pre-commit hook

如果你有寫檢查工具,加上 pre-commit hook 就能讓人更方便使用你的工具
在工具加入 .pre-commit-hooks.yaml 讓 pre-commit 知道其他人引入你的工具時要怎麼做檢查
撰寫的方式跟 local 的 repo 的寫法相似

repos:
    - repo: local
      hooks:
        - id: ...
          name: ...
          description: ...
          entry: ...

Bouns: 可以只跳警告不擋下 commit 嗎?

根據 Can I show warning message without blocking the commit? #923 提到的, pre-commit 認為這不是好的作法
但仍然可以透過對 entry 內指令的操作達到類似的效果

Reference

Share on: TwitterFacebookEmail

Comments

Do you like this article? What do your tink about it? Leave you comment below

comments powered by Disqus

Published

Last Updated

Python Table Manners

Read Time

2 min

Category

Tech

Tags

Keep In Touch