Substituto para o uso rdoc

Question

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.

Answer 1

Eu gosto OptionParser (o coisa que o artigo menciona que RDoc::usage é útil para complementar).

Parece que nenhum de 1,9 erros foram corrigidos .

Answer 2

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.

Answer 3

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