Files
@ 92bd9d187370
Branch filter:
Location: majic-scripts/templates/TEMPLATE.sh.tpl
92bd9d187370
4.3 KiB
application/vnd.groove-tool-template
Noticket: [TEMPLATE.sh.tpl] Make sure to default the value for $1 positional argument when checking if it has been passed-in:
- Otherwise the shell script will error-out because the variable is
not defined.
- Otherwise the shell script will error-out because the variable is
not defined.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 | # -*- mode: snippet -*-
# name: Bash script template with standard CLI processing and helper functions.
# key: bash-script
# contributor: Branko Majic <branko@majic.rs>
# type: snippet
# --
#!/bin/bash
#
# `(file-name-nondirectory (buffer-file-name))`
#
# Copyright (C) `(format-time-string "%Y")`, Branko Majic <branko@majic.rs>
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
# Treat unset variables as errors.
set -u
program="`(file-name-nondirectory (buffer-file-name))`"
version="${1:version}"
function usage() {
cat <<EOF
\$program \$version, ${2:short description }
Usage: \$program [OPTIONS] ${3:arguments}
\$program ${4:long description}
\$program accepts the following options:
-q
Quiet mode.
-d
Enable debug mode.
-v
Show script version and licensing information.
-h
Show usage help.
Please report bugs and send feature requests to <branko@majic.rs>.
EOF
}
function version() {
cat <<EOF
\$program, version \$version
+-----------------------------------------------------------------------+
| Copyright (C) `(format-time-string "%Y")`, Branko Majic <branko@majic.rs> |
| |
| This program is free software: you can redistribute it and/or modify |
| it under the terms of the GNU General Public License as published by |
| the Free Software Foundation, either version 3 of the License, or |
| (at your option) any later version. |
| |
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| GNU General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License |
| along with this program. If not, see <http://www.gnu.org/licenses/>. |
+-----------------------------------------------------------------------+
EOF
}
# Set-up colours for message printing if we're not piping and terminal is
# capable of outputting the colors.
_color_terminal=\$(tput colors 2>&1)
if [[ -t 1 ]] && (( \${_color_terminal} > 0 )); then
_text_bold=\$(tput bold)
_text_white=\$(tput setaf 7)
_text_blue=\$(tput setaf 6)
_text_green=\$(tput setaf 2)
_text_yellow=\$(tput setaf 3)
_text_red=\$(tput setaf 1)
_text_reset=\$(tput sgr0)
else
_text_bold=""
_text_white=""
_text_blue=""
_text_green=""
_text_yellow=""
_text_red=""
_text_reset=""
fi
# Set-up functions for printing coloured messages.
function debug() {
if [[ $debug != 0 ]]; then
echo "\${_text_bold}\${_text_blue}[DEBUG]\${_text_reset}" "\$@"
fi
}
function info() {
echo "\${_text_bold}\${_text_white}[INFO] \${_text_reset}" "\$@"
}
function success() {
echo "\${_text_bold}\${_text_green}[OK] \${_text_reset}" "\$@"
}
function warning() {
echo "\${_text_bold}\${_text_yellow}[WARN] \${_text_reset}" "\$@"
}
function error() {
echo "\${_text_bold}\${_text_red}[ERROR]\${_text_reset}" "\$@" >&2
}
# Define error codes.
SUCCESS=0
ERROR_ARGUMENTS=1
# Disable debug and quiet modes by default.
debug=0
quiet=0
# If no arguments were given, just show usage help.
if [[ -z \${1-} ]]; then
usage
exit "$SUCCESS"
fi
# Parse the arguments
while getopts "qdvh" opt; do
case "\$opt" in
q) quiet=1;;
d) debug=1;;
v) version
exit "$SUCCESS";;
h) usage
exit "$SUCCESS";;
*) usage
exit "$ERROR_ARGUMENTS";;
esac
done
i=\$OPTIND
shift \$((\$i-1))
|