4.8 KiB
4.8 KiB
bash-tui-toolkit
Toolkit to create simple Terminal UIs using plain bash builtins
Goals
- provide a simple and clear default set of elements to use creating an interactive terminal UI
- be clean and minimalistic
- zero dependencies to be installed
- parts can be used separately
Install
- Download the bundle (entire lib) or single compoennt from releases
- Source the bundle in your script or embed
Documentation
For a list of available modules and their documentation please check the docs/modules folder
Tested with
- Ubuntu 20
- Ubuntu 22
- Alpine 3
- MacOS
- Windows (Git Bash)
Development
Requirements
- bash 4+
- docker 19+
- GNU make
Generate documentation
To update the module documentation you just need to run
make generate-docs
This builds the documentation inside a docker container and updates the repo locally. Afterwards just commit the docs with your code changes
Build
To combine the script(s) you just need to run
make build
The combined artifacts can be found in dist/
Alternatives
- kahkhang/Inquirer.sh - List, Checkbox and Text Input with more advanced validation