Fish-shell: Script para gerar a conclusão de `--help`

Criado em 25 dez. 2017  ·  3Comentários  ·  Fonte: fish-shell/fish-shell

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.

duplicate

Comentários muito úteis

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.

Todos 3 comentários

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.

4981 parece sugerir conclusão imediata. Eu quis dizer um script para “pré-compilar” um script de conclusão, ou seja, uma sequência de chamadas para 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.

Esta página foi útil?
0 / 5 - 0 avaliações