rdocの置き換え

Question

this postによると、現在RDoc :: usageはruby 1.9では使用できません。良い代替品はありますか？

私は、標準インストールから入手可能なものだけでなく、宝石から入手可能なものを聞くことに興味があります。

Answer 1

私はOptionParserが好きです（記事にはRDoc::usageが補完するのに便利です）。

これは1.9バグのようです（have been patched）。

Answer 2

feature request 2713では、rdoc/maintainerやrdocに類似の機能をrdocに追加しないで、代わりにOptionParserを使うべきだとrdocの管理者は述べています。

Answer 3

すべての新しいスクリプトにOptionParserを使用しましたが、RDocを使用していたのは約100+人でした。それぞれを書き直すのではなく、私はこのメソッドを書きました（BBは私たちの会社の名前空間です。あなたが好きなものに変更してください）。それは素晴らしい作品です。構文は少し異なりますが、ヘルプテキストではわかりません。それが役に立てば幸い！

その後、sedを使用してすべてのスクリプトを見つけて変更しました。

grep -rl "RDoc::usage" * | xargs sed -i "/rdoc\/usage/ s/RDoc/BB/" 
grep -rl "BB::usage" * | xargs sed -i "/rdoc\/usage/ s/rdoc/lib\/bb/" 

-

module BB 
    def BB::usage(exit_code) 

     File::open($0, 'r').readlines.each_with_index do | line, idx | 
      next if idx == 0 
      if(line =~ /^#/) 
       puts line.gsub(/^#\ ?/,'') 
      else 
       puts #RDoc adds extra line so we do too 
       exit(exit_code) 
      end 
     end 
    end 
end