From 698bd23f2f41e727fcb64fb62707cd555c737975 Mon Sep 17 00:00:00 2001
From: Dimitri Gilbert <dimitri.gilbert@gmail.com>
Date: Thu, 21 Sep 2023 08:46:51 +0200
Subject: [PATCH] completely works for subcommands

---
 bin/completely               |  44 +++--
 bin/pos/get-subcmd-directory | 338 +++++++++++++++++++++++++++++++++++
 2 files changed, 371 insertions(+), 11 deletions(-)
 create mode 100755 bin/pos/get-subcmd-directory

diff --git a/bin/completely b/bin/completely
index 64dff1d..73381af 100755
--- a/bin/completely
+++ b/bin/completely
@@ -2,7 +2,7 @@
 # @parseArger-begin
 # @parseArger-help "generate a completely yaml config and completion" --option "help" --short-option "h"
 # @parseArger-version "0.1" --option "version" --short-option "v"
-# @parseArger-verbose --option "verbose" --level "0"
+# @parseArger-verbose --option "verbose" --level "0" --quiet-option "quiet"
 # @parseArger-declarations
 # @parseArger pos command-name "command-name"
 # @parseArger pos file "file" --optional --complete "file"
@@ -26,6 +26,7 @@
 # @parseArger flag version-opt "generate version opt handling" --on
 # @parseArger flag use-verbose "generate verbose level parser" --on
 # @parseArger flag run-completely "run completely" --on --no-alias no-run
+# @parseArger flag discover-subcommand "auto run completely on found subcommand"
 # @parseArger-declarations-end
 
 # @parseArger-utils
@@ -76,6 +77,7 @@ _arg_completion_file="completely.bash"
 _arg_version_opt="on"
 _arg_use_verbose="on"
 _arg_run_completely="on"
+_arg_discover_subcommand="off"
 _verbose_level="0";
 
 
@@ -110,8 +112,9 @@ print_help()
 	echo -e "	--use-verbose|--no-use-verbose: generate verbose level parser, on by default (use --no-use-verbose to turn it off)"
 	echo -e "	--run-completely|--no-run-completely: run completely, on by default (use --no-run-completely to turn it off)
 		no-aliases: --no-run,"
+	echo -e "	--discover-subcommand|--no-discover-subcommand: auto run completely on found subcommand"
 	echo -e "Usage :
-	$0 <command-name> [file] [--pos <value>] [--opt <value>] [--flag <value>] [--set <value>] [--source <value>] [--help-message <value>] [--help-option <value>] [--help-short-option <value>] [--leftovers-name <value>] [--version-opt-name <value>] [--version-short-option <value>] [--verbose-opt-name <value>] [--subcommand-directory <value>] [--completely-cmd <value>] [--extra-file <value>] [--yaml-file <value>] [--completion-file <value>] [--[no-]version-opt] [--[no-]use-verbose] [--[no-]run-completely]";
+	$0 <command-name> [file] [--pos <value>] [--opt <value>] [--flag <value>] [--set <value>] [--source <value>] [--help-message <value>] [--help-option <value>] [--help-short-option <value>] [--leftovers-name <value>] [--version-opt-name <value>] [--version-short-option <value>] [--verbose-opt-name <value>] [--subcommand-directory <value>] [--completely-cmd <value>] [--extra-file <value>] [--yaml-file <value>] [--completion-file <value>] [--[no-]version-opt] [--[no-]use-verbose] [--[no-]run-completely] [--[no-]discover-subcommand]";
 	fi
 
 }
@@ -349,6 +352,12 @@ parse_commandline()
 			--no-run-completely|--no-run)
 				_arg_run_completely="off"
 				;;
+			--discover-subcommand)
+				_arg_discover_subcommand="on"
+				;;
+			--no-discover-subcommand)
+				_arg_discover_subcommand="off"
+				;;
 			-h|--help)
 				print_help;
 				exit 0;
@@ -366,14 +375,22 @@ parse_commandline()
 				exit 0;
 				;;
 			--verbose)
-				if [ $# -lt 2 ];then
-					_verbose_level="$((_verbose_level + 1))";
-				else
-					_verbose_level="$2";
-					shift;
-				fi
-				;;
-			
+					if [ $# -lt 2 ];then
+						_verbose_level="$((_verbose_level + 1))";
+					else
+						_verbose_level="$2";
+						shift;
+					fi
+					;;
+				--quiet)
+					if [ $# -lt 2 ];then
+						_verbose_level="$((_verbose_level - 1))";
+					else
+						_verbose_level="-$2";
+						shift;
+					fi
+					;;
+				
 			*)
 				_last_positional="$1"
 				_positionals+=("$_last_positional")
@@ -439,6 +456,7 @@ print_debug()
 	echo -e "\tversion-opt: ${_arg_version_opt}";
 	echo -e "\tuse-verbose: ${_arg_use_verbose}";
 	echo -e "\trun-completely: ${_arg_run_completely}";
+	echo -e "\tdiscover-subcommand: ${_arg_discover_subcommand}";
 
 }
 
