<div id="readability-page-1" class="page"><div tabindex="-1" id="___gatsby"><article><div>컨벤션에 맞지 않는 코드를 일일히 포매팅하는건 굉장히 귀찮고 때론 괴로운 작업입니다.
자동화의 축복을 갈구하던 도중 <a href="https://github.com/Rainist/python/blob/master/%7B%7Bcookiecutter.project_slug%7D%7D/Makefile" target="_blank" rel="noreferrer">뱅크샐러드가 git hook과 makefile을 사용하고 있다고 전해듣고</a> 얼씨구나 찾아서 개조해서 써 보았습니다.<h2 id="사용할-커맨드라인-툴들">사용할 커맨드라인 툴들</h2><ul><li>isort<ul><li>자동으로 임포트 걸어놓고 정리되지 않은 임포트들을 깔끔하게 정렬하고 그룹화 해줍니다.</li></ul></li><li>black<ul><li>PEP8 +alpha 격인 포맷을 사용해 자동으로 코드를 정리해 줍니다.</li></ul></li><li>mypy<ul><li>PEP484를 따르는 타입 힌트를 사용해 타입을 무시하는 코드들을 심판하는 정적 타입 검사기입니다.</li></ul></li><li>pylint<ul><li>파이썬 코드를 린트해주는 툴입니다.</li></ul></li></ul><h2 id="makefile-구성">Makefile 구성</h2>제가 사용하는 Makefile은 4개의 커맨드로 구성되어있습니다.<ul><li>check</li><li>format</li><li>lint</li><li>hook</li></ul><h2 id="check"><code>check</code></h2><code>make check</code> 명령은 isort와 black을 검사 모드로 사용해 포매팅을 확인하고 mypy로 타입체크를 수행합니다.파이참 코드 리밋에 맞추어 가로 길이 기본값 88자 대신 120자를 사용하고 mypy를 strict모드로 사용합니다. 이 명령어는 다음의 인용을 이루기 위한 한걸음입니다. <blockquote>동적 언어에서는 금지된 것이 없어서 프로그래머 본인이 강철같은 불굴의 뚝심으로 정신을 바짝 차리고 숭고하고 순결한 코드 설계와 비타협적 코딩 원칙을 관철하고 심지어 여기에 충성하지 않는 모든 반동적인 동료들을 숙청해야만 알고리즘과 입출력을 완벽하게 분리할 수 있습니다.<cite>https://xtendo.org/haskell/ko/why</cite></blockquote>이 명령을 CI에서 실행시킨다면 깃 훅이 설치되지 않은 환경에서 푸쉬된 코드에 대해 방어할 수 있습니다.<div><pre>1check:2 isort --recursive --multi-line=3 --trailing-comma --force-grid-wrap=0 --use-parentheses --line-width=120 --check-only &lt;package&gt;3 black -S --line-length=120 --check &lt;package&gt;4 mypy &lt;package&gt; --show-error-codes --pretty --strict</pre></div><h2 id="format"><code>format</code></h2><code>make format</code>명령은 isort와 black을 사용해 포매팅을 수행합니다.<div><pre>1format:2 isort -rc -y --multi-line=3 --trailing-comma --force-grid-wrap=0 --use-parentheses --line-width=120 &lt;package&gt;3 black -S --line-length=120 &lt;package&gt;</pre></div><h2 id="lint"><code>lint</code></h2><code>make lint</code> 명령은 pylint를 수행합니다. <code>make check</code>에 포함시킬수도 있지만 pylint가 일정 점수 이하로 내려갔을때 exit with non-zero가 아니라
단 한개의 린트 실패도 용납하지 않고 있어서 해당 기능이 릴리즈 될 때(<a href="https://github.com/PyCQA/pylint/pull/3260" target="_blank" rel="noreferrer">PR은 머지되어 있는걸 확인</a>) 까지 이 명령으로 유배시켜놓을 예정입니다.<div><pre>1lint:2 pylint &lt;package&gt; || exit 0</pre></div><h2 id="hook"><code>hook</code></h2><code>make hook</code> 명령은 git hook을 설치할때 사용합니다. 훅 설치용 쉘스크립트와 훅에 권한을 부여하고, 설치용 쉘 스크립트를 실행해 깃 훅을 설치합니다.<div><pre>1hook:2 chmod 744 ./bin/install_hooks.sh3 chmod 744 ./bin/pre-push4 ./bin/install_hooks.sh</pre></div><h2 id="git-hook-구성">git hook 구성</h2><code>make hook</code> 명령에서 사용되는 git hook의 구성입니다. pre-commit은 너무 귀찮기 때문에 약간 타협해 pre-push만 사용합니다.
저도 맥만 사용하고 개발팀에서도 맥만 사용하기 때문에 bash 대신 macOS 기본 쉘인 zsh를 사용합니다.<h2 id="install_hookssh"><code>install_hooks.sh</code></h2>이 쉘 스크립트는 깃 레포의 루트를 알아내어 그 기준으로 깃 훅 폴더에 아래에서 구성할 깃 훅 스크립트의 심볼릭 링크를 구성합니다.<div><pre>1#!/usr/bin/env zsh2PROJECT_DIR=$(git rev-parse --show-toplevel)34ln -sf $PROJECT_DIR/bin/pre-push $PROJECT_DIR/.git/hooks/pre-push</pre></div><h2 id="pre-push"><code>pre-push</code></h2>git push를 사용할때 자동으로 실행될 스크립트 입니다. 기본적으로 <code>make check</code>와 동일한 스텝을 사용합니다.출력이 그닥 필요 없고 각 스텝이 통과하는지만 알수 있으면 되기 떄문에 각 스텝 끝에 <code>&gt; /dev/null 2&gt;&amp;1</code> 를 붙여서 출력을 안보이게 처리했습니다.추가로 순전히 개인적인 사리사욕으로 Pass/Fail 출력에 컬러가 들어가면 예쁠거란 생각이 들어 echo에 설정을 추가해서 성공시에는 초록색, 실패시에는 빨간색이 출력됩니다.<div><pre>123isort --recursive --multi-line=3 --trailing-comma --force-grid-wrap=0 --use-parentheses --line-width=120 --check-only &lt;package&gt; &gt; /dev/null 2&gt;&amp;14if [ $? -ne 0 ]; then5 echo "-e \e[31m [\!] isort failed! Run 'make format'"6 exit 17fi8echo -e "\e[32m [+] isort success!"910black -S --line-length=120 --check &lt;package&gt; &gt; /dev/null 2&gt;&amp;111if [ $? -ne 0 ]; then12 echo -e "\e[31m [\!] failed! Run 'make format'"13 exit 114fi15echo -e "\e[32m [+] black success!"1617mypy &lt;package&gt; --show-error-codes --pretty --strict &gt; /dev/null 2&gt;&amp;118if [ $? -ne 0 ]; then19 echo -e "\e[31m [!] mypy failed! Please fix code before push"20 exit 121fi22echo -e "\e[32m [+] mypy success!"23echo -e "\e[0m"2425exit 0</pre></div></div></article><section><h3>More articles from seonghyeon.dev</h3></section></div></div>

seonghyeon.dev

Seonghyeon Kim

git hook, Makefile, 그리고 강철같은 불굴의 뚝심으로 정신을 바짝 차리고 숭고하고 순결한 코드와 비타협적 타입 안정성을 관철하기

git hook과 Makefile을 사용해 파이썬 코드 검열하기

댓글