Unfortunately, this requires a few bash-isms. I'd like to get rid of them, but at the moment, it does require something that implements the Bash interface, such as bash, zsh, etc.
Dash and others won't work.
Well, it has been done before. Like Shell Curses, implemented in ksh.
Partly, I've made this because I can.
Partly because I now know far more about ANSI escapes than I want.
Partly to show that every CLI-manipulation question doesn't need to be answered with 'use curses'.
No. Object-Oriented isn't a good fit for shell, and curses API is famously hated.
That depends heavily on how difficult it is to accomplish. However, go ahead and open an Issue or send me an email, etc.
I'm sorry. I really want to.
Unfortunately, copyright is incredibly complicated.
When I decided that damned should be Public Domain, I found I can't even make my own work Public Domain, in my country.
I can use the Creative Commons 0 License, which I have, but that would mean everyone who contributes would have to do the same... And I can't assess whether or not that is actually legally binding in any way.
Please, please, go yell at your government about it. Mine too.
# Load the framework, assuming it is in the same folder
. ./damned
# Access via the damned function...
damned fg red
echo 'This is red!'
damned bg blue
echo 'This is red text on a blue background!'
sleep 2s
damned clear screen
damned term uncook
damned echo disable
key=$(damned getch)
if [ "$key" = '119' ]; then
damned cursor up
fi
damned term restore
sleep 2s
damned clear screen
Things you need to know:
damneddoes not parse the termcap file to see whether a method is available within your user's current terminal emulator. It will assume that if you call it, it can be done.damnedtraps theEXITsignal with a cleanup helper,damned_cleanup. If you override that trap, make sure you call it on exit.damnedtraps theWINCHsignal with the helper:damned_window_size. If you override that trap, make sure you call it in your own signal handler.damned_*is reserved bydamned.damnedis reserved bydamned.
The exact functions and variables made available by the framework for the user is in the API.md document.
Creative Commons 0 License.
As close to Public Domain as I can.
See LICENSE for the exact legal code, and ramifications for you, which should mostly be relief, not irritation.