bsddialog 1.0

The bsddialog project provides bsddialog and libbsddialog, an utility and a library to build TUI dialogs and widgets.
The version 1.0 is out!

% git clone https://gitlab.com/alfix/bsddialog.git
% cd bsddialog
% make
% ./bsddialog --msgbox "`./bsddialog --version`" 0 0

Version 1.0 Highlights

New features: dynamic exit codes, new environments variables, generic buttons, startup theme file, --datebox-format d/m/y | m/d/y | y/m/d, other escapes for --text-escape, comments in --save-theme output file.

Important changes: --generic-button1 -> --right1-button, --generic-button2 -> right2-button, --no-names and --no-descriptions mutually exclusive.

The library has some API change (see CHANGELOG), feel free to contact me for any explanation.

CHANGELOG:

2023-08-01 Version 1.0

    Utility:
    * add: comments to --save-theme output file.
    * add: blink, halfbright, highlight to --save-theme and --load-theme.
    * add: theme.menu.[f_]prefixcolor to --save-theme and --load-theme.
    * add: --datebox-format <d/m/y|m/d/y|y/m/d> to set --datebox UI.
    * add: --help-print-items (--help-status becomes alias).
    * add: --text-escape (--colors becomes alias).
    * add: new escapes \Zd, \Zk, \Zs, \ZD, \ZK, \ZS, for --text-escape.
    * add: env NO_COLOR, to set blackwhite theme.
    * add: $HOME/.bsddialog.conf startup theme file.
    * add: env BSDDIALOG_THEMEFILE startup theme file.
    * add: --left1-button <label>.
    * add: --left2-button <label>.
    * add: --left3-button <label>.
    * add: --right1-button <label>.
    * add: --right2-button <label>.
    * add: --right3-button <label>.
    * add: dynamic exit codes.
        - add: --error-exit-code.
        - add: --ok-exit-code.
        - add: --cancel-exit-code.
        - add: --help-exit-code.
        - add: --extra-exit-code.
        - add: --timeout-exit-code.
        - add: --esc-exit-code.
        - add: --left1-exit-code.
        - add: --left2-exit-code.
        - add: --left3-exit-code.
        - add: --right1-exit-code.
        - add: --right2-exit-code.
        - add: --right3-exit-code.
        - add: env BSDDIALOG_ERROR.
        - add: env BSDDIALOG_OK.
        - add: env BSDDIALOG_CANCEL.
        - add: env BSDDIALOG_HELP.
        - add: env BSDDIALOG_EXTRA.
        - add: env BSDDIALOG_TIMEOUT.
        - add: env BSDDIALOG_ESC.
        - add: env BSDDIALOG_LEFT1.
        - add: env BSDDIALOG_LEFT2.
        - add: env BSDDIALOG_LEFT3.
        - add: env BSDDIALOG_RIGHT1.
        - add: env BSDDIALOG_RIGHT2.
        - add: env BSDDIALOG_RIGHT3.
    * add: undocumented envs for bsdconfig(8) compatibility.
        - env BSDDIALOG_COMPATRC for use_shadow setting.
        - env BSDDIALOG_ITEM_HELP to add/set exit code.
    * change: rename themes --theme <3d|blackwhite|flat>.
    * change: --no-names and --no-descriptions mutually exclusive (via lia).
    * change: quote only checklist output items if necessary. Previously
        also radiolist item.
    * change: dialogs with user input print always values except with ERROR,
        ESC, Cancel. Previously the situation was quite heterogeneous.
    * improve: DIAGNOSTIC messages adding fmt string errors.
    * improve: disable theme setting (opt and env) with no-color terminals.
    * improve: menus on|off status (strcasecmp, diagnostic, real off check).
    * improve: --bikeshed with button delimiter and --date-format.
    * improve: --textbox accepts button options.
    * improve: Forms with Help button.
        - print "HELP" (like menus).
        - accept --help-list-items.
        - accept --help-print-name.
    * fix: --load-theme attributes.
    * fix: --clear-screen with --and-dialog.
    * delete: --theme <bsddialog> (partially implemented).
    * delete: --esc-return-cancel (replaced by new env and option).
    * delete: --generic-button1 (replaced by --right1-button).
    * delete: --generic-button2 (replaced by --right2-button).
    * refactor: modularize in more files (main, cli, builders, theme).

    Library:
    * add: bsddialog_inmode().
    * add: bsddialog_clear(y) for utility --clear-screen.
    * add: bsddialog_refresh() for utility terminal mode options.
    * add: conf.date.format="d/m/y"|"m/d/y"|"y/m/d" to customize
        bsddialog_datebox() UI (boxes) with a date format.
    * add: 'const char *end' to bsddialog_gauge().
    * add: draw focus on the shortcut-key-selected button at exit.
    * add: escapes for conf.text.highlight \Zd, \Zk, \Zs, \ZD, \ZK, \ZS.
    * add: other theme flags.
        - BSDDIALOG_BLINK.
        - BSDDIALOG_HALFBRIGHT.
        - BSDDIALOG_HIGHLIGHT.
    * add: generic buttons.
        - conf.button.left1_label, BSDDIALOG_LEFT1 return value.
        - conf.button.left2_label, BSDDIALOG_LEFT2 return value.
        - conf.button.left3_label, BSDDIALOG_LEFT3 return value.
        - conf.button.right1.label, BSDDIALOG_RIGHT1 return value.
        - conf.button.right2.label, BSDDIALOG_RIGHT2 return value.
        - conf.button.right3.label, BSDDIALOG_RIGHT3 return value.
    * add: unused bsddialog_menugroup.min_on for future features.
    * add: theme.menu.f_prefixcolor and theme.menu.prefixcolor.
    * improve: check (when possible) API pointers.
    * improve: circolar buttons with left and right keys for msgbox, yesno,
        menus, rangebox and pause.
    * improve: bsddialog_textbox() handles conf.buttons.
    * improve: bsddialog_datebox() a box change affects the others as well.
    * improve: bsddialog_geterror() with fmt strings.
    * change: API NULL strings handled like "", except gauge *sep and *end.
    * change: menus and form less restrictive with text, hide text with
        little screens (same behavior as other dialogs).
    * change: mixedgauge BSDDIALOG_MG_BLANK does not draw minibar but prints
        minilabel. The change allows mixedgauge to add sections. To restore
        the previous behavior setting minilabel to "".
    * change: check/set bsddialog_gauge() perc max 100.
    * change: check/set bsddialog_mixedgauge() mainperc max 100.
    * change: conf.menu.no_name and conf.menu.no_desc mutually exclusive.
    * change: bsddialog_pause() sec -> *sec to know remaining time at exit.
    * change: add *focusitem to bsddialog_form() like menus.
    * change: "pointer" values are always set except when BSDDIALOG_ERROR
        occurs. Examples *yy/*mm/*ss, rangebox *value.
        - delete conf.menu.on_without_ok.
        - delete conf.form.value_without_ok.
    * rename: conf.text.highlight -> conf.text.escape.
    * rename: theme.menu.namesepcolor -> theme.menu.sepnamecolor.
    * rename: theme.menu.descsepcolor -> theme.menu.sepdesccolor.
    * fix: bsddialog_pause() elevation bar after resize.
    * fix: bsddialog_textbox() key '0'.
    * fix: timebox.c checksize (boxes width).
    * fix: extend menurows after shrink and enlarge.
    * fix: menu pad and form pad "re-expansion" after shrink and enlarge.
    * fix: shadow top-left corner (trick wresize() before wmove()).
    * fix: increment bsddialog_total_progview size for more general use.
    * delete: BSDDIALOG_THEME_BSDDIALOG (partially implemented).
    * delete: conf.button.generic1_label (for new conf.button.right1_label).
    * delete: BSDDIALOG_GENERIC1 return value (new BSDDIALOG_RIGHT1).
    * delete: conf.button.generic2_label (for new conf.button.right2_label).
    * delete: BSDDIALOG_GENERIC2 return value (new BSDDIALOG_RIGHT2).
    * delete: bsddialog_clearterminal(), replaced by bsddialog_clear(y).
    * refactor: internal implementation.
        - add: internal structures to represent components.
        - merge: (when possible) dialogs autosize.
        - merge: (when possible) dialogs checksize.
        - merge: for each dialog "build" with "update" -> <dialog>_redraw().
        - merge: new_dialog() with update_dialog() -> draw_dialog().
        - merge: infobox.c with messagebox.c (delete infobox.c)
        - merge: bsddialog_datebox() + bsddialog_calendar() -> datebox.c
        - change: flat and blackwhite real themes, 3d adapted from flat.
        - improve: replace wrefresh() -> wnoutrefresh()/doupdate().
        - improve: replace prefresh() -> pnoutrefresh()/doupdate().
        - improve: menu split code to build private items.
        - improve: form split code to build private items.
        - delete: -Wno-implicit-fallthrough.

Extra Info

• Manual Utility bsddialog(1).
• Manual Library bsddialog(3).
• README and examples https://gitlab.com/alfix/bsddialog.