위키득계정 ↗
기술

Lefthook

Lefthook기술
분류
Git 훅 관리자
구현 언어
Go
주요 설정
lefthook.yml
대상 프로젝트
여러 언어의 저장소
Lefthook은 Git 훅에 연결할 명령과 스크립트를 설정으로 관리하는 도구다. 커밋과 푸시 과정의 검사를 묶고 실행 대상 파일과 작업 위치, 병렬 실행 여부 등을 제어할 수 있다.

훅과 검사 도구의 연결

Git 훅은 커밋이나 푸시 같은 작업 시점에 명령을 실행하는 연결 지점이다. Lefthook은 그 시점에 어떤 명령과 스크립트를 실행할지 설정한다. 린터나 테스트 자체를 대신하는 분석기가 아니라 여러 검사 도구를 개발 흐름에 연결하는 관리자다.

파일과 실행 위치 제어

스테이징된 파일이나 지정한 파일 목록을 명령에 전달할 수 있다. 경로 패턴과 정규식으로 대상을 좁히고 하위 디렉터리를 기준으로 작업을 실행하는 구성도 가능하다. 여러 언어와 디렉터리가 함께 있는 저장소에서 각 검사에 맞는 범위를 지정하는 데 활용한다.

명령 묶음의 실행 관리

독립된 작업의 병렬 실행을 지원하며 태그로 명령을 묶거나 출력 내용을 조정할 수 있다. 훅에 연결한 작업뿐 아니라 설정한 명령 묶음을 직접 실행할 수도 있다. 실제 통과 조건과 검사 내용은 연결한 명령에 달려 있으므로 훅 관리자와 검사 정책을 구분해 이해해야 한다.

관련 문서

Husky / Commitlint / Commitizen / Actionlint / Semgrep