Fish-shell: `--help`から補完を生成するスクリプト

作成日 2017年12月25日  ·  3コメント  ·  ソース: fish-shell/fish-shell

多くのコマンドラインツールには、補完を自動的に生成するために解析できるオプション--helpあります。 結果が100%完璧でなかったとしても、これは魚の完成を提供するためにバーを下げるために非常に貴重です。 これは確かに重要な事業ですが、私が考える価値のある投資です。

duplicate

最も参考になるコメント

マニュアルページから補完を生成する方法があるようですか?

はい-https://github.com/fish-shell/fish-shell/blob/master/share/tools/create_manpage_completions.py。 これは、fishが初めて起動されたときに実行され、 fish_update_completions実行することで更新できます。

これはおそらく重要なコンテキストです-すでにmanページを解析できる場合(これは安全です)、「-help」を持つ(または「-h」または「-?」)ですが、manページはありません。

また、そのスクリプトは、補完を生成する際の制限を示しています。ほとんど許容できるレベルの品質にオプションを実行できますが(説明はしばしば悪いですが)、それ以外のものは十分に標準化されていません。

全てのコメント3件

これは#4081ですでに尋ねられており、私はそれがまだ当てはまる閉鎖の論理的根拠のように感じます。

繰り返しますが:

  • 盲目的にsomecommand --help呼び出すのは危険です

  • 生成された補完は、手書きの補完よりもはるかに有用ではありません

  • これはたくさんの仕事です

  • 代わりにmanページを作成する場合は、アップストリームプロジェクトも支援します

だから私はそれが価値があるとは思わない。

4981は、オンザフライでの完了を示唆しているようです。 私は、完了スクリプトを「プリコンパイル」するスクリプト、つまりcompleteへの一連の呼び出しを意味しました。 これは、100%完璧ではないという意味です。手動で編集する必要があるかもしれません。 一方、あなたが書いたものから、manページから完成を生成する方法があるように思われますか?

マニュアルページから補完を生成する方法があるようですか?

はい-https://github.com/fish-shell/fish-shell/blob/master/share/tools/create_manpage_completions.py。 これは、fishが初めて起動されたときに実行され、 fish_update_completions実行することで更新できます。

これはおそらく重要なコンテキストです-すでにmanページを解析できる場合(これは安全です)、「-help」を持つ(または「-h」または「-?」)ですが、manページはありません。

また、そのスクリプトは、補完を生成する際の制限を示しています。ほとんど許容できるレベルの品質にオプションを実行できますが(説明はしばしば悪いですが)、それ以外のものは十分に標準化されていません。

このページは役に立ちましたか?
0 / 5 - 0 評価