- 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
Henüz yorum yok.