Fish-shell: Script untuk menghasilkan penyelesaian dari `--help`

Dibuat pada 25 Des 2017  ·  3Komentar  ·  Sumber: fish-shell/fish-shell

Banyak alat baris perintah memiliki opsi --help yang dapat diurai untuk menghasilkan penyelesaian secara otomatis. Bahkan jika hasilnya tidak 100% sempurna, ini akan sangat berharga untuk menurunkan standar untuk memberikan penyelesaian ikan. Ini tentu saja merupakan usaha yang signifikan tetapi saya rasa merupakan investasi yang layak.

duplicate

Komentar yang paling membantu

sepertinya ada cara untuk menghasilkan penyelesaian dari halaman manual?

Ya - https://github.com/fish-shell/fish-shell/blob/master/share/tools/create_manpage_completions.py. Ini dijalankan pertama kali ikan dimulai, dan dapat di-refresh dengan menjalankan fish_update_completions .

Yang mungkin merupakan sedikit konteks yang penting - ketika Anda sudah dapat mengurai halaman manual (yang aman), sebenarnya tidak ada kebutuhan nyata untuk mengurai output "--help" untuk sangat sedikit utilitas yang memiliki "--help" (atau itu "-h" atau "-?") tetapi tidak ada halaman manual.

Juga skrip itu menunjukkan batasan menghasilkan penyelesaian - Anda dapat melakukan opsi ke tingkat kualitas yang sebagian besar dapat diterima (meskipun deskripsinya sering buruk), tetapi hal lain tidak cukup standar.

Semua 3 komentar

Ini sudah ditanyakan di #4081, dan saya merasa alasan penutupan itu masih berlaku.

Untuk mengulangi:

  • Menelepon secara membabi buta somecommand --help berbahaya

  • Penyelesaian yang dihasilkan jauh lebih tidak berguna daripada yang ditulis tangan

  • Ini banyak pekerjaan

  • Jika Anda ingin menulis halaman manual, Anda juga akan membantu proyek hulu

Jadi saya merasa tidak layak.

4981 tampaknya menyarankan penyelesaian on-the-fly. Maksud saya skrip untuk "pra-kompilasi" skrip penyelesaian, Yaitu urutan panggilan ke complete . Inilah yang saya maksud dengan tidak 100% sempurna: beberapa pengeditan manual mungkin diperlukan. Di sisi lain, dari apa yang Anda tulis, sepertinya ada cara untuk menghasilkan penyelesaian dari halaman manual?

sepertinya ada cara untuk menghasilkan penyelesaian dari halaman manual?

Ya - https://github.com/fish-shell/fish-shell/blob/master/share/tools/create_manpage_completions.py. Ini dijalankan pertama kali ikan dimulai, dan dapat di-refresh dengan menjalankan fish_update_completions .

Yang mungkin merupakan sedikit konteks yang penting - ketika Anda sudah dapat mengurai halaman manual (yang aman), sebenarnya tidak ada kebutuhan nyata untuk mengurai output "--help" untuk sangat sedikit utilitas yang memiliki "--help" (atau itu "-h" atau "-?") tetapi tidak ada halaman manual.

Juga skrip itu menunjukkan batasan menghasilkan penyelesaian - Anda dapat melakukan opsi ke tingkat kualitas yang sebagian besar dapat diterima (meskipun deskripsinya sering buruk), tetapi hal lain tidak cukup standar.

Apakah halaman ini membantu?
0 / 5 - 0 peringkat