@@ -514,12 +532,16 @@ for flag in "${_arg_flag[@]}"; do
 	fi
 done
 
+if [ "$_arg_discover_subcommand" == "on" ] && [ "$subCmd" != "" ] && [ "$_arg_subcommand_directory" == "" ] ; then
+	_arg_subcommand_directory="$(eval "$SCRIPT_ROOT_DIR/pos/get-subcmd-directory $subCmd")";
+fi
+
 if [ "$subCmd" != "" ] && [ "$_arg_subcommand_directory" != "" ] && [ -d "$_arg_subcommand_directory" ]; then
 	_oneofs_scmd=();
 	parsearger_get_one_ofs _oneofs_scmd "$subCmd";
 	for _scmd in "${_oneofs_scmd[@]}"; do
 		if [ -f "${_arg_subcommand_directory}/${_scmd}" ]; then
-			outStr+="$("$0" "${_arg_command_name} ${_scmd}" "${_arg_subcommand_directory}/${_scmd}" "--no-run-completely")\n";
+			outStr+="$("$0" "${_arg_command_name} ${_scmd}" "${_arg_subcommand_directory}/${_scmd}" "--no-run-completely" "--discover-subcommand")\n";
 		fi
 	done
 fi
diff --git a/bin/pos/get-subcmd-directory b/bin/pos/get-subcmd-directory
new file mode 100755
index 0000000..2a54144
--- /dev/null
+++ b/bin/pos/get-subcmd-directory
@@ -0,0 +1,338 @@
+#!/bin/bash
+# @parseArger-begin
+# @parseArger-help "is the arg a sub command" --option "help" --short-option "h"
+# @parseArger-version "0.1" --option "version" --short-option "v"
+# @parseArger-verbose --option "verbose" --level "0"
+# @parseArger-declarations
+# @parseArger pos arg-name "positional argument name"
+# @parseArger pos description "positional argument description"
+# @parseArger opt repeat-min "minimum repeatition forces --repeat" --default-value "1"
+# @parseArger opt repeat-max "maximum repeatition forces --repeat"
+# @parseArger opt one-of "accepted values" --repeat
+# @parseArger opt subcommand-directory "directory containing subcommands, force subcommand, list parseArger script in directory to fill --one-of"
+# @parseArger opt subcommand-variable "array variable containing subcommand parts, force subcommand" --default-value "__subcommand"
+# @parseArger opt complete "bash built-in completely function" --repeat
+# @parseArger opt complete-custom "completely custom dynamic suggestion" --repeat
+# @parseArger flag subcommand-run "run subcommand, forces sub command"
+# @parseArger flag repeat "repeatable" --short r
+# @parseArger flag optional "optional"
+# @parseArger flag subcommand "is a subcommand"
+# @parseArger flag subcommand-use-leftovers "add leftover arguments to subcommand, forces subcommand"
+# @parseArger-declarations-end
+
+# @parseArger-utils
+_helpHasBeenPrinted=1;
+_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)";
+# @parseArger-utils-end
+
+# @parseArger-parsing
+die()
+{
+	local _ret="${2:-1}"
+	test "${_PRINT_HELP:-no}" = yes && print_help >&2
+	log "$1" -3 >&2
+	exit "${_ret}"
+}
+
+
+begins_with_short_option()
+{
+	local first_option all_short_options=''
+	first_option="${1:0:1}"
+	test "$all_short_options" = "${all_short_options/$first_option/}" && return 1 || return 0
+}
+
+# POSITIONALS ARGUMENTS
+_positionals=();
+_arg_arg_name="";
+_arg_description="";
+# OPTIONALS ARGUMENTS
+_arg_repeat_min="1"
+_arg_repeat_max=
+_arg_one_of=()
+_arg_subcommand_directory=
+_arg_subcommand_variable="__subcommand"
+_arg_complete=()
+_arg_complete_custom=()
+# FLAGS
+_arg_subcommand_run="off"
+_arg_repeat="off"
+_arg_optional="off"
+_arg_subcommand="off"
+_arg_subcommand_use_leftovers="off"
+_verbose_level="0";
+
+
+
+print_help()
+{
+	_triggerSCHelp=1;
+
+	if [[ "$_helpHasBeenPrinted" == "1" ]]; then
+		_helpHasBeenPrinted=0;
+		echo -e "is the arg a sub command:"
+	echo -e "	arg-name: positional argument name"
+	echo -e "	description: positional argument description"
+	echo -e "	--repeat-min <repeat-min>: minimum repeatition forces --repeat [default: ' 1 ']"
+	echo -e "	--repeat-max <repeat-max>: maximum repeatition forces --repeat"
+	echo -e "	--one-of <one-of>: accepted values, repeatable"
+	echo -e "	--subcommand-directory <subcommand-directory>: directory containing subcommands, force subcommand, list parseArger script in directory to fill --one-of"
+	echo -e "	--subcommand-variable <subcommand-variable>: array variable containing subcommand parts, force subcommand [default: ' __subcommand ']"
+	echo -e "	--complete <complete>: bash built-in completely function, repeatable"
+	echo -e "	--complete-custom <complete-custom>: completely custom dynamic suggestion, repeatable"
+	echo -e "	--subcommand-run|--no-subcommand-run: run subcommand, forces sub command"
+	echo -e "	-r|--repeat|--no-repeat: repeatable"
+	echo -e "	--optional|--no-optional: optional"
+	echo -e "	--subcommand|--no-subcommand: is a subcommand"
+	echo -e "	--subcommand-use-leftovers|--no-subcommand-use-leftovers: add leftover arguments to subcommand, forces subcommand"
+	echo -e "Usage :
+	$0 <arg-name> <description> [--repeat-min <value>] [--repeat-max <value>] [--one-of <value>] [--subcommand-directory <value>] [--subcommand-variable <value>] [--complete <value>] [--complete-custom <value>] [--[no-]subcommand-run] [--[no-]repeat] [--[no-]optional] [--[no-]subcommand] [--[no-]subcommand-use-leftovers]";
+	fi
+
+}
+
+log() {
+	local _arg_msg="${1}";
+	local _arg_level="${2:"0"}";
+	if [ "${_arg_level}" -le "${_verbose_level}" ]; then
+		case "$_arg_level" in
+			-3)
+				_arg_COLOR="\033[0;31m";
+				;;
+			-2)
+				_arg_COLOR="\033[0;33m";
+				;;
+			-1)
+				_arg_COLOR="\033[1;33m";
+				;;
+			1)
+				_arg_COLOR="\033[0;32m";
+				;;
+			2)
+				_arg_COLOR="\033[1;36m";
+				;;
+			3)
+				_arg_COLOR="\033[0;36m";
+				;;
+			*)
+				_arg_COLOR="\033[0m";
+				;;
+		esac
+		echo -e "${_arg_COLOR}${_arg_msg}\033[0m";
+	fi
+}
+
+parse_commandline()
+{
+	_positionals_count=0
+	while test $# -gt 0
+	do
+		_key="$1"
+		case "$_key" in
+			--repeat-min)
+				test $# -lt 2 && die "Missing value for the option: '$_key'" 1
+				_arg_repeat_min="$2"
+				shift
+				;;
+			--repeat-min=*)
+				_arg_repeat_min="${_key##--repeat-min=}"
+				;;
+			
+			--repeat-max)
+				test $# -lt 2 && die "Missing value for the option: '$_key'" 1
+				_arg_repeat_max="$2"
+				shift
+				;;
+			--repeat-max=*)
+				_arg_repeat_max="${_key##--repeat-max=}"
+				;;
+			
+			--one-of)
+				test $# -lt 2 && die "Missing value for the option: '$_key'" 1
+				_arg_one_of+=("$2")
+				shift
+				;;
+			--one-of=*)
+				_arg_one_of+=("${_key##--one-of=}")
+				;;
+			
+			--subcommand-directory)
+				test $# -lt 2 && die "Missing value for the option: '$_key'" 1
+				_arg_subcommand_directory="$2"
+				shift
+				;;
+			--subcommand-directory=*)
+				_arg_subcommand_directory="${_key##--subcommand-directory=}"
+				;;
+			
+			--subcommand-variable)
+				test $# -lt 2 && die "Missing value for the option: '$_key'" 1
+				_arg_subcommand_variable="$2"
+				shift
+				;;
+			--subcommand-variable=*)
+				_arg_subcommand_variable="${_key##--subcommand-variable=}"
+				;;
+			
+			--complete)
+				test $# -lt 2 && die "Missing value for the option: '$_key'" 1
+				_arg_complete+=("$2")
+				shift
+				;;
+			--complete=*)
+				_arg_complete+=("${_key##--complete=}")
+				;;
+			
+			--complete-custom)
+				test $# -lt 2 && die "Missing value for the option: '$_key'" 1
+				_arg_complete_custom+=("$2")
+				shift
+				;;
+			--complete-custom=*)
+				_arg_complete_custom+=("${_key##--complete-custom=}")
+				;;
+			
+			--subcommand-run)
+				_arg_subcommand_run="on"
+				;;
+			--no-subcommand-run)
+				_arg_subcommand_run="off"
+				;;
+			-r|--repeat)
+				_arg_repeat="on"
+				;;
+			--no-repeat)
+				_arg_repeat="off"
+				;;
+			--optional)
+				_arg_optional="on"
+				;;
+			--no-optional)
+				_arg_optional="off"
+				;;
+			--subcommand)
+				_arg_subcommand="on"
+				;;
+			--no-subcommand)
+				_arg_subcommand="off"
+				;;
+			--subcommand-use-leftovers)
+				_arg_subcommand_use_leftovers="on"
+				;;
+			--no-subcommand-use-leftovers)
+				_arg_subcommand_use_leftovers="off"
+				;;
+			-h|--help)
+				print_help;
+				exit 0;
+				;;
+			-h*)
+				print_help;
+				exit 0;
+				;;
+			-v|--version)
+				print_version;
+				exit 0;
+				;;
+			-v*)
+				print_version;
+				exit 0;
+				;;
+			--verbose)
+				if [ $# -lt 2 ];then
+					_verbose_level="$((_verbose_level + 1))";
+				else
+					_verbose_level="$2";
+					shift;
+				fi
+				;;
+			
+			*)
+				_last_positional="$1"
+				_positionals+=("$_last_positional")
+				_positionals_count=$((_positionals_count + 1))
+				;;
+		esac
+		shift
+	done
+}
+
+
+handle_passed_args_count()
+{
+	local _required_args_string="arg-name description"
+	if [ "${_positionals_count}" -gt 2 ] && [ "$_helpHasBeenPrinted" == "1" ];then
+		_PRINT_HELP=yes die "FATAL ERROR: There were spurious positional arguments --- we expect at most 2 (namely: $_required_args_string), but got ${_positionals_count} (the last one was: '${_last_positional}').\n\t${_positionals[*]}" 1
+	fi
+	if [ "${_positionals_count}" -lt 2 ] && [ "$_helpHasBeenPrinted" == "1" ];then
+		_PRINT_HELP=yes die "FATAL ERROR: Not enough positional arguments - we require at least 2 (namely: $_required_args_string), but got only ${_positionals_count}.
+	${_positionals[*]}" 1;
+	fi
+}
+
+
+assign_positional_args()
+{
+	local _positional_name _shift_for=$1;
+	_positional_names="_arg_arg_name _arg_description ";
+	shift "$_shift_for"
+	for _positional_name in ${_positional_names};do
+		test $# -gt 0 || break;
+		eval "if [ \"\$_one_of${_positional_name}\" != \"\" ];then [[ \"\${_one_of${_positional_name}[*]}\" =~ \"\${1}\" ]];fi" || die "${_positional_name} must be one of: $(eval "echo \"\${_one_of${_positional_name}[*]}\"")" 1;
+		eval "$_positional_name=\${1}" || die "Error during argument parsing, possibly an ParseArger bug." 1;
+		shift;
+	done
+}
+
+print_debug()
+{
+	print_help
+	# shellcheck disable=SC2145
+	echo "DEBUG: $0 $@";
+	
+	echo -e "\targ-name: ${_arg_arg_name}";
+	echo -e "\tdescription: ${_arg_description}";
+	echo -e "\trepeat-min: ${_arg_repeat_min}";
+	echo -e "\trepeat-max: ${_arg_repeat_max}";
+	echo -e "\tone-of: ${_arg_one_of[*]}";
+	echo -e "\tsubcommand-directory: ${_arg_subcommand_directory}";
+	echo -e "\tsubcommand-variable: ${_arg_subcommand_variable}";
+	echo -e "\tcomplete: ${_arg_complete[*]}";
+	echo -e "\tcomplete-custom: ${_arg_complete_custom[*]}";
+	echo -e "\tsubcommand-run: ${_arg_subcommand_run}";
+	echo -e "\trepeat: ${_arg_repeat}";
+	echo -e "\toptional: ${_arg_optional}";
+	echo -e "\tsubcommand: ${_arg_subcommand}";
+	echo -e "\tsubcommand-use-leftovers: ${_arg_subcommand_use_leftovers}";
+
+}
+
+print_version()
+{
+	echo "0.1";
+}
+
+on_interrupt() {
+	die Process aborted! 130;
+}
+
+parse_commandline "$@";
+handle_passed_args_count;
+assign_positional_args 1 "${_positionals[@]}";
+trap on_interrupt INT;
+
+
+
+# @parseArger-parsing-end
+# print_debug "$@"
+# @parseArger-end
+
+if [ "$_arg_subcommand_directory" != "" ]; then
+	if [ -d "$_arg_subcommand_directory" ]; then
+		echo "$_arg_subcommand_directory";
+		exit 0;
+	fi
+fi
+
+echo 1;
+exit 1;