Merge pull request #74 from tegonal-bot/gt/update/tegonal-scripts

update files of remote tegonal-scripts to version v3.2.0 via gt
tegonal · Aug 31, 2024 · 4f8cf7d · 4f8cf7d
2 parents 66a8b31 + 4f79a94
commit 4f8cf7d
Show file tree

Hide file tree

Showing 20 changed files with 146 additions and 66 deletions.
diff --git a/.gt/remotes/tegonal-scripts/pulled.tsv b/.gt/remotes/tegonal-scripts/pulled.tsv
@@ -1,21 +1,21 @@
 #@ Version: 1.0.0
 tag	file	relativeTarget	sha512
-v3.1.0	src/setup.sh	../lib/tegonal-scripts/src/setup.sh	914303c7750ca2868d8480307943becade86d55407cf54fcf36bd1d8f085431395acaec9d34801bcde8f6e41630343de5c7246f20d9c05e36c3512d320a47ab4
-v3.1.0	src/utility/io.sh	../lib/tegonal-scripts/src/utility/io.sh	d54d6ede67d4be35baa7fa617f5d0a122f676f49fa94d50c7fce8a710627691285eb5ddac485695a16d3aff0752a5514efa124d8b249aa9bf019576a8c3edc89
-v3.1.0	src/utility/array-utils.sh	../lib/tegonal-scripts/src/utility/array-utils.sh	5146085d321470c8e4dbcfd3482631c74b18de005512d65481f5fa5ed8610e951ca225944f2711f69130173b5d52cb9febe3b14fab8331d085e16694c5e80c4d
-v3.1.0	src/utility/parse-utils.sh	../lib/tegonal-scripts/src/utility/parse-utils.sh	169a599f88652c186c5511cc79fe4da7fb249de9ca515a696092bc08402fa48dbeb0785386e744767aa09e9ad4f31c2a1e2d1e05f105bcb00af56719d29386b6
-v3.1.0	src/utility/git-utils.sh	../lib/tegonal-scripts/src/utility/git-utils.sh	69ada15bcc082c779abb77adf10fb05e2abfd866eddd41d4e0c89e8eb5b6def1c8cd2efed64f78134975cd819af37cadc8d4fb7f2bc0a35cf30f736e0de5645b
-v3.1.0	src/utility/gpg-utils.sh	../lib/tegonal-scripts/src/utility/gpg-utils.sh	c434f52f26e55b71a2f1d29126f0591612a40074e155525ef79f60bdc40e5d732c0465686204bc25471f8d9ff72b42a58c65a3974328a25710e12b5d6382fb16
-v3.1.0	src/utility/log.sh	../lib/tegonal-scripts/src/utility/log.sh	f00bffaeac1931a137c7fe195b0742f7207825541a39bdd58218113a54063ab22e16b57b1a043fd9316a43b51374bde91878fce9698dedeacf911b95a39a6e51
-v3.1.0	src/utility/parse-fn-args.sh	../lib/tegonal-scripts/src/utility/parse-fn-args.sh	f34cb82663210fadf3f09c7c43327e47257c6b4c9dfb0a0961635cd7a5dff9703d9c32d424b715a5d01a7fe29849962ceeb3e5d3f42e936aeca261905f2b2807
-v3.1.0	src/utility/update-bash-docu.sh	../lib/tegonal-scripts/src/utility/update-bash-docu.sh	546a45a1ee15d6761a21881106874777387b1e0700a593590873804b222ca67ccead950903b5ce644757330b6eb06e04a639516ad9592d828baabfc502c8f0ba
-v3.1.0	src/utility/parse-args.sh	../lib/tegonal-scripts/src/utility/parse-args.sh	d1cb71449b7c841349c033f2c9f990e5c96a20f7f8557b3995363c213e410911f431d76c5f633f35f7dbbcb9def628fd0e766bd5e6f122c216bfbb79b94c5bd1
-v3.1.0	src/utility/checks.sh	../lib/tegonal-scripts/src/utility/checks.sh	1f26275b718025906dafd63046e848878630fd6cce2d7b4134aeecbda2ddb163653d2dec881b7f52b4cbf6828db3d058c4d7f719af58164530e333fca437068f
-v3.1.0	src/utility/parse-commands.sh	../lib/tegonal-scripts/src/utility/parse-commands.sh	7895c05b0c2a8d6e86ff7939232d21c900589e6313c376095ab44c736b462b18dde248dc87f14ab88f57b50163555cc6d72931bf1370db28f252a8961cdcf749
-v3.1.0	src/utility/replace-snippet.sh	../lib/tegonal-scripts/src/utility/replace-snippet.sh	24a67c42fbfee4a4f167c45298398f1873283fa49b7707f1a81e85aeb9f78a9a786b0827d4f825afc9bfc99add7d45375919af161c56a73afd2da92c392a511f
-v3.1.0	src/utility/ask.sh	../lib/tegonal-scripts/src/utility/ask.sh	afe445da2b6b9616923a2b1bf44677ac90857df2fc6531cd6dccced78d73e6c5360dae5391a9955a6a6b4db9a263aa4c36e668361fb24a3fb7c4b0203d3e276a
-v3.1.0	src/utility/replace-help-snippet.sh	../lib/tegonal-scripts/src/utility/replace-help-snippet.sh	cc5ace6cd79eb7ba87c8006d8cb78d8abec0757fa0b20751fcaca50e2210ae23ba8b1d361bf255a0fe27ebbb38631e0c02efb6fc626c88bebcf53bdd0ddb2870
-v3.1.0	src/utility/source-once.sh	../lib/tegonal-scripts/src/utility/source-once.sh	228afe1e6c1db3bc0a2f2359403b965510e213ab0403f4d3c7cefaa908b76220ccd326ac63a73438427d827647e24910860b536277f974f4b972a904093b94f8
-v3.1.0	src/utility/recursive-declare-p.sh	../lib/tegonal-scripts/src/utility/recursive-declare-p.sh	6267190bdf8c6b1b4df51b458e3de18dc96613e8370c5b91ffed2e7a5013a9c6de97fc525748c26862cf2ada7f00449d0f3b78ae68a17c65daeae7394d581ec1
-v3.1.0	src/ci/install-shellcheck.sh	../lib/tegonal-scripts/src/ci/install-shellcheck.sh	83d4b4eca4499dfcb6eaeedeedf532fb4f55ddb502ec79d7964af14b4895dec971b1922f7f6da6424729230da3faaf5265d47a492fef5359d3b24d1890f9de38
-v3.1.0	src/qa/run-shellcheck.sh	../lib/tegonal-scripts/src/qa/run-shellcheck.sh	da9eb22fd65c34affe1d3616b6923196b865b8d7150cc170794b26cfca423605f05c9226ccd21140ee055167313635ec400004acce66b03534f6f71a5ca566d4
+v3.2.0	src/setup.sh	../lib/tegonal-scripts/src/setup.sh	f6221b322efb57a8e595c4d033e18ee3d4ba7b373f549fc1e608401a2976ac03e09f4f033787f3d25896d7cf9447edf074f558259c7813df65792440bc472e09
+v3.2.0	src/utility/io.sh	../lib/tegonal-scripts/src/utility/io.sh	701867a847119f4da16af5cc75c1261bf53d2a7e0d61c289e5b1358e28aba34d2ab0e964adb3bc18d0c249ed869c29440463a5b8aa70376a47d42293813e1549
+v3.2.0	src/utility/array-utils.sh	../lib/tegonal-scripts/src/utility/array-utils.sh	34e6549d3208d4bee23e28a9c81b7f6774280a5a9afd5759fc5ace8161d35a87acfec707b75d447a427e6f4f3ad14d6ba48529a92f7a0be91526e456bc2d85a1
+v3.2.0	src/utility/parse-utils.sh	../lib/tegonal-scripts/src/utility/parse-utils.sh	31c842882e85e4ed9192b31f042a8348229776622d01d6c15f49caee4faf49da74c7d50f379c532fc4998da52cedd51a36e92b432f71908cd31ce84652653918
+v3.2.0	src/utility/git-utils.sh	../lib/tegonal-scripts/src/utility/git-utils.sh	5766b484335d71b7889e0060905295eb3b43acc1ea102d23d859eb83537940f0165c5a29d818d8ba8017e9a46824a2b11328e13bdc8160d31699ebfa0b4e809a
+v3.2.0	src/utility/gpg-utils.sh	../lib/tegonal-scripts/src/utility/gpg-utils.sh	57dc45a171642bd8925f73eb44c2fbccbf9084e0c95a868d1204b2d7b5d330f9b549db2af5ba9907dae7f0852ece39ab1656274ac383cebd0abbb0d12cee1eff
+v3.2.0	src/utility/log.sh	../lib/tegonal-scripts/src/utility/log.sh	3ff775eb686499bf75f497c7071fbe0c64c0b2a129318a7f0010870b9b4328848aa029d98a2d1cc58dab5b15834e5e689a2efbec981e9898eb5af68c729e49df
+v3.2.0	src/utility/parse-fn-args.sh	../lib/tegonal-scripts/src/utility/parse-fn-args.sh	9d93c8fb0bea1109a4cf51438eda04c70b2479e51ff05eef529e2715405c054339620117d3164876e6f325612be641da6653fce9435a637b3768b01a89c5c9d6
+v3.2.0	src/utility/update-bash-docu.sh	../lib/tegonal-scripts/src/utility/update-bash-docu.sh	8f564cf2946d4ab4a8089331990ddfc24f7194dbe1d4377505faced56d6a4e60bab0c3dfbaf39662676f49d36bfa9f79594d9177ba2c9ec46f825d332529516b
+v3.2.0	src/utility/parse-args.sh	../lib/tegonal-scripts/src/utility/parse-args.sh	7fa58fc83d65ed11393f2ee688aedc5d133571194dc6c3bb7b053133154f53d8909cf9f732d619d70d17d6cc37d2f392ae1b0d6d055602893b74cbcde06425e2
+v3.2.0	src/utility/checks.sh	../lib/tegonal-scripts/src/utility/checks.sh	5d2482992c3c0e562faba718b3946cdb8b58cdf5fc5d6ece6a5a4a0050262ec80ea2f95b6f6b927940298171747adcda511325991c6a530d8af8c4a5a454faa7
+v3.2.0	src/utility/parse-commands.sh	../lib/tegonal-scripts/src/utility/parse-commands.sh	6ac7234f74f545942cab445ea90c157203075839abfd20191bfec266d6c15fbfac681523543fb61ccf5f1dbc16cc3125c5a86ec9daf1d763ef2af634acde506e
+v3.2.0	src/utility/replace-snippet.sh	../lib/tegonal-scripts/src/utility/replace-snippet.sh	861813fee3650a32ad89548f4a816eeaa85b713dd146791d4afe342af30cc1bded27f620fae8702886c6fd58a00c9cc8da9b3254cefcf3155d748a021272c32e
+v3.2.0	src/utility/ask.sh	../lib/tegonal-scripts/src/utility/ask.sh	e7dc9cf595aa46cb1593db997e6079546371e5b9e832a5233301a2d3d73378a579de47ed1742e42aa845a932ab5e6758208f2d2c505263ee8eecc2c164f72d6b
+v3.2.0	src/utility/replace-help-snippet.sh	../lib/tegonal-scripts/src/utility/replace-help-snippet.sh	f0b90b8ed4bdea02609ca71df547d5853e315fc30b7e2ea8aaeb20ffcb5da910045d8cdde213137350e8f26d529032f626b558d81cc436c31b22467ef1cb3dfd
+v3.2.0	src/utility/source-once.sh	../lib/tegonal-scripts/src/utility/source-once.sh	6b6688d85a5a0c591c73d2ef32a0b896266ceb6af7cea0f06afd8a645b46b2e38abf1eaa2efa444a06382ef0c170de6a2ba2e14062fba0bfa0d384198e0ac1a2
+v3.2.0	src/utility/recursive-declare-p.sh	../lib/tegonal-scripts/src/utility/recursive-declare-p.sh	10a0d54232712ca7dd56297d7022194f6fcadf564c458d3ff04a15d8539989d8d727db9e903e0a062e0cd75667b71cf8f56444d9116f37664505ac19610ce2fb
+v3.2.0	src/ci/install-shellcheck.sh	../lib/tegonal-scripts/src/ci/install-shellcheck.sh	628dafc9ab0a44bd588785631f3d1f58f79f8764d3d628796fdb913d50cbf5991baa2d5df3d3b62d0d93ae41eef6d36f547a32186438f42c1430758e089f711e
+v3.2.0	src/qa/run-shellcheck.sh	../lib/tegonal-scripts/src/qa/run-shellcheck.sh	e717ded82bd1545d355a101486a8e746786a224c6110ba0b8451b9754822901f2636320092cf813a55a082c45ae96943cf963c6261c361f2c753f646bb36aa98
diff --git a/lib/tegonal-scripts/src/ci/install-shellcheck.sh b/lib/tegonal-scripts/src/ci/install-shellcheck.sh
@@ -6,7 +6,7 @@
 #  \__/\__/\_, /\___/_//_/\_,_/_/         It is licensed under Apache License 2.0
 #         /___/                           Please report bugs and contribute back your improvements
 #
