metacode - Eylem yorumlarını standartlaştırmak için bildirimsel yorum dili ve ayrıştırıcı

• Python ekosistemindeki lint, formatter, type checker ve coverage araçlarının kullandığı özel yorumları (action comment) tek bir standartta birleştirmek için önerilen bir kütüphane
• # noqa, # fmt: off, # type: ignore gibi fiilen yaygınlaşmış ama standardı olmayan yorum sözdizimindeki karmaşayı çözmeyi amaçlıyor
• Python sözdiziminin bir alt kümesini kullanan hafif bir yorum dili (metacode) tanımlıyor
  • Araç, eylem ve argümanları key: action[arguments] biçiminde açıkça ayırıyor
• Tek bir kod satırında birden fazla araç için yorumun güvenle bir arada bulunmasını destekleyen bir yapı sunuyor
  • # type: ignore # fmt: off gibi birleşik kullanımları işleyebiliyor
• Yorum ayrıştırma için resmî bir ayrıştırıcı (parse) sunarak her aracın ayrı ayrı uyguladığı string ve regex tabanlı ayrıştırma mantığını ortadan kaldırıyor
• Argüman türü olarak string, sayı, bool, None, ellipsis vb. destekliyor; gerektiğinde AST tabanlı genişletilmiş ayrıştırma da mümkün
• Belirli anahtarları seçerek ayrıştırabildiği için araç bazında yorumları ayırarak işleme için uygun
• Yorumları otomatik üretip eklemek için bir insert API sağlıyor
• Sözdiziminin kendisi Python'a bağımlı olmayacak şekilde EBNF biçiminde tanımlandığı için başka dillerde de uygulanabilir