콘텐츠로 이동
Search

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 인자는 읽을 수만 있고 쓸 수는 없음

See also

Favorite site

author Zer0, MCPBot sitemap