-#                                         Version: v3.1.0
+#                                         Version: v3.2.0
 #######  Description  #############
 #
 #  function which searches for *.sh files within defined paths (directories or a single *.sh) and

diff --git a/lib/tegonal-scripts/src/qa/run-shellcheck.sh b/lib/tegonal-scripts/src/qa/run-shellcheck.sh
@@ -6,7 +6,7 @@
 #  \__/\__/\_, /\___/_//_/\_,_/_/         It is licensed under Apache License 2.0
 #         /___/                           Please report bugs and contribute back your improvements
 #
-#                                         Version: v3.1.0
+#                                         Version: v3.2.0
 #######  Description  #############
 #
 #  function which searches for *.sh files within defined paths (directories or a single *.sh) and

diff --git a/lib/tegonal-scripts/src/setup.sh b/lib/tegonal-scripts/src/setup.sh
@@ -6,7 +6,7 @@
 #  \__/\__/\_, /\___/_//_/\_,_/_/         It is licensed under Apache License 2.0
 #         /___/                           Please report bugs and contribute back your improvements
 #
-#                                         Version: v3.1.0
+#                                         Version: v3.2.0
 #######  Description  #############
 #
 #  script which should be sourced and sets up variables and functions for the scripts

diff --git a/lib/tegonal-scripts/src/utility/array-utils.sh b/lib/tegonal-scripts/src/utility/array-utils.sh
@@ -6,7 +6,7 @@
 #  \__/\__/\_, /\___/_//_/\_,_/_/         It is licensed under Apache License 2.0
 #         /___/                           Please report bugs and contribute back your improvements
 #
