Awesome
Minimalist selector in shell, à la fzf
what's it for ?
You need to:
- select between several choices ?
- in a shell script ?
- with minimal dependencies ?
Just copy the fsh function in your script.
usage example
$ echo -e 'Hello, world!\n¡Hola, mundo!\nBonjour, le monde !\nHallo, Welt!' | ./fsh
Hello, world!
¡Hola, mundo!
Bonjour, le monde !
Hallo, Welt!
>
type your text
Hallo, Welt!
> hall
Press enter
Hallo, Welt!
limitations
- not POSIX shell: it's only tested in
zshandbash. - to keep it lightweight and fast, I (mostly) don't plan on adding new features.
variables reference
<details> <summary>You can customize the behavior of fsh by setting the following variables:</summary>| Variable | Description | Default value |
|---|---|---|
| FSH_SELECTOR_COLOR | the color line currently highlighted | 40 |
| FSH_FRAME_COLOR | the color of the frame | 30 |
| FSH_PROMPT_COLOR | the color used for the prompt | 34 |
| FSH_SELECT_COLOR | the color of the sign before the line currently selected | 31 |
| FSH_TEST_INPUT | the simulated user input given as a string, one character at a time. first character will be ignored. if set the script will not read from stdin | "" |
| FSH_HEADER | a name to display beofre the prompt to give context on what is expected | "" |
| FSH_VIM_MODE | (not implemented) set this variable to support vim normal mode | "" |
| FSH_PERF | if this variable is set, will display the time it took to draw the interface | "" |
| FSH_NO_FUZZY | if this variable is set, will not use fuzzy search, instead will do a pattern match | "" |
| FSH_LINES | the height of the terminal (used for testing, otherwise will be set by tput) | $t_lines |
| FSH_COLUMNS | the width of the terminal (used for testing, otherwise will be set by tput) | $t_cols |
| FSH_SCREENSHOT | if this variable is set, will write a screenshot of the terminal at each iteration and generate an animation at the end | "" |