WIP: setup-util: introduce shallow actions

- `has` is now `is-installed` for easier grok
- `setup-util` actions are now grouped into shallow and setup actions, which allows handling of things like the `invoke` action to not trigger `setup-util-*` actions etc; `setup-util-bash` is the larger receipient of these changers
- `setup_util` is now a auto-loading function inside `util.bash`
- consistent dependency and action arguments
- moving to before setup iotons for important actiosn to not conflict with transpose and invoke setup options
- mark dependencies in grouped installers like `setup-util-(devices|devel|docker|mediainfo|samba|trash|vscode|xcode)` to again not trigger invoke etc on dependencies
- fixed some situations where `setup-util` was used instead of `setup_util` and vice versa, such as `setup-util-gh`
- remove some unnecessary but helpful explicit returns - it should become a convention before reinjected - `setup-util-lsb-release`
- remove unncessary setup options for `get-installations` in `setup-util-vscode`, which would cause a conflict with overlapping actions

todos:
- need to figure out invoke for xcode
- need to do the new arg parsing
- need to merge get-app, get-font, and their options
- need to finish 201 status implementation to remove applicability functions

Author: balupton

commands/git-helper

@@ -1573,9 +1573,9 @@ function git_helper() (
 
 	function __review {
 		# @todo make this configurable
-		if setup-util has gitfox; then
+		if setup-util is-installed gitfox; then
 			setup-util invoke gitfox -- "$option_path" "$@" || return $?
-		elif setup-util has tower; then
+		elif setup-util is-installed tower; then
 			setup-util invoke tower -- "$option_path" "$@" || return $?
 		else
 			__print_error 'No supported git reviewers installed.' || :

commands/setup-git

@@ -554,15 +554,17 @@ function setup_git() (
 
 	# if [[ -n "$GITLAB_USERNAME" ]]; then
 	# `glab` writes to stderr, grep needed as return status is not indicative
-	# wrap in `! (` is to catch failures in the grep, and in the glab call
-	# setup-util-glab--optional # only install if gitlab is configured
+	# wrap in `! (` is to catch failures in the grep, and in the glab call:
+	# ```
+	# setup-util-glab --optional # only install if gitlab is configured
 	# if ! (glab auth status 2>&1 | grep --quiet --fixed-strings --regexp='Logged in to '); then
 	# 	glab auth login
 	# fi
 	# ^ currently broken
 	# > glab auth login
 	# failed to read configuration:  open /home/ubuntu/.config/glab-cli/.config.yml2800055398: permission denied
 	# fi
+	# ````
 
 	# =====================================
 	# Done

commands/setup-linux

@@ -415,7 +415,7 @@ function setup_linux() (
 			setup-util-pamac install --optional --confirm
 			setup-util-snap install --optional --confirm
 			setup-util-flatpak install --optional --confirm
-			setup-util-gnome-software --install --optional --confirm
+			setup-util-gnome-software install --optional --confirm
 		fi
 
 		# upgrade all packages

commands/setup-mac

@@ -72,7 +72,7 @@ function setup_mac() (
 
 		# essentials
 		setup-mac-brew "$action"
-		# ^ setup-util-devel done as part of this
+		# ^ `setup-util-devel` done as part of this
 
 		# install and upgrade mac app store apps
 		setup-mac-appstore upstall

commands/setup-system

@@ -90,7 +90,7 @@ function setup_system() (
 		# don't `setup-dns`, as it can cause issues on fragile environments
 		# let users call it themselves
 		setup-git "$action"
-		
+
 		# @todo `setup-utils`
 		# if [[ $action == 'install' ]]; then
 		# 	setup-util install "${SETUP_UTILS[@]}"