TECH 으로 돌아가기
TECH HACKER NEWS 8분 읽기 81 READS

Lisp 포매터 Sift: 되돌릴 수 있는 재작성이라는 설계 원칙

Lisp 포매터 Sift: 되돌릴 수 있는 재작성이라는 설계 원칙
SOURCE IMAGE · HACKER NEWS

코드 포매터를 둘러싼 오랜 불만 중 하나는 결과를 신뢰하기 어렵다는 점이다. 포매팅을 한 번 더 돌렸을 때 결과가 또 바뀌거나, 주석과 빈 줄이 엉뚱한 자리로 밀려나거나, 도구가 손대지 말아야 할 문자열 내부까지 건드리는 일이 드물지 않다. Guile 3.0으로 작성된 Lisp 계열 도구 Sift는 이 문제를 설계의 출발점으로 삼는다. Sift는 Scheme, Emacs Lisp, Common Lisp 소스를 읽어 무엇이 잘못되었는지 보고하고(linter), 공백을 다시 쓰고(formatter), 같은 결과를 LSP(언어 서버)로도 제공한다. 세 가지 기능이 하나의 실행 파일에서 동일한 계산을 공유한다는 점이 이 프로젝트의 핵심이다.

멱등성과 무손실이라는 두 가지 보장

Sift가 내세우는 가장 중요한 성질은 포매팅이 텍스트에 대한 전역 함수이자 고정점이라는 것이다. 이미 포매팅된 파일을 다시 포매팅해도 결과가 달라지지 않으며, 주석이나 빈 줄, Scheme의 #; 데이텀 주석, #. 읽기 시점 폼이 입력에서 있던 자리에 그대로 출력에 나타난다. 중요한 것은 이 두 성질이 말뿐인 약속이 아니라 테스트 스위트의 모든 픽스처에 대해 검증된다는 점이다. 스위트는 각 픽스처를 두 번 포매팅해 멱등성을 확인한다. 결정적이고 멱등적인 동작을 테스트로 고정해 두었기 때문에, 조용히 깨지는 약속이 되지 않도록 한 것이다.

이 모든 성질은 단 하나의 설계 결정에서 파생된다. Sift는 Lisp 파일을 텍스트 줄의 묶음이 아니라 소스 위치를 지닌 폼(form)의 트리로 읽고, 그 트리를 다시 출력한다. 리더(reader)와 프린터(printer)가 서로 역함수라는 것은 Lisp이 가진 가장 오래된 성질인데, Sift의 작업은 공백이 움직이는 동안에도 이 역함수 관계를 유지하는 데 있다. 범위를 하나 교체하는 방식의 수정, 변경 그대로가 곧 hunk가 되는 diff, 손대려는 코드를 수정하지 않고도 침묵시킬 수 있는 규칙이 모두 여기서 따라 나온다.

방언을 평균내지 않는다

Sift는 세 방언을 각자의 표준 규격대로 읽는다. 대괄호가 한 방언에서는 벡터이고 다른 방언에서는 절(clause)인데, Sift는 둘을 절충하지 않는다. 포매터는 줄바꿈 문자와 간격을 정규화하고, 닫는 구분자를 배치하고, 들여쓰기를 계산하며, 요청이 있으면 연속된 인라인 주석을 정렬하고, 스타일이 허용하는 범위에서 빈 줄을 보존한다. 그 밖의 것은 건드리지 않는다. 줄바꿈의 위치, 문자열의 내용, 이스케이프의 표기는 작성자의 몫이다. 린터 쪽은 92개의 규칙을 담고 있고, 각 규칙은 이름, 코드, 설명, 적용 방언, 심각도, 절차, 예시를 가진 레코드로 정의된다.

명령은 check, format, lint로 나뉜다. check는 적용될 패치를 출력하고 변경이 필요하면 종료 코드 1을 반환하되 파일에는 아무것도 쓰지 않는다. format은 포매팅된 파일을, lint는 발동한 규칙의 이름과 심각도, 위치를 출력한다. ci는 파이프라인이 묻는 두 질문을 하나의 명령과 하나의 상태로 묶는다. 출력은 file:line:column: severity: [rule] message 형태를 따르는데, 이는 Vim의 :make, Emacs의 compilation-mode, 대부분의 CI 로그 뷰어가 이미 파싱할 수 있는 형식이다. fix 명령은 규칙이 등가 변환으로 기술할 수 있는 수정을 적용하되, 재포매팅은 하지 않는다. 포매팅이 모든 줄을 건드려 읽으려던 패치를 망가뜨리기 때문이다. 사용하지 않는 import 제거와 명세 정렬은 기본값으로 켜져 있으며 sift.yaml에서 끌 수 있다.

