#!/usr/bin/env bash # sf -- script framework (https://github.com/Deleh/sf) # Text formatting variables sftrs=$'\e[0m' sftbf=$'\e[1m' sftdim=$'\e[2m' sftul=$'\e[4m' sftblk=$'\e[5m' sftinv=$'\e[7m' sfthd=$'\e[8m' sftclr=$'\e[1A\e[K' sftk=$'\e[30m' sftr=$'\e[31m' sftg=$'\e[32m' sfty=$'\e[33m' sftb=$'\e[34m' sftm=$'\e[35m' sftc=$'\e[36m' sftw=$'\e[97m' # Public output functions function sferr { echo "${sftbf}${sftr}ERROR${sftrs} $1" [ -z "$2" ] && exit 1 } function sfwarn { echo "${sftbf}${sfty}WARNING${sftrs} $1" } # Public input functions function sfask { if [ "$2" == "" ]; then read -p "$1? [${sftbf}Y${sftrs}/${sftbf}n${sftrs}] " sfin [[ "$sfin" =~ y|Y|^$ ]] && sfin=true || sfin=false else read -p "$1? [${sftbf}y${sftrs}/${sftbf}N${sftrs}] " sfin [[ "$sfin" =~ n|N|^$ ]] && sfin=false || sfin=true fi } function sfget { [ "$2" != "" ] && read -p "$1 [${sftbf}$2${sftrs}]: " sfin || read -p "$1: " sfin [ "$sfin" == "" ] && [ "$2" != "" ] && sfin="$2" } # Internal error function function _sferr { echo "${sftbf}${sftr}SF PARSE ERROR${sftrs} $1" exit 1 } # Declare variables for parsing OLDIFS=$IFS IFS=";" _sfphead="" _sfpdesc="" _sfodesc="" _sfexamples="" _sfpargs=() declare -A _sfflags declare -A _sfargs # Parse sf arguments for a in "${sfargs[@]}"; do # Get amount of ; _sfsubst=${a//";"} _sfcount="$(((${#a} - ${#_sfsubst})))" if [ $_sfcount -eq 1 ]; then # Read positional argument declaration read -r -a _sfparsearr <<< "${a}" # Add to positional argument arry _sfpargs+=("${_sfparsearr[0]}") # Set usage header and description _sfphead="$_sfphead ${_sfparsearr[0]}" _sfpdesc="$_sfpdesc ${_sfparsearr[0]};${_sfparsearr[1]}\n" # Flags elif [ $_sfcount -eq 2 ]; then # Read flag declaration read -r -a _sfparsearr <<< "${a}" # Set mappings _sfflags["-${_sfparsearr[1]}"]="${_sfparsearr[0]}" _sfflags["--${_sfparsearr[0]}"]="${_sfparsearr[0]}" # Set default value declare ${_sfparsearr[0]}=false # Set description _sfodesc="$_sfodesc -${_sfparsearr[1]}, --${_sfparsearr[0]};${_sfparsearr[2]}\n" # Arguments elif [ $_sfcount -eq 4 ]; then # Read argument declaration read -r -a _sfparsearr <<< "${a}" # Set mappings _sfargs["-${_sfparsearr[1]}"]="${_sfparsearr[0]}" _sfargs["--${_sfparsearr[0]}"]="${_sfparsearr[0]}" # Set default value declare ${_sfparsearr[0]}="${_sfparsearr[3]}" # Set description _sfodesc="$_sfodesc -${_sfparsearr[1]}, --${_sfparsearr[0]} ${_sfparsearr[2]};${_sfparsearr[4]} (default: ${_sfparsearr[3]})\n" else _sferr "Wrong argument declaration: $a" fi done # Parse examples for e in "${sfexamples[@]}"; do # Get amount of ; _sfsubst=${e//";"} _sfcount="$(((${#e} - ${#_sfsubst})))" if [ $_sfcount -eq 1 ]; then # Read example read -r -a _sfparsearr <<< "${e}" _sfexamples="$_sfexamples ${_sfparsearr[0]};${_sfparsearr[1]}\n" else _sferr "Wrong example declaration: $e" fi done IFS=$OLDIFS # Usage function function _sfusage { echo -n "Usage: $(basename $0)" [ "$_sfodesc" != "" ] && echo -n " [OPTIONS]" echo -e "$_sfphead" [ ! -z ${sfdesc+x} ] && echo -e "\n$sfdesc" if [ "$_sfpdesc" != "" ]; then echo -e "\nPOSITIONAL ARGUMENTS" echo -e "$_sfpdesc" | column -c 80 -s ";" -t -W 2 fi if [ "$_sfodesc" != "" ]; then echo -e "\nOPTIONS" echo -e "$_sfodesc" | column -c 80 -s ";" -t -W 2 fi if [ "$_sfexamples" != "" ]; then echo -e "\nEXAMPLES" echo -e "$_sfexamples" | column -c 80 -s ";" -t -W 2 fi if [ ! -z ${sfextra+x} ]; then echo -e "\n$sfextra" fi exit 0 } # Check for help flag for a in "$@"; do # Check if help flag ist set [ "$a" == "-h" ] || [ "$a" == "--help" ] && _sfusage done # Parse arguments while (( "$#" )); do # Check if flag if [ ! -z ${_sfflags["$1"]} ]; then declare ${_sfflags["$1"]}=true # Check if argument elif [ ! -z ${_sfargs["$1"]} ]; then # Check if argument has value if [ -n "$2" ] && [ "${2:0:1}" != "-" ]; then declare ${_sfargs["$1"]}="$2" shift else sferr "Argument for '$1' missing" fi # Handle positional arguments and wrong arguments/flags else # Check if arg starts with - if [ "${1:0:1}" == "-" ]; then sferr "Unsupported argument: $1" else # Set positional argument if [ "${#_sfpargs[@]}" != 0 ]; then declare ${_sfpargs[0]}="$1" _sfpargs=("${_sfpargs[@]:1}") else sferr "Too many positional arguments" fi fi fi shift done # Check if positional arguments left if [ ${#_sfpargs[@]} != 0 ]; then for p in "${_sfpargs[@]}"; do sferr "Positional argument '$p' missing" 0 done exit 1 fi # Unset all internal variables and functions unset a e _sfphead _sfpdesc _sfodesc _sfexamples _sfpargs _sfflags _sfargs _sferr _sfusage