typesafe-docs/commander-mangen
Generate man pages from a commander.js program, including every subcommand's options.
Hızlı değerlendirme
Özet
commander.js komut ağacından alt komutların seçeneklerini de içeren roff man sayfaları üreten bir TypeScript kütüphanesidir.
Profiline uyum
commander.js CLI araçları için man sayfaları üretmesi profilinizde belirtilen ürün geliştirme ihtiyaçlarıyla örtüşmüyor.
Neden yükseliyor
Bir günlük repo yaşında 33 yıldız almış; README, commander.js alt komut seçeneklerinin help2man çıktısında kaybolmasını somut bir örnekle gösteriyor. Yükselişin kaynağı veya son dönem aktivitesi ölçüm verilerinden doğrulanamıyor.
Problem
help2man gibi araçlar CLI çıktısını taradığı için aynı process içindeki alt komutların kendi seçeneklerini man sayfalarına aktaramayabilir.
Çözüm
Metin tabanlı --help çıktısını ayrıştırmak yerine commander.js Command ağacını doğrudan dolaşır ve her görünür komut için ayrı man sayfası üretir; sayfaları içerik olarak döndürebilir veya diske yazabilir.
Yenilik
commander.js Command ağacını doğrudan okuyup her alt komut için roff man sayfası üretmesi, bu parser ekosistemi için odaklı bir çözüm. Genel olarak man sayfası üretimi yeni değil; yenilik kapsamı commander.js ile alt komut entegrasyonunda.
Teknolojiler
- TypeScript
- Node.js
- commander.js
- roff
Riskler
- Repo yalnızca bir günlük; sürdürülebilirlik, bakım ve gerçek kullanım hakkında henüz yeterli kanıt yok.
- Son 28 günlük commit ve farklı yazar verileri ölçülmemiş; yıldız sayısı tek başına bakım veya kalite göstergesi değil.
- README, commander 15.x ile test edildiğini belirtiyor; diğer sürümlerle uyumluluk bilgisi verilmemiş.
- README'deki help2man karşılaştırması örnek bir CLI üzerinden; farklı komut ağacı özellikleri ve roff uç durumları için kapsamlı doğrulama bilgisi sunulmuyor.
Detaylı değerlendirme
Bu repo için detaylı değerlendirme henüz yapılmadı. Analiz, Ayarlar'daki uyum profilini hesaba katarak "bu işime yarar mı" sorusunu cevaplıyor. Bir kez çalışır; günlük koşular buna dokunmaz. Saatlik sınır var — bir kaynaktan en fazla 3 analiz.