- Library yang diusulkan untuk menyatukan special comment (action comment) yang digunakan oleh lint, formatter, type checker, dan alat coverage di ekosistem Python ke dalam satu standar
- Bertujuan mengatasi kebingungan sintaks komentar yang de facto menjadi kebiasaan tetapi tidak memiliki standar, seperti
# noqa, # fmt: off, dan # type: ignore
- Mendefinisikan bahasa anotasi ringan (metacode) yang menggunakan subset dari tata bahasa Python
- Memisahkan tool, aksi, dan argumen secara jelas dalam bentuk
key: action[arguments]
- Mendukung struktur agar komentar untuk beberapa tool dapat hidup berdampingan dengan aman dalam satu baris kode
- Dapat menangani kombinasi seperti
# type: ignore # fmt: off
- Menyediakan parser resmi (parse) untuk parsing komentar, sehingga menghilangkan logika parsing string dan regex yang sebelumnya diimplementasikan masing-masing tool
- Mendukung tipe argumen seperti string, angka, bool, None, ellipsis, dan bila perlu memungkinkan parsing ekstensi berbasis AST
- Dapat mem-parsing hanya key tertentu secara selektif sehingga cocok untuk pemrosesan komentar terpisah per tool
- Menyediakan API insert untuk membuat dan menyisipkan komentar secara otomatis
- Sintaksnya sendiri dispesifikasikan dalam bentuk EBNF agar tidak bergantung pada Python dan memungkinkan implementasi di bahasa lain
Belum ada komentar.