diff options
author | Dieter Plaetinck <dieter@plaetinck.be> | 2010-12-28 22:58:06 +0100 |
---|---|---|
committer | Dieter Plaetinck <dieter@plaetinck.be> | 2010-12-28 22:58:06 +0100 |
commit | cb9574bb64d994d91e52069840f8e06995bc3843 (patch) | |
tree | 6a5ea5b6ef1e82a3935e8497a87c47cbf9548fb3 /README | |
parent | 3e7db21be1b46cdec5a1c979e3633b1b54ecfb7a (diff) |
more elaborate readme
Diffstat (limited to 'README')
-rw-r--r-- | README | 22 |
1 files changed, 19 insertions, 3 deletions
@@ -1,6 +1,22 @@ -a shell library providing useful UI functions for shell scripts -originally part of AIF (http://github.com/Dieterbe/aif) +== A library providing UI functions for shell scripts == -dependencies: +When you write bash/shell scripts, do you write your own error/debug/logging/abort functions? +Logic that requests the user to input a boolean, string, password, selection out of a list, +date/time, integer, ... ? + +Libui-sh is written to take care of all that. +libui-sh is meant to a be a general-purpose UI abstraction library for shell scripts. +Low impact, easy to use, but still flexible. +cli by default, can optionally use ncurses dialogs as well. + +To start using it, you only need to source it and you can start calling its functions. +To reconfigure it (i.e. to change UI type, debug settings, logfile location), +just run the command libui_sh_init + +The library is not strictly a UI library, it also contains a few useful functions like +check_is_in (check if an element can be found in a set - usually an array) and +seteditor (interactive $EDITOR selection) + +Dependencies: - bash (for cli interface) - optionally: dialog (for ncurses interface) |