하나의 소스에서 나오는 여러 전달 경로

에디터와 파이프라인이 같은 답을 받는다는 점은 실무적으로 중요하다. 발견 사항, 수정, 포매팅이 한 번 계산되어 표준 출력의 텍스트로도, LSP 응답으로도 전달된다. 따라서 Eglot을 거친 Emacs, Neovim, 그 밖의 프로토콜 클라이언트가 파이프라인과 정확히 같은 것을 전달받는다. 브라우저용 web/ 디렉터리는 포매팅과 린팅을 Guile Hoot으로 WebAssembly에 컴파일한 것인데, 여기서도 같은 리더, 같은 포매터, 같은 92개 규칙이 탭 안에서 돌아간다. 입력은 어디로도 나가지 않는다. 포매터를 JavaScript로 다시 구현하면 두 번째 포매터, 즉 두 번째 스타일이 생기고 어느 쪽을 믿을지 선택해야 하는 문제가 생기므로, 진실의 원천을 옮기지 않은 것이다.

설치는 guix install sift, nix run, 혹은 저장소를 클론해 ./bin/sift version을 실행하는 방식이 있다. 구현은 Guile 3.0과 표준 라이브러리뿐이며 C 의존성도 빌드 단계도 없다. Scheme 프로그램에는 빌드 단계가 없기 때문이다. 언어 서버는 설치되어 있는 guild, emacs, sbcl 중 하나에게 버퍼에 대한 2차 의견을 묻되, 없는 컴파일러는 그냥 묻지 않고 compiler-diagnostics: false로 끌 수 있다. Linux와 macOS에서 동작하며, macOS에는 신뢰할 Guile이 없는 환경을 위해 Debian의 Guile과 라이브러리, 런처만 담은 컨테이너 이미지도 제공한다. Emacs 통합은 의존성 없는 단일 파일 emacs/sift.el로, Flymake로 규칙을, Eglot으로 코드 액션을 쓰는 두 가지 방식을 지원한다.

실무적으로 눈여겨볼 점과 한계

Sift의 접근은 포매터를 신뢰 가능한 CI 구성요소로 다루려는 팀에게 설득력이 있다. 종료 코드가 0(깨끗함), 1(발견 사항), 2(사용 오류 또는 읽을 수 없는 파일)로 명확히 나뉘고, 사람이 읽는 출력 형식이 기존 도구 생태계와 바로 맞물리기 때문이다. 다만 적용 범위는 Lisp 계열 세 방언에 한정되며, Common Lisp 생태계의 방대한 매크로 관행을 모두 완벽히 다루는지는 사용 맥락에 따라 검증이 필요하다. 문서 자체도 Sift와 에디터의 TAB이 서드파티 매크로의 들여쓰기를 두고 엇갈릴 수 있음을 인정한다. 깊게 중첩된 본문처럼 일부 사안은 다시 쓰이지 않고 보고만 된다는 점, 그리고 린팅이 추측 대신 확실한 등가 변환만 수정으로 적용한다는 보수적 태도도 함께 염두에 둘 필요가 있다. 결국 Sift가 보여주는 것은 화려한 기능이 아니라, 리더와 프린터가 역함수라는 Lisp의 오래된 성질을 규율로 지켜내면 포매터가 정확하면서도 저렴할 수 있다는 평범한 전제의 실천이다.

SOURCE · HACKER NEWS
원문 전체 보기 → https://github.com/jjba23/sift
SHARE
NEXT · CHOOSE

변화를 읽었다면,
내가 만들 수익 구조를 고릅니다.

정보를 더 모으는 데서 멈추지 않고, 광고·외주·판매·중개·구독 중 내 상황에 맞는 출발점을 정해보세요.

21가지 수익 구조 살펴보기 →
처리 중...