Muitas ferramentas de linha de comando têm uma opção --help
que pode ser analisada para gerar conclusões automaticamente. Mesmo se o resultado não fosse 100% perfeito, isso seria inestimável para diminuir a barra e fornecer completação de peixe. Este é certamente um empreendimento significativo, mas um investimento valioso, eu acho.
Isso já foi perguntado em # 4081, e sinto que a justificativa para o fechamento ainda se aplica.
Reiterar:
Chamar somecommand --help
cegas é perigoso
As conclusões geradas são muito menos úteis do que as escritas à mão
Isso é um monte de trabalho
Se você, em vez disso, escrever uma página de manual, também ajudará o projeto upstream
Então, não acho que vale a pena.
complete
. Isso é o que eu quis dizer com não 100% perfeito: alguma edição manual pode ser necessária. Por outro lado, pelo que você escreveu, parece que existe uma maneira de gerar preenchimento a partir de páginas de manual?parece que existe uma maneira de gerar conclusão a partir de páginas de manual?
Sim - https://github.com/fish-shell/fish-shell/blob/master/share/tools/create_manpage_completions.py. Isso é executado na primeira vez que o fish é iniciado e pode ser atualizado executando fish_update_completions
.
O que é provavelmente uma parte importante do contexto - quando você já pode analisar as páginas do manual (o que é seguro), não há realmente nenhuma necessidade de analisar a saída "--help" para os poucos utilitários que têm "--help" (ou é é "-h" ou "-?"), mas nenhuma página de manual.
Além disso, esse script mostra as limitações de geração de conclusões - você pode fazer opções até um nível de qualidade aceitável (embora as descrições sejam frequentemente ruins), mas qualquer outra coisa não é padronizada o suficiente.
Comentários muito úteis
Sim - https://github.com/fish-shell/fish-shell/blob/master/share/tools/create_manpage_completions.py. Isso é executado na primeira vez que o fish é iniciado e pode ser atualizado executando
fish_update_completions
.O que é provavelmente uma parte importante do contexto - quando você já pode analisar as páginas do manual (o que é seguro), não há realmente nenhuma necessidade de analisar a saída "--help" para os poucos utilitários que têm "--help" (ou é é "-h" ou "-?"), mas nenhuma página de manual.
Além disso, esse script mostra as limitações de geração de conclusões - você pode fazer opções até um nível de qualidade aceitável (embora as descrições sejam frequentemente ruins), mas qualquer outra coisa não é padronizada o suficiente.