bash-boilerplate: enriching bash

For when you want your humble bash script to have a little more umph!, have at these hiqh level features that can be easily embedded in any project.

https://github.com/andrei-pavel/bash-boilerplate

Libraries

All libraries are found inside lib.

Import any library with:

SCRIPT_PATH="$(dirname "$(readlink -f "${0}")")"
. "${SCRIPT_PATH}/lib/${library}"

They all have import guards to make sure no library is imported twice.

header

• ☑ set -euo pipefail
• ☑ print-usage function to print all ${ARGUMENTS}
• ☑ default parameters -c|--config $config_yaml reads the given YAML file and converts all YAML variables to shell variables
• ☑ default parameters -d|--debug calls set -x for debug mode
• ☑ default parameters -h|--help calls print-usage() automatically
• ☑ additional function to print all given arguments other than the default ones above
• ☑ ANSII colors ${BLACK}, ${RED}, ${GREEN}, ${YELLOW}, ${BLUE}, ${PURPLE}, ${CYAN}, ${WHITE} are exported
• ☑ ${SCRIPT_PATH}, ${LIB_PATH} paths are exported

spinner

The best bash spinner out there

• ☑ start-spinner ${text} function to start a spinner with specified ${text}
• ☑ stop-spinner ${exit_code} function to stop the spinner with success if ${exit_code} is 0, with failure otherwise
• ☑ disable-spinners function to ignore commands that start and stop spinners
• ☑ enable-spinners function [default]
• ☑ disable-verbose function to print output on stopped spinner only if exit code was non-null [default]
• ☑ enable-verbose function to print output on stopped spinner all the time
• ☑ configure-spinner-output [full-output|stdout-only|stderr-only|no-output] function
• ☐ nested spinners

traps

• ☑ traps [--force|--return-code-only] ${custom_trap} function to set what runs after catching HUP, INT, QUIT, KILL, TERM, EXIT signals
  • usually captures return code, disables traps so that they don't run recursively, stops any spinners and then runs the ${custom_trap}
  • --force makes it so that only ${custom_trap} is run
  • --return-code-only skips over stopping the spinners which is needed in case you're not using spinners

utils

• ☑ confirm [${custom_question}] function to ask the user a yes or no question
• ☑ mandatory ${variable} function to check if ${variable} is set, exit 2 otherwise
• ☑ mandatory-command ${command} function to check if ${command} is available, exit 3 otherwise

yaml-to-env

• ☑ Simply importing it with

. "${SCRIPT_PATH}/lib/yaml-to-env [${config_yaml}]"

will read ${config_yaml} or ./config.yaml if it is not provided and will
convert all YAML variables to shell variables just like
-c|--config $config_yaml, but programatically instead of user-requested.

Example

See the hello-world example which showcases the different uses of these
arguments.

Usage: hello-world {{options}} {{arguments}}
Options:
  [-c|--config $config_yaml]   Reads from a YAML configuration and converts all
                               key-value pairs with literal values to
                               environment variables.
  [-d|--debug]                 Enables debug mode, showing every executed
                               statement.
  [-h|--help]                  Prints usage (this text).
Arguments:
  [-a|--approval]              whether to ask user for approval
  -n $count                    print $count times
  [-y|--yaml $yaml]            specify path to the configuration file
  [$string]                    something other than "Hello, world!" to print