hanlint
한국어 글에서 반복되는 결함을 결정적으로 잡는 린터이자 글쓴이의 글짓기 도구다. 의존성이 없다.
번역투와 상투어, 자주 틀리는 맞춤법과 띄어쓰기 (됬, 않 해, 할수 있다), 로서/로써 같은 헷갈리는 말,
지시어와 명사 쌓기, 조각난 문단, 도입과 결말의 개수 불일치, 그리고 코드 튜토리얼이라면 만들지 않은
파일을 읽는 자리와 설치 줄에 없는 import 까지 집는다. 항목마다 국립국어원 조항이나 실측 근거가 붙어
있고 고친 표기가 확정된 자리는 hanlint fix 가 바로 바꾼다.
글의 좋고 나쁨은 판정하지 않는다. 세어서 확정할 수 있는 결함만 집어서 자리와 이유를 돌려준다. 좋은 글인지는 사람과 LLM 평가자가 그 위에서 판단한다. hanlint 는 그 판단이 셈에 시간을 쓰지 않게 바닥을 깔아 주는 도구다.
설치
pip 하나면 된다. 형태소 분석기로 더 정밀하게 보려면 hanlint[kiwi] 를 따로 받는다. Node 쪽은 npm 에
같은 이름으로 있고 설치 없이 npx hanlint 글.md 로 바로 돈다.
pip install hanlint
pip install hanlint[kiwi]
npx hanlint 글.md
두 구현은 같은 규칙, 같은 fixture, 같은 출력이다. 지문 지도와 프로파일과 kiwi 정밀 모드는 파이썬 쪽에만 있다.
사용
마크다운 파일 하나를 주면 된다.
hanlint 글.md
지적마다 규칙 이름, 줄 번호, 인용 문장, 왜 문제인지가 붙는다. 기계가 고칠 수 있는 것은 고친 문장이 같이 온다. 첫 줄은 어느 설정을 읽었는지다. 종료 코드는 지적이 없으면 0, error 가 있으면 1 이라 발행 게이트에 그대로 물린다.
설정: hanlint.toml
글.md:12 [doublePassive] 결과가 저장되어집니다.
되어지 는 이중 피동이다. 피동 하나로 줄인다
고친 뒤: 결과가 저장됩니다.
기계가 확실히 고칠 수 있는 자리는 hanlint fix 글.md 가 원문에 적용하고 무엇을 바꿨는지 줄마다 보여 준다.
--dry-run 은 보여 주기만 한다. 다른 명령은 표에 있다.
| 명령 | 무엇 |
|---|---|
hanlint 글.md --format compact --errors-only |
한 줄에 지적 하나, error 만. AI 와 스크립트가 쓴다 |
hanlint - --path 초안.md |
stdin 으로 넣은 글을 그 이름으로 검사한다 |
hanlint 글.md --format json |
기계가 읽는 꼴. github 은 GitHub Actions 주석 |
hanlint fix 글.md |
번역투, 명령형 뒤 마침표, 이중 부정처럼 확실한 자리를 고친다 |
hanlint audit 글.md |
지문 지도와 분포. 색이 있는 자리가 구멍이다 |
hanlint map 글.md --format html |
지도를 단일 HTML 로 |
hanlint print 글.md --layer sentences |
문장, 문단, 절, 글의 지문을 JSON 으로. 층 하나만 고를 수 있다 |
hanlint rules |
규칙 목록 |
hanlint explain <규칙> |
규칙의 기술서. 왜, 어디서, 고치기, 안 잡는 것 |
hanlint init |
주석 달린 hanlint.toml |
hanlint profile build 글들/ |
승인된 글의 문체 분포. --profile 로 새 글을 견준다 |
hanlint diff 전.md 후.md |
두 초안의 짜임, 리듬, 지적 수의 변화 |
hanlint coverage review.json 글.md |
사람 평가자의 지적 가운데 hanlint 가 같은 자리를 집은 비율 |
백틱과 따옴표 안은 인용이라 사전 규칙과 지시어 규칙이 건너뛴다. 상투어를 인용하며 설명하는 글이 잡히지 않는다.
규칙을 끄기
글 전체에서 끄려면 hanlint init 이 만드는 hanlint.toml 의 disable 에 이름을 넣는다. 한 자리에서만
끄려면 마크다운 주석을 쓴다. 상투어를 인용하는 문단처럼 규칙이 맞지만 그 자리만 예외일 때다.
<!-- hanlint-disable cliche -->
AI 가 자주 쓰는 표현은 `핵심은`, `결국 중요한 것은` 처럼 눈에 띄는 것부터 지웁니다.
<!-- hanlint-enable cliche -->
hanlint-disable-next 는 다음 블록 하나만 끈다. 규칙 이름을 안 적으면 전부 끈다.
파이썬에서
같은 일을 함수로 한다.
from hanlint import lintText
for finding in lintText(text):
print(finding.line, finding.rule, finding.why)
lintFile, auditText, fingerprint 도 같은 자리에 있다.
커밋과 PR 에서
pre-commit 훅과 GitHub Action 이 저장소 루트에 있다. 훅은 .pre-commit-config.yaml 에서 이 저장소를
가리키면 되고, 액션은 지적을 PR 의 줄 주석으로 단다. VS Code 확장 (vscode/) 은 저장할 때 검사해
밑줄로 보여 주고 확정된 자리는 quick fix 로 고친다.
- uses: eddmpython/hanlint@main
with:
files: docs/글.md
errors-only: "true"
AI 에게 시키기
skills/use-hanlint/SKILL.md 를 에이전트의 스킬 폴더에 두면 AI 가 글을 쓴 직후 스스로 검사하고
지적이 0 이 될 때까지 고친다.
무엇을 잡나
잡는 것과 잡지 않는 것은 skills/specs/start/product.md 에 있다. 규칙 하나는 파일 하나이고 자기 기술서를 docstring 으로 든다.
라이선스
MIT 다.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hanlint-0.0.7.tar.gz.
File metadata
- Download URL: hanlint-0.0.7.tar.gz
- Upload date:
- Size: 221.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b9e56d2efabe910eed4ee8402b98bc174d944e526202af3ac6ce5d1d5d29d690
|
|
| MD5 |
ccdf45145933b405923979d1d66b907b
|
|
| BLAKE2b-256 |
9499879a4a7e9bfc5e14fe9c204e31aa8666393d29b8e28746919f51aee3e9d2
|
Provenance
The following attestation bundles were made for hanlint-0.0.7.tar.gz:
Publisher:
publish.yml on eddmpython/hanlint
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
hanlint-0.0.7.tar.gz -
Subject digest:
b9e56d2efabe910eed4ee8402b98bc174d944e526202af3ac6ce5d1d5d29d690 - Sigstore transparency entry: 2617011962
- Sigstore integration time:
-
Permalink:
eddmpython/hanlint@2da92d78e4c1f26fa879fb0302ebce0be0fe1abe -
Branch / Tag:
refs/tags/v0.0.7 - Owner: https://github.com/eddmpython
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2da92d78e4c1f26fa879fb0302ebce0be0fe1abe -
Trigger Event:
push
-
Statement type:
File details
Details for the file hanlint-0.0.7-py3-none-any.whl.
File metadata
- Download URL: hanlint-0.0.7-py3-none-any.whl
- Upload date:
- Size: 157.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a36d5ae863695e1d8bb289f26454da79d971c7f2b0ec5a3aa83de25dd2e42a1f
|
|
| MD5 |
419e763e4e17071c69a0038de46562ca
|
|
| BLAKE2b-256 |
264fbf2f0c09a5dc881bb24669a944577ded0b9b262a89713ab11d736dd0f1f9
|
Provenance
The following attestation bundles were made for hanlint-0.0.7-py3-none-any.whl:
Publisher:
publish.yml on eddmpython/hanlint
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
hanlint-0.0.7-py3-none-any.whl -
Subject digest:
a36d5ae863695e1d8bb289f26454da79d971c7f2b0ec5a3aa83de25dd2e42a1f - Sigstore transparency entry: 2617012145
- Sigstore integration time:
-
Permalink:
eddmpython/hanlint@2da92d78e4c1f26fa879fb0302ebce0be0fe1abe -
Branch / Tag:
refs/tags/v0.0.7 - Owner: https://github.com/eddmpython
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2da92d78e4c1f26fa879fb0302ebce0be0fe1abe -
Trigger Event:
push
-
Statement type:
