message

if shellm-ndef; then
shellm-define

## @file message.sh
## @brief Provide useful message functions

shellm source core/format.sh

## @fn void color (color, message)
## @brief Set the color to color, and output message if given
## @param $1 Color to use (see baseColor(3) and envColor(3))
## @param [$2] Message to display (reset to default color after display)
## @return Echo: Color code [and message]
color() { [ -z "$2" ] && echo -e -n "$1" || echo -e "$1$2\033[00m"; }

## @fn int final (exit_code)
## @brief Exit if subshell, return if interactive shell
## @param [$1] Exit code
## @return Code: exit_code (default 1)
final() {
  case "${0#-}" in
    bash|zsh|csh|ksh|sh|dash)
      kill -INT $$ ;;
    *) exit "${1:-1}" ;;
  esac
}

_status_message() {
  local msg="$1"
  shift
  format "$@" >&2
  printf " %-7s " "${msg}" >&2
  format R
  printf ' '; shift
}

## @fn void err (error)
## @brief Output message on stderr (&2)
## @param $1 Message to display
## @return Echo: message on stderr
err() {
  [ $# -gt 1 ] && { _status_message "$1" "${c_error:-$c_red}"; shift; }
  echo -e "$1" >&2
}

## @fn int die (error, exit_code)
## @brief Output message on stderr (&2), then exit/return
## @param $1 Message to display
## @return Code: exit_code (default 1)
## @return Echo: message on stderr
die() { err "$1"; final "${2:-1}"; }

## @fn void pause (message)
## @brief Output message on stderr (&2), then wait for Enter
## @param $1 Message to display
## @return Echo: message on stderr
pause() { err "$1"; read -p "Press Enter -- "; }

## @fn void line (char)
## @brief Print a line composed of character char
## @param $1 Character to use
## @return Echo: a line on stderr
line() {
  local l=${#1} c
  c=$(/usr/bin/tput cols)
  if [ "$l" -gt 1 ]; then
    local n=$((c/l)); local r=$((c-(n*l)))
    # shellcheck disable=SC2031,SC2030
    err "$(for i in {0..$n}; do echo -n "$1"; done; echo -n "${1:0:$r}")"
  else
    # shellcheck disable=SC2031,SC2030
    err "$(for i in {0..$c}; do echo -n "$1"; done)"
  fi
}

fi # __IO_MESSAGE_SH