Substituto para o uso rdoc
Pergunta
De acordo com a este post , RDoc :: uso não está actualmente disponível no ruby ??1.9. Existem bons substitutos disponíveis?
Eu estaria interessado em ouvir o que está disponível a partir da instalação padrão, bem como o que está disponível a partir de pedras preciosas.
Solução
Eu gosto OptionParser (o coisa que o artigo menciona que RDoc::usage
é útil para complementar).
Parece que nenhum de 1,9 erros foram corrigidos .
Outras dicas
Na pedido de recurso 2713 , o mantenedor rdoc afirmou que ele won 't add rdoc / uso ou qualquer recurso novamente semelhante ao rdoc, dizendo que OptionParser deve ser utilizado.
Nós usamos OptionParser para todos os novos roteiros, mas tinha cerca de 100+ que RDoc usado. Em vez de reescrever cada um que eu escrevi este método (BB é namespace. Mudança da nossa empresa que para o que quiser). Ele funciona muito bem. A sintaxe é um pouco diferente, mas o seu texto de ajuda para que não me importo. Espero que ajude!
Então, usei sed para encontrar todos os scripts e alterá-las.
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