Metacode
lastmod 2026-11-16created 2026-01-113 edits
metacode는 Python 도구들이 쓰는 액션 주석(# noqa, # type: ignore 같은 특수 주석)의 문법을 하나로 정하자는 제안과, 그 문법을 읽는 Python 파서 라이브러리이다. 린터·포매터·커버리지 도구가 저마다 정규식이나 문자열 처리로 주석을 해석하는 탓에 사용자는 도구별 규칙을 외워야 하고, 한 줄에 두 도구의 주석을 함께 달았을 때 제대로 동작하는지도 보장되지 않는다. metacode 는 Python 문법의 부분집합으로 된 공통 형식을 정하고, 도구 제작자가 바로 가져다 쓸 수 있는 파서를 제공한다.
About
- 예로 드는 기존 주석: Ruff·Vulture 의
# noqa, Black·Ruff 의# fmt: off, Mypy 의# type: ignore, Coverage 의# pragma: no cover, isort 의# isort: skip, Bandit 의# nosec - 주석 하나는 키(대개 도구 이름), 액션, 대괄호 안의 인자 목록으로 이뤄짐.
# type: ignore[error-code]에서 키는type, 액션은ignore, 인자는error-code - 인자는 식별자, 하이픈으로 이은 식별자, 문자열·숫자·복소수 리터럴,
True/False/None/...를 허용함. 그 밖의 식은 옵션을 켜면 AST 노드로 받음 - 한 줄에
#로 여러 주석을 이어 쓸 수 있고, 형식에 맞지 않는 일반 주석은 파서가 무시함 - 코드를 실행하지 않고 문법만 Python 에서 빌려 옴. 다른 언어로 구현할 수 있게 안전한 부분집합의 EBNF 문법을 README 에 공개함
- MIT 라이선스
Features
-
pip install metacode로 설치 -
parse(주석, 키)는 지정한 키의 주석만 골라ParsedComment(key, command, arguments)목록으로 돌려줌. 키를 리스트로 넘기면 여러 도구의 주석을 함께 읽음 -
allow_ast=True면 임의의 식을 AST 노드로 받고, 끄면UnknownArgumentTypeError를 냄.ignore_case=True로 키의 대소문자를 무시함 -
insert()는 기존 주석 앞(또는at_end=True면 뒤)에 새 액션 주석을 끼워 넣은 문자열을 만듦. AST 인자는 읽을 수만 있고 쓸 수는 없음