-#                                         Version: v3.1.0
+#                                         Version: v3.2.0
 #######  Description  #############
 #
 #  utility functions for dealing with arrays

diff --git a/lib/tegonal-scripts/src/utility/ask.sh b/lib/tegonal-scripts/src/utility/ask.sh
@@ -6,7 +6,7 @@
 #  \__/\__/\_, /\___/_//_/\_,_/_/         It is licensed under Apache License 2.0
 #         /___/                           Please report bugs and contribute back your improvements
 #
-#                                         Version: v3.1.0
+#                                         Version: v3.2.0
 #######  Description  #############
 #
 #  Utility functions to ask the user something via input.
@@ -26,6 +26,15 @@
 #    	echo "hello"
 #    fi
 #
+#    function noAnswerCallback {
+#    	echo "hm... no answer, I am sad :("
+#    }
+#    timeoutInSeconds=30
+#    readArgs='' # i.e. no additional args passed to read
+#    answer='default value used if there is no answer'
+#    askWithTimeout "some question" "$timeoutInSeconds" noAnswerCallback answer "$readArgs"
+#    echo "$answer"
+#
 ###################################
 set -euo pipefail
 shopt -s inherit_errexit
@@ -48,18 +57,17 @@ function askYesOrNo() {
 	local -r question=$1
 	shift || die "could not shift by 1"
 
-	# shellcheck disable=SC2059			# the question itself can have %s thus we use it in the format string
-	printf "\n\033[0;36m$question\033[0m y/[N]:" "$@"
+	local -r askYesOrNo_timeout=20
 	local answer='n'
-	local -r timeout=20
-	set +e
-	read -t "$timeout" -r answer
-	local lastResult=$?
-	set -e
-	if ((lastResult > 128)); then
+
+	# shellcheck disable=SC2317   # called by name
+	function askYesOrNo_noAnswerCallback() {
 		printf "\n"
-		logInfo "no user interaction after %s seconds, going to interpret that as a 'no'." "$timeout"
-	fi
+		logInfo "no user interaction after %s seconds, going to interpret that as a 'no'." "$askYesOrNo_timeout"
+	}
+
+	# shellcheck disable=SC2059			# the question itself can have %s thus we use it in the format string
+	askWithTimeout "\033[0;36m$question\033[0m y/[n]:" "$askYesOrNo_timeout" askYesOrNo_noAnswerCallback answer "" "$@"
 	if [[ $answer == y ]] || [[ $answer == Y ]]; then
 		return 0
 	elif [[ $answer == n ]] || [[ $answer == N ]]; then
@@ -69,3 +77,49 @@ function askYesOrNo() {
 		return 1
 	fi
 }
+
+function askWithTimeout() {
+	if (($# < 5)); then
+		logError "At least five arguments need to be passed to askWithTimeout, given \033[0;36m%s\033[0m\n" "$#"
+		echo >&2 '1: question   	the question which the user should answer'
+		echo >&2 '2: timeout			timeout in seconds after which we will call noAnswerFn'
+		echo >&2 '3: noAnswerFn		callback used in case we did not get an answer from the user'
+		echo >&2 '4: outVarName		name of output variable used to pass back the result'
+		echo >&2 '5: readArgs 		additional args passed to read'
+		echo >&2 '6... args...  	arguments for the question (question is printed with printf)'
+		printStackTrace
+		exit 9
+	fi
+	# prefixing all variables here as plan to write the answer to an variable which is not in scope of this function
+	# i.e. if we don't prefix and one using the same name for outVarName as a variable local to this function, then we
+	# would just assign a value to the local function instead of the variable defined outside this function. The prefix
+	# prevents such a clash in most likely all cases -- otherwise the user is to blame ;)
+	local -r askWithTimeout_question=$1
+	local -r askWithTimeout_timeout=$2
+	local -r askWithTimeout_noAnswerFn=$3
+	local -r askWithTimeout_outVarName=$4
+	local -r askWithTimeout_readArgs=$5
+	shift 5 || die "could not shift by 5"
+
+	exitIfArgIsNotFunction "$askWithTimeout_noAnswerFn" 3
+	# shellcheck disable=SC2059			# the question itself can have %s thus we use it in the format string
+	printf "\n$askWithTimeout_question " "$@"
+	local askWithTimeout_answer=''
+	set +e
+	if [[ -n $askWithTimeout_readArgs ]]; then
+		read -t "$askWithTimeout_timeout" "${askWithTimeout_readArgs?}" -r askWithTimeout_answer
+	else
+		read -t "$askWithTimeout_timeout" -r askWithTimeout_answer
+	fi
+
+	local askWithTimeout_lastResult=$?
+	set -e
+	if ((askWithTimeout_lastResult > 128)); then
+		"$askWithTimeout_noAnswerFn"
+	elif [[ $askWithTimeout_lastResult -eq 0 ]]; then
+		# that's where the black magic happens, we are assigning to a global (not local to this function) variable here
+		printf -v "$askWithTimeout_outVarName" "%s" "$askWithTimeout_answer" || die "could not assign value to $askWithTimeout_outVarName"
+	else
+		return "$askWithTimeout_lastResult"
+	fi
+}
diff --git a/lib/tegonal-scripts/src/utility/checks.sh b/lib/tegonal-scripts/src/utility/checks.sh
@@ -7,7 +7,7 @@
 #  \__/\__/\_, /\___/_//_/\_,_/_/         It is licensed under Apache License 2.0
 #         /___/                           Please report bugs and contribute back your improvements
 #
-#                                         Version: v3.1.0
+#                                         Version: v3.2.0
 #######  Description  #############
 #
 #  Functions to check declarations
@@ -28,11 +28,13 @@
 #    	local -rn arr=$1
 #    	local -r fn=$2
 #    	local -r bool=$3
+#    	local -r version=$4
 #
 #    	# resolves arr recursively via recursiveDeclareP and check that is a non-associative array
-#    	checkArgIsArray arr 1        # same as exitIfArgIsNotArray if set -e has an effect on this line
-#    	checkArgIsFunction "$fn" 2   # same as exitIfArgIsNotFunction if set -e has an effect on this line
-#    	checkArgIsBoolean "$bool" 3   # same as exitIfArgIsNotBoolean if set -e has an effect on this line
+#    	checkArgIsArray arr 1        		# same as exitIfArgIsNotArray if set -e has an effect on this line
+#    	checkArgIsFunction "$fn" 2   		# same as exitIfArgIsNotFunction if set -e has an effect on this line
+#    	checkArgIsBoolean "$bool" 3   	# same as exitIfArgIsNotBoolean if set -e has an effect on this line
+#    	checkArgIsVersion "$version" 4  # same as exitIfArgIsNotVersion if set -e has an effect on this line
 #
 #    	# shellcheck disable=SC2317   # is passed by name to checkArgIsArrayWithTuples
 #    	function describeTriple() {
@@ -44,7 +46,8 @@
 #    	exitIfArgIsNotArray arr 1
 #    	exitIfArgIsNotArrayOrIsEmpty arr 1
 #    	exitIfArgIsNotFunction "$fn" 2
-#    	exitIfArgIsNotBoolean "$bool" 2
+#    	exitIfArgIsNotBoolean "$bool" 3
+#    	exitIfArgIsNotVersion "$version" 4
 #
 #    	# shellcheck disable=SC2317   # is passed by name to exitIfArgIsNotArrayWithTuples
 #    	function describePair() {
@@ -112,12 +115,12 @@ function exitIfArgIsNotArray() {
 
 function exitIfArgIsNotArrayOrIsEmpty() {
 	exitIfArgIsNotArray "$@"
-		local -rn exitIfArgIsNotArrayOrIsEmpty_arr=$1
-		local -r argNumberOrName=$2
-		shift 2 || die "could not shift by 2"
-		if [[ ${#exitIfArgIsNotArrayOrIsEmpty_arr[@]} -lt 1 ]]; then
-			die "the passed argument \033[0;36m%s\033[0m is an empty array" "${!checkArgIsArray_arr}"
-		fi
+	local -rn exitIfArgIsNotArrayOrIsEmpty_arr=$1
+	local -r argNumberOrName=$2
+	shift 2 || die "could not shift by 2"
+	if [[ ${#exitIfArgIsNotArrayOrIsEmpty_arr[@]} -lt 1 ]]; then
+		die "the passed argument \033[0;36m%s\033[0m is an empty array" "${!checkArgIsArray_arr}"
+	fi
 }
 
 function checkArgIsArrayWithTuples() {
@@ -208,12 +211,12 @@ function checkArgIsFunction() {
 
 	if ! declare -F "$name" >/dev/null; then
 		local declareP
-		declareP=$(declare -p "$name" || echo "failure, is not a variable")
+		declareP=$(declare -p "$name" || printf "failure: \033[0;36m%s\033[0m is not a variable\n" "$name")
 		local funcName=${FUNCNAME[1]}
 		if [[ $funcName == "exitIfArgIsNotFunction" ]]; then
 			funcName=${FUNCNAME[2]}
 		fi
-		traceAndReturnDying "the %s argument to %s needs to be a function/command, %s isn't one\nMaybe it is a variable storing the name of a function?\nFollowing the output of: declare -p %s\n%s" \
+		traceAndReturnDying "the %s argument to %s needs to be a function/command, \033[0;36m%s\033[0m isn't one\nMaybe it is the name of a variable storing the name of a function?\nFollowing the output of: declare -p %s\n%s" \
 			"$argNumberOrName" "$funcName" "$name" "$name" "$declareP"
 	fi
 }
@@ -243,6 +246,31 @@ function exitIfArgIsNotBoolean() {
 	# shellcheck disable=SC2310			# we are aware of that || will disable set -e for checkArgIsBoolean
 	checkArgIsBoolean "$@" || exit $?
 }
+
+function exitIfArgIsNotVersion() {
+	# shellcheck disable=SC2310			# we are aware of that || will disable set -e for checkArgIsVersion
+	checkArgIsVersion "$@" || exit $?
+}
+
+function checkArgIsVersion() {
+	local versionRegex
+	source "$dir_of_tegonal_scripts/releasing/common-constants.source.sh" || die "could not source common-constants.source.sh"
+
+	local value argNumberOrName
+	# shellcheck disable=SC2034   # is passed by name to parseFnArgs
+	local -ra params=(value argNumberOrName)
+	parseFnArgs params "$@"
+
+	if ! [[ "$value" =~ $versionRegex ]]; then
+		local funcName=${FUNCNAME[1]}
+		if [[ $funcName == "exitIfArgIsNotVersion" ]]; then
+			funcName=${FUNCNAME[2]}
+		fi
+		traceAndReturnDying "the %s argument to %s needs to match vX.Y.Z(-RC...) was %s" \
+			"$argNumberOrName" "$funcName" "$value"
+	fi
+}
+
 function checkCommandExists() {
 	if ! (($# == 1 || $# == 2)); then
 		traceAndDie "you need to pass the name of the command to check to checkCommandExists and optionally an additional hint (e.g. install via...)"

diff --git a/lib/tegonal-scripts/src/utility/git-utils.sh b/lib/tegonal-scripts/src/utility/git-utils.sh
@@ -5,7 +5,7 @@
 #  / __/ -_) _ `/ _ \/ _ \/ _ `/ /        It is licensed under Apache License 2.0
 #  \__/\__/\_, /\___/_//_/\_,_/_/         Please remotert bugs and contribute back your improvements
 #         /___/
-#                                         Version: v3.1.0
+#                                         Version: v3.2.0
 #
 #######  Description  #############
 #

diff --git a/lib/tegonal-scripts/src/utility/gpg-utils.sh b/lib/tegonal-scripts/src/utility/gpg-utils.sh
@@ -6,7 +6,7 @@
 #  \__/\__/\_, /\___/_//_/\_,_/_/         It is licensed under Apache License 2.0
 #         /___/                           Please report bugs and contribute back your improvements
 #
-#                                         Version: v3.1.0
+#                                         Version: v3.2.0
 #######  Description  #############
 #
 #  utility functions for dealing with gpg

diff --git a/lib/tegonal-scripts/src/utility/io.sh b/lib/tegonal-scripts/src/utility/io.sh
@@ -6,7 +6,7 @@
 #  \__/\__/\_, /\___/_//_/\_,_/_/         It is licensed under Apache License 2.0
 #         /___/                           Please report bugs and contribute back your improvements
 #
-#                                         Version: v3.1.0
+#                                         Version: v3.2.0
 #######  Description  #############
 #
 #  utility function dealing with Input/Ouput