- Pythonエコシステムの lint・formatter・type checker・coverage ツールが使う特殊コメント(action comment)を1つの標準に統合するために提案されたライブラリ
# noqa, # fmt: off, # type: ignore のような事実上の慣習ではあるが標準のないコメント構文の混乱を解消することが目的
- Python文法の部分集合を使う**軽量コメント言語(metacode)**を定義
key: action[arguments] 形式でツール・動作・引数を明確に分離
- 1つのコード行に複数ツール向けコメントを安全に共存させる構造をサポート
# type: ignore # fmt: off のような組み合わせを処理可能
- コメント解析のための**公式パーサー(parse)**を提供し、各ツールがばらばらに実装していた文字列・正規表現による解析ロジックを排除
- 引数型として文字列、数値、bool、None、ellipsis などをサポートし、必要に応じてASTベースの拡張解析も可能
- 特定の key だけを選択的に解析できるため、ツールごとのコメント分離処理に適している
- コメントを自動生成・挿入するinsert APIを提供
- 構文自体はPythonに依存しないようEBNF形式で仕様化されており、他言語での実装も可能
まだコメントはありません。