v3.7.1

=====================================================================

--- Bug Fixes ----------------------------

- Various github-actions fixes

.github/workflows/test.yaml

@@ -0,0 +1,16 @@
+---
+name: Random Test
+on: push  # yamllint disable-line rule:truthy
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: run a scwrypts thing
+        uses: wrynegade/scwrypts@main
+        with:
+          scwrypt: --name hello-world --group scwrypts --type py
+          args: --message "hello from github actions ci <3"
+
+      - name: cat config stuff
+        shell: bash
+        run: ls ~/.config/scwrypts; cat ~/.config/scwrypts/*

README.md

@@ -48,8 +48,6 @@ There are a few notable changes to this runtime:
 - User yes/no prompts will **always be YES**
 - Other user input will default to an empty string
 - Logs will not be captured
-- Setting the environment variable `SCWRYPTS_GROUP_LOADER__[a-z_]\+` will source the file indicated in the variable (this allows custom groups without needing to modify the `config.zsh` directly)
-	- In GitHub actions, `*.scwrypts.zsh` groups are detected automatically from the `$GITHUB_WORKSPACE`; set `SCWRYPTS_GITHUB_NO_AUTOLOAD=true` to disable
 
 
 ## Contributing

action.yaml

@@ -27,7 +27,7 @@ runs:
     - uses: actions/checkout@v4
       with:
         repository: wrynegade/scwrypts
-        path: ./wrynegade/scwrypts
+        path: $HOME/scwrypts
         ref: ${{ inputs.version }}
 
     - name: check dependencies
@@ -43,7 +43,7 @@ runs:
           sudo apt-get update
           sudo apt-get install --yes zsh fzf ripgrep
 
-          for D in $($GITHUB_WORKSPACE/wrynegade/scwrypts/scwrypts -n --name check-all-dependencies --group ci --type zsh)
+          for D in $($HOME/scwrypts/scwrypts -n --name check-all-dependencies --group ci --type zsh)
           do
             echo "--- installing $D ---"
             ( sudo apt-get install --yes $D; exit 0; )
@@ -51,7 +51,7 @@ runs:
         } > $HOME/.scwrypts.apt-get.log 2>&1
 
         echo "updating virtual dependencies"
-        $GITHUB_WORKSPACE/wrynegade/scwrypts/scwrypts -n \
+        $HOME/scwrypts/scwrypts -n \
           --name scwrypts/virtualenv/update-all \
           --group scwrypts \
           --type zsh \
@@ -65,4 +65,4 @@ runs:
       env:
         CI: true
         SCWRYPTS_ENV: ${{ inputs.scwrypts-env }}
-      run: $GITHUB_WORKSPACE/wrynegade/scwrypts/scwrypts ${{inputs.scwrypt}} -- ${{inputs.args}} || exit 1
+      run: $HOME/scwrypts/scwrypts ${{inputs.scwrypt}} -- ${{inputs.args}} || exit 1

plugins/kubectl/driver/kubectl.completion.zsh

@@ -2,45 +2,30 @@
 command -v compdef >/dev/null 2>&1 || return 0
 #####################################################################
 
-for CLI in kubectl helm flux
+_k() {
-do
+	local C=$(k meta get context)
-	eval "_${CLI[1]}() {
+	local NS=$(k meta get namespace)
-		local SUBSESSION=0
-		echo \${words[2]} | grep -q '^[0-9]\\+$' && SUBSESSION=\${words[2]}
 
-		local PASSTHROUGH_WORDS=($CLI)
+	local KUBEWORDS=(kubectl)
-		[[ \$CURRENT -gt 2 ]] && echo \${words[2]} | grep -qv '^[0-9]\\+$' && {
+	[ $C  ] && KUBEWORDS+=(--context $C)
-			local KUBECONTEXT=\$(k \$SUBSESSION meta get context)
+	[ $NS ] && KUBEWORDS+=(--namespace $NS)
-			local NAMESPACE=\$(k \$SUBSESSION meta get namespace)
 
-			[ \$KUBECONTEXT ] \
+	words="$KUBEWORDS ${words[@]:1}"
-				&& PASSTHROUGH_WORDS+=($([[ $CLI =~ ^helm$ ]] && echo '--kube-context' || echo '--context') \$KUBECONTEXT) \
+	_kubectl
-				;
+}
-			[ \$NAMESPACE   ] \
-				&& PASSTHROUGH_WORDS+=(--namespace \$NAMESPACE) \
-				;
-		}
 
-		local DELIMIT_COUNT=0
+compdef _k  k
-		local WORD
-		for WORD in \${words[@]:1}
-		do
-			case \$WORD in
-				[0-9]* ) continue ;;
-				-- )
-					echo \$words | grep -q 'exec' && ((DELIMIT_COUNT+=1))
-					[[ \$DELIMIT_COUNT -eq 0 ]] && ((DELIMIT_COUNT+=1)) && continue
-					;;
-			esac
-			PASSTHROUGH_WORDS+=(\"\$WORD\")
-		done
 
-		echo \"\$words\" | grep -q '\\s\\+$' && PASSTHROUGH_WORDS+=(' ')
+#####################################################################
+_h() {
+	local C=$(k meta get context)
+	local NS=$(k meta get namespace)
 
-		words=\"\$PASSTHROUGH_WORDS\"
+	local KUBEWORDS=(kubectl)
-		_$CLI
+	[ $C  ] && KUBEWORDS+=(--context $C)
-	}
+	[ $NS ] && KUBEWORDS+=(--namespace $NS)
-	"
 
-	compdef _${CLI[1]} ${CLI[1]}
+	words="$KUBEWORDS ${words[@]:1}"
-done
+	_helm
+}
+compdef _h  h

plugins/kubectl/driver/kubectl.driver.zsh

@@ -3,7 +3,6 @@
 unalias k h >/dev/null 2>&1
 k() { _SCWRYPTS_KUBECTL_DRIVER kubectl $@; }
 h() { _SCWRYPTS_KUBECTL_DRIVER helm $@; }
-f() { _SCWRYPTS_KUBECTL_DRIVER flux $@; }
 
 
 _SCWRYPTS_KUBECTL_DRIVER() {
@@ -58,7 +57,7 @@ _SCWRYPTS_KUBECTL_DRIVER() {
 	"
 
 	local USAGE__description="
-		Provides 'k' (kubectl), 'h' (helm), and 'f' (flux) shorthands to the respective
+		Provides 'k' (kubectl) and 'h' (helm) shorthands to the respective
 		utility. These functions leverage redis and scwrypts environments to
 		allow quick selection of contexts and namespaces usable across all
 		active shell instances.
@@ -101,20 +100,18 @@ _SCWRYPTS_KUBECTL_DRIVER() {
 			--subsession ) SUBSESSION=$2; shift 1 ;;
 
 			-n | --namespace )
-				_SCWRYPTS_KUBECTL_DRIVER kubectl meta set namespace $2
+				echo "TODO: set namespace ('$2')" >&2
-				shift 1
+				USER_ARGS+=(--namespace $2); shift 1
 				;;
 
 			-k | --context | --kube-context )
-				_SCWRYPTS_KUBECTL_DRIVER kubectl meta set context $2
+				echo "TODO: set context ('$2')" >&2
+				[[ $CLI =~ ^helm$    ]] && USER_ARGS+=(--kube-context $2)
+				[[ $CLI =~ ^kubectl$ ]] && USER_ARGS+=(--context $2)
 				shift 1
 				;;
 
-			-- )
+			-- ) shift 1; break ;;
-				echo $USER_ARGS | grep -q 'exec' && USER_ARGS+=(--)
-				shift 1
-				break
-				;;
 
 			* )
 				[ ! $CUSTOM_COMMAND ] && {
@@ -152,7 +149,6 @@ _SCWRYPTS_KUBECTL_DRIVER() {
 
 			[ $CONTEXT ] && [[ $CLI =~ ^helm$    ]] && CLI_ARGS+=(--kube-context $CONTEXT)
 			[ $CONTEXT ] && [[ $CLI =~ ^kubectl$ ]] && CLI_ARGS+=(--context $CONTEXT)
-			[ $CONTEXT ] && [[ $CLI =~ ^flux$    ]] && CLI_ARGS+=(--context $CONTEXT)
 
 			[[ $STRICT -eq 1 ]] && {
 				[ $CONTEXT   ] || ERROR "missing kubectl 'context'"

plugins/kubectl/driver/meta.zsh

@@ -30,15 +30,8 @@ SCWRYPTS_KUBECTL_CUSTOM_COMMAND_PARSE__meta() {
 				USAGE__args="set (namespace|context)"
 				USAGE__description="interactively set a namespace or context for '$SCWRYPTS_ENV'"
 				case $2 in
-					namespace | context ) USER_ARGS+=($1 $2 $3); [ $3 ] && shift 1 ;;
+					namespace | context ) USER_ARGS+=($1 $2) ;;
 					-h | --help ) HELP=1 ;;
-					'' )
-						: \
-							&& SCWRYPTS_KUBECTL_CUSTOM_COMMAND__meta set context \
-							&& SCWRYPTS_KUBECTL_CUSTOM_COMMAND__meta set namespace \
-							;
-						return $?
-						;;
 
 					* ) ERROR "cannot set '$2'" ;;
 				esac
@@ -101,7 +94,7 @@ SCWRYPTS_KUBECTL_CUSTOM_COMMAND__meta() {
 			;;
 
 		set )
-			scwrypts -n --name set-$2 --type zsh --group kubectl -- $3 --subsession $SUBSESSION >/dev/null \
+			scwrypts -n --name set-$2 --type zsh --group kubectl -- --subsession $SUBSESSION >/dev/null \
 				&& SUCCESS "$2 set"
 			;;
 

plugins/kubectl/lib/kubectl.module.zsh

@@ -21,6 +21,7 @@ KUBECTL() {
 	kubectl ${KUBECTL_ARGS[@]} $@
 }
 
+
 #####################################################################
 
 KUBECTL__GET_CONTEXT() { REDIS get --prefix "current:context"; }
@@ -86,73 +87,3 @@ KUBECTL__LIST_NAMESPACES() {
 	echo default
 	KUBECTL get namespaces -o name | sed 's/^namespace\///' | sort
 }
-
-#####################################################################
-
-KUBECTL__SERVE() {
-	[ $CONTEXT ] || local CONTEXT=$(KUBECTL__GET_CONTEXT)
-	[ $CONTEXT ] || ERROR 'must configure a context in which to serve'
-
-	[ $NAMESPACE ] || local NAMESPACE=$(KUBECTL__GET_NAMESPACE)
-	[ $NAMESPACE ] || ERROR 'must configure a namespace in which to serve'
-
-	CHECK_ERRORS --no-fail --no-usage || return 1
-
-	[ $SERVICE ] && SERVICE=$(KUBECTL__LIST_SERVICES | jq -c "select (.service == \"$SERVICE\")" || echo $SERVICE)
-	[ $SERVICE ] || local SERVICE=$(KUBECTL__SELECT_SERVICE)
-	[ $SERVICE ] || ERROR 'must provide or select a service'
-
-	KUBECTL__LIST_SERVICES | grep -q "^$SERVICE$"\
-		|| ERROR "no service '$SERVICE' in '$CONFIG/$NAMESPACE'"
-
-	CHECK_ERRORS --no-fail --no-usage || return 1
-
-	##########################################
-
-	SERVICE_PASSWORD="$(KUBECTL__GET_SERVICE_PASSWORD)"
-	KUBECTL__SERVICE_PARSE
-
-	INFO "attempting to serve ${NAMESPACE}/${SERVICE_NAME}:${SERVICE_PORT}"
-	[ $SERVICE_PASSWORD ] && INFO "password : $SERVICE_PASSWORD"
-
-	KUBECTL port-forward service/$SERVICE_NAME $SERVICE_PORT
-}
-
-KUBECTL__SELECT_SERVICE() {
-	[ $NAMESPACE ] || local NAMESPACE=$(KUBECTL__GET_NAMESPACE)
-	[ $NAMESPACE ] || return 1
-
-	local SERVICES=$(KUBECTL__LIST_SERVICES)
-	local SELECTED=$({
-		echo "namespace service port"
-		echo $SERVICES \
-			| jq -r '.service + " " + .port' \
-			| sed "s/^/$NAMESPACE /" \
-			;
-	} \
-		| column -t \
-		| FZF 'select a service' --header-lines=1 \
-		| awk '{print $2;}' \
-	)
-
-	echo $SERVICES | jq -c "select (.service == \"$SELECTED\")"
-}
-
-KUBECTL__LIST_SERVICES() {
-	KUBECTL get service --no-headers\
-		| awk '{print "{\"service\":\""$1"\",\"ip\":\""$3"\",\"port\":\""$5"\"}"}' \
-		| jq -c 'select (.ip != "None")' \
-		;
-}
-
-KUBECTL__GET_SERVICE_PASSWORD() {
-	[ $PASSWORD_SECRET ] && [ $PASSWORD_KEY ] || return 0
-
-	KUBECTL get secret $PASSWORD_SECRET -o jsonpath="{.data.$PASSWORD_KEY}" \
-		| base64 --decode
-}
-
-KUBECTL__SERVICE_PARSE() {
-	SERVICE_NAME=$(echo $SERVICE | jq -r .service)
-	SERVICE_PORT=$(echo $SERVICE | jq -r .port | sed 's|/.*$||')
-}

plugins/kubectl/serve

@@ -1,58 +0,0 @@
-#!/bin/zsh
-#####################################################################
-DEPENDENCIES+=()
-REQUIRED_ENV+=()
-
-use kubectl --group kubectl
-
-CHECK_ENVIRONMENT
-#####################################################################
-
-MAIN() {
-	local USAGE="
-	usage: [service] [...options...]
-
-	args:
-	  service   (optional) name of the service to forward locally
-
-	options:
-	  --context      override context
-	  --namespace    override namespace
-	  --subsession   REDIS subsession (default 0)
-
-	  to show a required password on screen, use both:
-	  --password-secret   Secret resource
-	  --password-key      key within Secret's 'data'
-
-	  -h, --help   show this dialogue and exit
-	"
-	local CONTEXT NAMESPACE SERVICE
-	local SUBSESSION=0
-
-	while [[ $# -gt 0 ]]
-	do
-		case $1 in
-			--context    ) CONTEXT=$2; shift 1 ;;
-			--namespace  ) NAMESPACE=$2; shift 1 ;;
-			--subsession ) SUBSESSION=$2; shift 1 ;;
-
-			--password-secret ) PASSWORD_SECRET=$2; shift 1 ;;
-			--password-key    ) PASSWORD_KEY=$2; shift 1 ;;
-
-			-h | --help ) USAGE; return 0 ;;
-
-			* )
-				[ $SERVICE ] && ERROR "unexpected argument '$2'"
-				SERVICE=$1
-				;;
-		esac
-		shift 1
-	done
-
-	CHECK_ERRORS
-
-	KUBECTL__SERVE 
-}
-
-#####################################################################
-MAIN $@

plugins/kubectl/set-context

@@ -17,8 +17,6 @@ MAIN() {
 
 	options:
 	  --subsession   REDIS subsession (default 0)
-
-	  -h, --help   show this dialogue and exit
 	"
 	local CONTEXT
 	local SUBSESSION=0
@@ -28,8 +26,6 @@ MAIN() {
 		case $1 in
 			--subsession ) SUBSESSION=$2; shift 1 ;;
 
-			-h | --help ) USAGE; return 0 ;;
-
 			* )
 				[ $CONTEXT ] && ERROR "unexpected argument '$2'"
 				CONTEXT=$1

plugins/kubectl/set-namespace

@@ -17,8 +17,6 @@ MAIN() {
 
 	options:
 	  --subsession   REDIS subsession (default 0)
-
-	  -h, --help   show this dialogue and exit
 	"
 	local NAMESPACE
 	local SUBSESSION=0
@@ -28,8 +26,6 @@ MAIN() {
 		case $1 in
 			--subsession ) SUBSESSION=$2; shift 1 ;;
 
-			-h | --help ) USAGE; return 0 ;;
-
 			* )
 				[ $NAMESPACE ] && ERROR "unexpected argument '$2'"
 				NAMESPACE=$1

run

@@ -6,35 +6,22 @@ source "${0:a:h}/zsh/lib/import.driver.zsh" || exit 42
 
 __RUN() {
 	local USAGE='
-		usage: scwrypts [... options ...] [patterns] -- [...script options...]
+		usage: scwrypts [OPTIONS ...] SCRIPT -- [SCRIPT OPTIONS ...]
 
-		options:
+		OPTIONS
-		  selection
+		  -g, --group <group-name>    only use scripts from the indicated group
-		    -m, --name <scwrypt-name>   only run the script if there is an exact match
+		  -t, --type <type-name>      only use scripts of the indicated type
-		                                  (requires type and group)
+		  -m, --name <scwrypt-name>   only run the script if there is an exact match 
-		    -g, --group <group-name>    only use scripts from the indicated group
+		                                (requires type and group)
-		    -t, --type <type-name>      only use scripts of the indicated type
 
-		  runtime
+		  -e, --env <env-name>   set environment; overwrites SCWRYPTS_ENV
-		    -y, --yes              auto-accept all [yn] prompts through current scwrypt
+		  -n, --no-log           skip logging and run in quiet mode
-		    -e, --env <env-name>   set environment; overwrites SCWRYPTS_ENV
-		    -q, --quiet            run in quiet mode
-		    -n, --no-log           skip the log file and run in quiet mode
-		    -v, --verbose          override quiet mode settings and print all debug dialogue
 
-		  alternate commands
+		  --update   update scwrypts library to latest version
-		    -h, --help        display this message and exit
-		    -l, --list        print out command list and exit
-		        --list-envs   print out environment list and exit
-		        --update      update scwrypts library to latest version
-		        --version     print out scwrypts version and exit
-		
-		patterns:
-		  - a list of glob patterns to loose-match a scwrypt by name
 
-		script options:
+		  -v, --version   print out scwrypts version and exit
-		  - everything after "--" is forwarded to the scwrypt you run
+		  -l, --list      print out command list and exit
-		    (usually "-- --help" will provide more information)
+		  -h, --help      display this message and exit
 	'
 	cd "$SCWRYPTS_ROOT"
 
@@ -43,29 +30,58 @@ __RUN() {
 
 	local VARSPLIT SEARCH_GROUP SEARCH_TYPE SEARCH_NAME
 
-	local ALLOW_LOGFILE=1
-	local VERBOSE=1
-
-	[ $CI ] && [ ! $SCWRYPTS_CI_FORCE_NON_VERBOSE ] && VERBOSE=2
-
 	local ERROR=0
 
 	while [[ $# -gt 0 ]]
 	do
 		case $1 in
+			-t | --type )
+				[ ! $2 ] && ERROR "missing value for argument $1" && break
+				SEARCH_TYPE=$2
+				shift 2
+				;;
+			-g | --group )
+				[ ! $2 ] && ERROR "missing value for argument $1" && break
+				SEARCH_GROUP=$2
+				shift 2
+				;;
+			-m | --name )
+				[ ! $2 ] && ERROR "missing value for argument $1" && break
+				SEARCH_NAME=$2
+				shift 2
+				;;
+
 			-[a-z][a-z]* )
 				VARSPLIT=$(echo "$1 " | sed 's/^\(-.\)\(.*\) /\1 -\2/')
 				set -- $(echo " $VARSPLIT ") ${@:2}
 				;;
-
+			-h | --help )
-			-h | --help ) USAGE; return 0 ;;
+				USAGE
-			-l | --list ) SCWRYPTS__GET_AVAILABLE_SCWRYPTS; return 0 ;;
-			--list-envs ) SCWRYPTS__GET_ENV_NAMES; return 0 ;;
-			--version )
-				echo scwrypts $(git -C "$SCWRYPTS__ROOT__scwrypts" describe --tags)
 				return 0
 				;;
+			-n | --no-log )
+				[ ! $SUBSCWRYPT ] && SUBSCWRYPT=0
+				shift 1
+				;;
+			-e | --env )
+				[ ! $2 ] && ERROR "missing value for argument $1" && break
+				[ ! $SUBSCWRYPTS ] \
+					&& [ $ENV_NAME ] \
+					&& WARNING 'overwriting session environment' \
+					;
 
+				ENV_NAME="$2"
+				STATUS "using CLI environment '$ENV_NAME'"
+				shift 2
+				;;
+			-l | --list )
+				SCWRYPTS__GET_AVAILABLE_SCWRYPTS
+				return 0
+				;;
+			-v | --version )
+				echo scwrypts $(cd "$SCWRYPTS__ROOT__scwrypts"; git describe --tags)
+				return 0
+				;;
 			--update )
 				cd "$SCWRYPTS__ROOT__scwrypts"
 				git fetch --quiet origin main
@@ -88,53 +104,24 @@ __RUN() {
 				}
 				return 0
 				;;
-
+			-- )
-			-m | --name )
+				shift 1
-				[ ! $2 ] && ERROR "missing value for argument $1" && break
+				break # pass arguments after '--' to the scwrypt
-				SEARCH_NAME=$2
+				;;
+			--* )
+				ERROR "unrecognized argument '$1'"
 				shift 1
 				;;
-
+			* )
-			-g | --group )
+				SEARCH_PATTERNS+=($1)
-				[ ! $2 ] && ERROR "missing value for argument $1" && break
-				SEARCH_GROUP=$2
 				shift 1
 				;;
-
-			-t | --type )
-				[ ! $2 ] && ERROR "missing value for argument $1" && break
-				SEARCH_TYPE=$2
-				shift 1
-				;;
-
-			-y | --yes     ) export __SCWRYPTS_YES=1 ;;
-			-q | --quiet   ) VERBOSE=0 ;;
-			-n | --no-log  ) VERBOSE=0 ; [ ! $SUBSCWRYPT ] && SUBSCWRYPT=0 ;;
-			-v | --verbose ) VERBOSE=2 ;;
-
-			-e | --env )
-				[ ! $2 ] && ERROR "missing value for argument $1" && break
-				[ ! $SUBSCWRYPTS ] \
-					&& [ $ENV_NAME ] \
-					&& WARNING 'overwriting session environment' \
-					;
-
-				ENV_NAME="$2"
-				STATUS "using CLI environment '$ENV_NAME'"
-				shift 1
-				;;
-
-
-			--  ) shift 1; break ;; # pass arguments after '--' to the scwrypt
-			--* ) ERROR "unrecognized argument '$1'" ;;
-			*   ) SEARCH_PATTERNS+=($1) ;;
 		esac
-		shift 1
 	done
 
 	[ $SEARCH_NAME ] && {
-		[ $SEARCH_TYPE  ] || ERROR '--name requires --type argument'
+		[ ! $SEARCH_TYPE  ] && ERROR '--name requires --type argument'
-		[ $SEARCH_GROUP ] || ERROR '--name requires --group argument'
+		[ ! $SEARCH_GROUP ] && ERROR '--name requires --group argument'
 	}
 
 	CHECK_ERRORS
@@ -143,7 +130,7 @@ __RUN() {
 
 	local SCWRYPTS_AVAILABLE
 	local POTENTIAL_ERROR="no such scwrypt exists:"
-
+	
 	SCWRYPTS_AVAILABLE=$(SCWRYPTS__GET_AVAILABLE_SCWRYPTS)
 
 	[ $SEARCH_NAME ] && {
@@ -208,12 +195,9 @@ __RUN() {
 	local TYPE="$SEARCH_TYPE"
 	local GROUP="$SEARCH_GROUP"
 
-	[[ $(echo $SCWRYPTS_AVAILABLE | wc -l) -eq 2 ]] && {
+	[[ $(echo $SCWRYPTS_AVAILABLE | wc -l) -eq 2 ]] \
-		SCWRYPT_SELECTION=$(echo $SCWRYPTS_AVAILABLE | tail -n1)
+		&& SCWRYPT_SELECTION=$(echo $SCWRYPTS_AVAILABLE | tail -n1) \
-		[[ $VERBOSE -eq 2 ]] || VERBOSE=0
+		|| SCWRYPT_SELECTION=$(echo $SCWRYPTS_AVAILABLE | FZF "select a script to run" --header-lines 1)
-	} || {
-		SCWRYPT_SELECTION=$(echo $SCWRYPTS_AVAILABLE | FZF "select a script to run" --header-lines 1)
-	}
 	[ $SCWRYPT_SELECTION ] || exit 2
 
 	SCWRYPTS__SEPARATE_SCWRYPT_SELECTION $SCWRYPT_SELECTION
@@ -234,7 +218,6 @@ __RUN() {
 
 	[[ $ENV_REQUIRED -eq 1 ]] && {
 		[ ! $ENV_NAME ] && ENV_NAME=$(SCWRYPTS__SELECT_ENV)
-
 		for GROUP in ${SCWRYPTS_GROUPS[@]}
 		do
 			local ENV_FILE=$(SCWRYPTS__GET_ENV_FILE "$ENV_NAME" "$GROUP")
@@ -256,8 +239,7 @@ __RUN() {
 
 	##########################################
 
-	: \
+	[ ! $SUBSCWRYPT ] \
-		&& [ ! $SUBSCWRYPT ] \
 		&& [[ $ENV_NAME =~ prod ]] \
 		&& { __VALIDATE_UPSTREAM_TIMELINE || ABORT; }
 
@@ -271,7 +253,6 @@ __RUN() {
 	local LOGFILE=$(__GET_LOGFILE)
 
 	local HEADER=$(
-		[[ $VERBOSE -gt 0 ]] || return 0
 		[ $SUBSCWRYPT ] && return 0
 		echo '====================================================================='
 		echo "script : $SCWRYPT_GROUP $SCWRYPT_TYPE $SCWRYPT_NAME"
@@ -293,14 +274,14 @@ __RUN() {
 
 	{
 		[ $HEADER ] && echo $HEADER
-		[[ $VERBOSE -gt 0 ]] && echo '\033[1;33m--- BEGIN OUTPUT -------------------------\033[0m'
+		echo '\033[1;33m--- BEGIN OUTPUT -------------------------\033[0m'
 		(eval "$RUN_STRING $(printf "%q " "$@")")
 		EXIT_CODE=$?
-		[[ $VERBOSE -gt 0 ]] && echo '\033[1;33m--- END OUTPUT ---------------------------\033[0m'
+		echo '\033[1;33m--- END OUTPUT ---------------------------\033[0m'
 
 		[[ $EXIT_CODE -eq 0 ]] && EXIT_COLOR='32m' || EXIT_COLOR='31m'
 
-		[[ $VERBOSE -gt 0 ]] && echo "terminated with\\033[1;$EXIT_COLOR code $EXIT_CODE\\033[0m"
+		echo "terminated with\\033[1;$EXIT_COLOR code $EXIT_CODE\\033[0m"
 	} 2>&1 | tee --append "$LOGFILE"
 
 	exit $(\
@@ -342,9 +323,10 @@ __VALIDATE_UPSTREAM_TIMELINE() {
 }
 
 __GET_LOGFILE() {
-	[ $SUBSCWRYPT ] && return 0
+	[ $SUBSCWRYPT ] \
-	[[ $SCWRYPT_NAME =~ scwrypts/logs ]] && return 0
+		|| [[ $SCWRYPT_NAME =~ scwrypts/logs ]] \
-	[[ $SCWRYPT_NAME =~ interactive ]] && return 0
+		|| [[ $SCWRYPT_NAME =~ interactive ]] \
+		&& return 0
 
 	echo "$SCWRYPTS_LOG_PATH/$(echo $GROUP/$TYPE/$NAME | sed 's/^\.\///; s/\//\%/g').log"
 }

scwrypts.plugin.zsh

@@ -6,7 +6,7 @@ SCWRYPTS__ZSH_PLUGIN() {
 	local NAME
 	local TYPE
 	local GROUP
-	LBUFFER= RBUFFER=
+	zle clear-command-line
 	[ ! $SCWRYPT_SELECTION ] && { zle accept-line; return 0; }
 
 	SCWRYPTS__SEPARATE_SCWRYPT_SELECTION $SCWRYPT_SELECTION
@@ -14,40 +14,13 @@ SCWRYPTS__ZSH_PLUGIN() {
 	which scwrypts >/dev/null 2>&1\
 		&& RBUFFER="scwrypts" || RBUFFER="$SCWRYPTS_ROOT/scwrypts"
 
-	RBUFFER+=" --name $NAME --group $GROUP --type $TYPE --verbose"
+	RBUFFER+=" --name $NAME --group $GROUP --type $TYPE"
 	zle accept-line
 }
 
 zle -N scwrypts SCWRYPTS__ZSH_PLUGIN
 bindkey $SCWRYPTS_SHORTCUT scwrypts
 
-#####################################################################
-SCWRYPTS__ZSH_BUILDER_PLUGIN() {
-	local SCWRYPT_SELECTION=$(SCWRYPTS__GET_AVAILABLE_SCWRYPTS | FZF 'select a script' --header-lines 1)
-	local NAME
-	local TYPE
-	local GROUP
-	LBUFFER= RBUFFER=
-	[ ! $SCWRYPT_SELECTION ] && { zle accept-line; return 0; }
-
-	SCWRYPTS__SEPARATE_SCWRYPT_SELECTION $SCWRYPT_SELECTION
-
-	scwrypts --name $NAME --group $GROUP --type $TYPE -- --help >&2 || {
-		zle accept-line
-		return 0
-	}
-	echo
-
-	zle reset-prompt
-	which scwrypts >/dev/null 2>&1\
-		&& LBUFFER="scwrypts" || LBUFFER="$SCWRYPTS_ROOT/scwrypts"
-
-	LBUFFER+=" --name $NAME --group $GROUP --type $TYPE -- "
-}
-
-zle -N scwrypts-builder SCWRYPTS__ZSH_BUILDER_PLUGIN
-bindkey $SCWRYPTS_BUILDER_SHORTCUT scwrypts-builder
-
 #####################################################################
 SCWRYPTS__ZSH_PLUGIN_ENV() {
 	local RESET='reset'

zsh/cloud/aws/ecr/login

@@ -1,7 +1,10 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use cloud/aws/ecr
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+ECR_LOGIN $@
-	ECR_LOGIN $@
-}

zsh/cloud/aws/efs/mount

@@ -3,9 +3,11 @@ DEPENDENCIES+=(jq)
 REQUIRED_ENV+=(AWS__EFS__LOCAL_MOUNT_POINT)
 
 use cloud/aws/cli
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+EFS_CONNECT() {
 	GETSUDO || exit 1
 	[ ! -d $AWS__EFS__LOCAL_MOUNT_POINT ] && {
 		sudo mkdir $AWS__EFS__LOCAL_MOUNT_POINT \
@@ -62,3 +64,6 @@ MAIN() {
 		FAIL 2 "unable to mount '$FS_ID'"
 	}
 }
+
+#####################################################################
+EFS_CONNECT $@

zsh/cloud/aws/efs/unmount

@@ -3,9 +3,11 @@ DEPENDENCIES+=(jq)
 REQUIRED_ENV+=(AWS__EFS__LOCAL_MOUNT_POINT)
 
 use cloud/aws/cli
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+EFS_DISCONNECT() {
 	[ ! -d "$AWS__EFS__LOCAL_MOUNT_POINT" ] && {
 		STATUS 'no efs currently mounted'
 		exit 0
@@ -30,3 +32,6 @@ MAIN() {
 		&& SUCCESS "done" \
 		|| FAIL 2 "failed to unmount '$EFS'"
 }
+
+#####################################################################
+EFS_DISCONNECT $@

zsh/cloud/aws/eks/login

@@ -1,7 +1,10 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use cloud/aws/eks
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+EKS_CLUSTER_LOGIN $@
-	EKS__CLUSTER_LOGIN $@
-}

zsh/cloud/aws/rds/create-backup

@@ -1,11 +1,19 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use cloud/aws/rds
 use db/postgres
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+CREATE_BACKUP() {
 	local DB_HOST DB_PORT DB_NAME DB_USER DB_PASS
 	RDS__GET_DATABASE_CREDENTIALS $@ || return 1
 
 	PG_DUMP
 }
+
+#####################################################################
+CREATE_BACKUP $@

zsh/cloud/aws/rds/interactive-login

@@ -1,11 +1,20 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use cloud/aws/rds
 use db/postgres
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+RDS_INTERACTIVE_LOGIN() {
 	local DB_HOST DB_PORT DB_NAME DB_USER DB_PASS
 	RDS__GET_DATABASE_CREDENTIALS $@ || return 1
 
 	POSTGRES__LOGIN_INTERACTIVE
 }
+
+
+#####################################################################
+RDS_INTERACTIVE_LOGIN $@

zsh/cloud/aws/rds/load-backup

@@ -1,11 +1,20 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use cloud/aws/rds
 use db/postgres
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+LOAD_BACKUP() {
 	local DB_HOST DB_PORT DB_NAME DB_USER DB_PASS
 	RDS__GET_DATABASE_CREDENTIALS $@ || return 1
 
 	PG_RESTORE
 }
+
+
+#####################################################################
+LOAD_BACKUP $@

zsh/cloud/aws/route53/backup

@@ -1,9 +1,11 @@
 #!/bin/zsh
 DEPENDENCIES+=(cli53)
 REQUIRED_ENV+=(AWS_PROFILE)
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+ROUTE53_BACKUP() {
 	local BACKUP_PATH="$SCWRYPTS_OUTPUT_PATH/$ENV_NAME/aws-dns-backup/$(date '+%Y-%m-%d')"
 	mkdir -p $BACKUP_PATH >/dev/null 2>&1
 
@@ -23,11 +25,12 @@ MAIN() {
 	for P in ${JOBS[@]}; do wait $P >/dev/null 2>&1; done
 }
 
-#####################################################################
-
 ROUTE53_GET_DOMAINS() {
 	cli53 list --profile $AWS_PROFILE \
 		| awk '{print $2;}' \
 		| sed '1d; s/\.$//'\
 		;
 }
+
+#####################################################################
+ROUTE53_BACKUP

zsh/cloud/media-sync/pull

@@ -1,7 +1,10 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use cloud/media-sync
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+MEDIA_SYNC__PULL $@
-	MEDIA_SYNC__PULL $@
-}

zsh/cloud/media-sync/push

@@ -1,7 +1,10 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use cloud/media-sync
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+MEDIA_SYNC__PUSH $@
-	MEDIA_SYNC__PUSH $@
-}

zsh/db/postgres/interactive-pgcli

@@ -1,7 +1,9 @@
 #!/bin/zsh
-use db/postgres
+DEPENDENCIES+=()
-#####################################################################
+REQUIRED_ENV+=()
 
-MAIN() {
+use db/postgres
-	POSTGRES__LOGIN_INTERACTIVE $@
+
-}
+CHECK_ENVIRONMENT
+#####################################################################
+POSTGRES__LOGIN_INTERACTIVE $@

zsh/db/postgres/pg_dump

@@ -1,7 +1,9 @@
 #!/bin/zsh
-use db/postgres
+DEPENDENCIES+=()
-#####################################################################
+REQUIRED_ENV+=()
 
-MAIN() {
+use db/postgres
-	PG_DUMP $@
+
-}
+CHECK_ENVIRONMENT
+#####################################################################
+PG_DUMP $@

zsh/db/postgres/pg_restore

@@ -1,7 +1,9 @@
 #!/bin/zsh
-use db/postgres
+DEPENDENCIES+=()
-#####################################################################
+REQUIRED_ENV+=()
 
-MAIN() {
+use db/postgres
-	PG_RESTORE $@
+
-}
+CHECK_ENVIRONMENT
+#####################################################################
+PG_RESTORE $@

zsh/db/postgres/run-sql

@@ -1,9 +1,13 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use db/postgres
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+RUN_SQL_POSTGRES() {
-	WARNING " \nthis function is in a beta state\n "
 	local _PASS _ARGS=()
 	POSTGRES__SET_LOGIN_ARGS $@
 
@@ -39,3 +43,9 @@ MAIN() {
 		&& SUCCESS "finished running '$INPUT_FILE'" \
 		|| FAIL 3 "something went wrong running '$INPUT_FILE' (see above)"
 }
+
+#####################################################################
+WARNING
+WARNING 'this function is in a beta state'
+WARNING
+RUN_SQL_POSTGRES $@

zsh/docker/cleanup

@@ -1,8 +1,11 @@
 #!/bin/zsh
 DEPENDENCIES+=(docker)
+REQUIRED_ENV+=()
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+DOCKER_CLEAN() {
 	WARNING 'this will prune all docker resources from the current machine'
 	WARNING 'pruned resources are PERMANENTLY DELETED'
 	yN 'continue?' || return 1
@@ -11,3 +14,6 @@ MAIN() {
 	SUCCESS "IMAGE     : $(docker image prune -f 2>/dev/null | tail -n 1)"
 	SUCCESS "VOLUME    : $(docker volume prune -f 2>/dev/null | tail -n 1)"
 }
+
+#####################################################################
+DOCKER_CLEAN $@

zsh/hello-world

@@ -1,4 +1,8 @@
 #!/bin/zsh
-MAIN() {
+DEPENDENCIES+=()
-	SUCCESS 'hello world!'
+REQUIRED_ENV+=()
-}
+
+CHECK_ENVIRONMENT
+#####################################################################
+
+SUCCESS 'hello world!'

zsh/helm/get-template

@@ -1,9 +1,17 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use helm
 use scwrypts
+
+CHECK_ENVIRONMENT
 #####################################################################
 
 MAIN() {
 	unset USAGE
 	HELM__TEMPLATE__GET $@
 }
+
+#####################################################################
+MAIN $@

zsh/helm/update-dependencies

@@ -1,9 +1,17 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use helm
 use scwrypts
+
+CHECK_ENVIRONMENT
 #####################################################################
 
 MAIN() {
 	unset USAGE
 	HELM__DEPENDENCY__UPDATE $@
 }
+
+#####################################################################
+MAIN $@

zsh/lib/cloud/aws/eks.module.zsh

@@ -1,44 +1,19 @@
 #####################################################################
 
-DEPENDENCIES+=(kubectl yq)
+DEPENDENCIES+=(
-REQUIRED_ENV+=()
+	kubectl
+)
+
+REQUIRED_ENV+=(
+	AWS_ACCOUNT
+	AWS_REGION
+)
 
 use cloud/aws/cli
 
 #####################################################################
 
-EKS__KUBECTL() { EKS kubectl $@; }
+EKS_CLUSTER_LOGIN() {
-EKS__FLUX()    { EKS flux $@; }
-
-#####################################################################
-
-EKS() {
-	local USAGE="
-		usage: cli [...kubectl args...]
-
-		args:
-		  cli   a kubectl-style CLI (e.g. kubectl, helm, flux, etc)
-
-		Allows access to kubernetes CLI commands by configuring environment
-		to point to a specific cluster.
-	"
-
-	REQUIRED_ENV=(AWS_REGION AWS_ACCOUNT CLUSTER_NAME) DEPENDENCIES=(kubectl $1) CHECK_ENVIRONMENT || return 1
-
-	local CONTEXT="arn:aws:eks:${AWS_REGION}:${AWS_ACCOUNT}:cluster/${CLUSTER_NAME}"
-
-	local CONTEXT_ARGS=()
-	case $1 in
-		helm ) CONTEXT_ARGS+=(--kube-context $CONTEXT) ;;
-		* ) CONTEXT_ARGS+=(--context $CONTEXT) ;;
-	esac
-
-	$1 ${CONTEXT_ARGS[@]} ${@:2}
-}
-
-#####################################################################
-
-EKS__CLUSTER_LOGIN() {
 	local USAGE="
 		usage:  [...options...]
 
@@ -50,7 +25,6 @@ EKS__CLUSTER_LOGIN() {
 		cluster in EKS. Also creates the kubeconfig entry if it does not
 		already exist.
 	"
-	REQUIRED_ENV=(AWS_ACCOUNT AWS_REGION) CHECK_ENVIRONMENT || return 1
 
 	local CLUSTER_NAME
 

zsh/lib/cloud/aws/eksctl.module.zsh

@@ -1,116 +0,0 @@
-#####################################################################
-
-DEPENDENCIES+=(eksctl)
-REQUIRED_ENV+=()
-
-use cloud/aws/eks
-
-#####################################################################
-
-EKSCTL() {
-	REQUIRED_ENV=(AWS_PROFILE AWS_REGION) CHECK_ENVIRONMENT || return 1
-
-	AWS_PROFILE=$AWS_PROFILE AWS_REGION=$AWS_REGION \
-		eksctl $@
-}
-
-EKSCTL__CREATE_IAMSERVICEACCOUNT() {
-	local USAGE="
-		usage: serviceaccount-name namespace [...options...] -- [...'eksctl create iamserviceaccount' args...]
-
-		options:
-		  --serviceaccount   (required) target k8s:ServiceAccount
-		  --namespace        (required) target k8s:Namespace
-		  --role-name        (required) name of the IAM role to assign
-
-		  --force   don't check for existing serviceaccount and override any existing configuration
-
-		eksctl create iamserviceaccount args:
-		$(eksctl create iamserviceaccount --help 2>&1 | grep -v -- '--name' | grep -v -- '--namespace' | grep -v -- '--role-name' | sed 's/^/  /')
-	"
-	REQUIRED_ENV=(AWS_REGION AWS_ACCOUNT CLUSTER_NAME) CHECK_ENVIRONMENT || return 1
-
-	local SERVICEACCOUNT NAMESPACE ROLE_NAME
-	local FORCE=0
-	local EKSCTL_ARGS=()
-
-	while [[ $# -gt 0 ]]
-	do
-		case $1 in
-			--serviceaccount ) SERVICEACCOUNT=$2; shift 1 ;;
-			--namespace      ) NAMESPACE=$2; shift 1 ;;
-			--role-name      ) ROLE_NAME=$2; shift 1 ;;
-
-			--force ) FORCE=1 ;; 
-
-			-- ) shift 1; break ;;
-
-			* ) ERROR "unknown argument '$1'" ;;
-		esac
-		shift 1
-	done
-
-	while [[ $# -gt 0 ]]; do EKSCTL_ARGS+=($1); shift 1; done
-
-	[ $SERVICEACCOUNT ] || ERROR "--serviceaccount is required"
-	[ $NAMESPACE      ] || ERROR "--namespace is required"
-	[ $ROLE_NAME      ] || ERROR "--role-name is required"
-
-	CHECK_ERRORS --no-fail || return 1
-
-	##########################################
-	
-	[[ $FORCE -eq 0 ]] && {
-		_EKS__CHECK_IAMSERVICEACCOUNT_EXISTS
-		local EXISTS_STATUS=$?
-		case $EXISTS_STATUS in
-			0 )
-				SUCCESS "'$NAMESPACE/$SERVICEACCOUNT' already configured with '$ROLE_NAME'"
-				return 0
-				;;
-			1 ) ;; # role does not exist yet; continue with rollout
-			2 )
-				ERROR "'$NAMESPACE/$SERVICEACCOUNT' has been configured with a different role than '$ROLE_NAME'"
-				REMINDER "must use --force flag to overwrite"
-				return 2
-				;;
-		esac
-	}
-
-	STATUS "creating iamserviceaccount" \
-		&& EKSCTL create iamserviceaccount \
-			--cluster $CLUSTER_NAME \
-			--namespace $NAMESPACE \
-			--name $SERVICEACCOUNT \
-			--role-name $ROLE_NAME \
-			--override-existing-serviceaccounts \
-			--approve \
-			${EKSCTL_ARGS[@]} \
-		&& SUCCESS "successfully configured '$NAMESPACE/$SERVICEACCOUNT' with IAM role '$ROLE_NAME'" \
-		|| { ERROR "unable to configure '$NAMESPACE/$SERVICEACCOUNT' with IAM role '$ROLE_NAME' (check cloudformation dashboard for details)"; return 3; }
-}
-
-_EKS__CHECK_IAMSERVICEACCOUNT_EXISTS() {
-	STATUS "checking for existing role-arn"
-	local CURRENT_ROLE_ARN=$(
-		EKS__KUBECTL --namespace $NAMESPACE get serviceaccount $SERVICEACCOUNT -o yaml \
-			| YQ -r '.metadata.annotations["eks.amazonaws.com/role-arn"]' \
-			| grep -v '^null$' \
-	)
-
-	[ $CURRENT_ROLE_ARN ] || {
-		STATUS "serviceaccount does not exist or has no configured role"
-		return 1
-	}
-
-	[[ $CURRENT_ROLE_ARN =~ "$ROLE_NAME$" ]] || {
-		STATUS "serviceaccount current role does not match desired role:
-			  CURRENT : $CURRENT_ROLE_ARN
-			  DESIRED : arn:aws:iam::${AWS_ACCOUNT}:role/$ROLE_NAME
-			  "
-		return 2
-	}
-
-	STATUS "serviceaccount current role matches desired role"
-	return 0
-}

zsh/lib/config.zsh

@@ -47,26 +47,6 @@ do
 	}
 done
 
-#####################################################################
-
-for GROUP_LOADER in $(env | sed -n 's/^SCWRYPTS_GROUP_LOADER__[a-z_]\+=//p')
-do
-	[ -f "$GROUP_LOADER" ] && source "$GROUP_LOADER"
-done
-
-: \
-	&& [ ! "$SCWRYPTS_AUTODETECT_GROUP_BASEDIR" ] \
-	&& [ $GITHUB_WORKSPACE ] \
-	&& [ ! $SCWRYPTS_GITHUB_NO_AUTOLOAD ] \
-	&& SCWRYPTS_AUTODETECT_GROUP_BASEDIR="$GITHUB_WORKSPACE"
-
-[ "$SCWRYPTS_AUTODETECT_GROUP_BASEDIR" ] && [ -d "$SCWRYPTS_AUTODETECT_GROUP_BASEDIR" ] && {
-	for GROUP_LOADER in $(find "$SCWRYPTS_AUTODETECT_GROUP_BASEDIR" -type f -name \*scwrypts.zsh)
-	do
-		[ -f "$GROUP_LOADER" ] && source "$GROUP_LOADER"
-	done
-}
-
 #####################################################################
 [ $NO_EXPORT_CONFIG ] || __SCWRYPT=1 # arbitrary; indicates currently inside a scwrypt
 true

zsh/lib/helm/template.module.zsh

@@ -4,7 +4,6 @@ DEPENDENCIES+=(helm kubeval)
 REQUIRED_ENV+=()
 
 use helm/validate
-use scwrypts
 
 #####################################################################
 
@@ -18,8 +17,6 @@ HELM__TEMPLATE__GET() {
 		  --colorize   use 'bat' to colorize output
 		  --raw        remove scwrypts-added fluff and only output helm template details
 
-		  -h, --help   show this help dialogue
-
 		Smart helm-template generator which auto-detects the chart
 		and sample values for testing and developing helm charts.
 	"
@@ -38,11 +35,8 @@ HELM__TEMPLATE__GET() {
 				;;
 
 			--raw ) RAW=1 ;;
-
-			-h | --help ) USAGE; return 0 ;;
 			-- ) shift 1; break ;;
 
-
 			* ) HELM_ARGS+=($1) ;;
 		esac
 		shift 1
@@ -66,7 +60,6 @@ HELM__TEMPLATE__GET() {
 		
 	[ ! $TEMPLATE_OUTPUT ] && EXIT_CODE=1
 
-
 	[[ $RAW -eq 1 ]] && {
 		[ $USE_CHART_ROOT ] && [[ $USE_CHART_ROOT -eq 1 ]] || HELM_ARGS+=(--show-only $(echo $TEMPLATE_FILENAME | sed "s|^$CHART_ROOT/||"))
 		[[ $COLORIZE -eq 1 ]] \

zsh/lib/helm/validate.module.zsh

@@ -27,20 +27,13 @@ HELM__VALIDATE() {
 		return 1
 	}
 
-	CHART_NAME=$(YQ -r .name "$CHART_ROOT/Chart.yaml")
+	CHART_NAME=$(yq -r .name "$CHART_ROOT/Chart.yaml")
 
-	[[ $TEMPLATE_FILENAME =~ values.*.yaml$ ]] && {
+	[[ $TEMPLATE_FILENAME =~ values*.yaml$ ]] && {
 		HELM_ARGS+=(--values $TEMPLATE_FILENAME)
 		USE_CHART_ROOT=1
 	}
 
-	[[ $TEMPLATE_FILENAME =~ tests/.*.yaml$ ]] && {
-		HELM_ARGS+=(--values $TEMPLATE_FILENAME)
-		USE_CHART_ROOT=1
-	}
-	[[ $TEMPLATE_FILENAME =~ .tpl$ ]] \
-		&& USE_CHART_ROOT=1
-
 	[[ $(dirname $TEMPLATE_FILENAME) =~ ^$CHART_ROOT$ ]] \
 		&& USE_CHART_ROOT=1
 	
@@ -62,34 +55,11 @@ _HELM__GET_CHART_ROOT() {
 
 _HELM__GET_DEFAULT_VALUES_ARGS() {
 	for F in \
-		"$CHART_ROOT/tests/default.yaml" \
-		"$CHART_ROOT/values.test.yaml" \
 		"$CHART_ROOT/values.yaml" \
+		"$CHART_ROOT/values.test.yaml" \
+		"$CHART_ROOT/tests/default.yaml" \
 		;
 	do
-		[ -f "$F" ] && HELM_ARGS=(--values "$F" $HELM_ARGS)
+		[ -f "$F" ] && HELM_ARGS+=(--values "$F")
-	done
-
-	for LOCAL_REPOSITORY in $(\
-		cat "$CHART_ROOT/Chart.yaml" \
-			| YQ -r '.dependencies[] | .repository' \
-			| grep '^file://' \
-			| sed 's|file://||' \
-		)
-	do
-		[[ $LOCAL_REPOSITORY =~ ^[/~] ]] \
-			&& LOCAL_REPOSITORY_ROOT="$LOCAL_REPOSITORY" \
-			|| LOCAL_REPOSITORY_ROOT="$CHART_ROOT/$LOCAL_REPOSITORY" \
-			;
-
-		for F in \
-			"$LOCAL_REPOSITORY_ROOT/tests/default.yaml" \
-			"$LOCAL_REPOSITORY_ROOT/values.test.yaml" \
-			"$LOCAL_REPOSITORY_ROOT/values.yaml" \
-			;
-		do
-			[ -f "$F" ] && HELM_ARGS=(--values "$F" $HELM_ARGS)
-		done
 	done
 }
-

zsh/lib/misc/tally.module.zsh

@@ -1,106 +0,0 @@
-#####################################################################
-
-DEPENDENCIES+=()
-REQUIRED_ENV+=()
-
-#####################################################################
-
-TALLY_USE_REDIS=false  # maybe someday
-TALLY_PATH="$SCWRYPTS_DATA_PATH/tally"
-
-#####################################################################
-
-TALLY() {
-	local USAGE="
-		usage: [...options...]
-
-		options:
-		  -c, --increment-count   increment the tally by this much (default 1)
-		  -n, --tally-name        name of tally system (default 'default')
-
-		  -g, --get     only output the current value
-		  -s, --set     set the tally to a specific value
-		  -r, --reset   set the tally back to zero
-
-		  --raw   only output the tally value
-
-		  -h, --help   print this dialogue and exit
-
-		Simple tally mark system; keep track of a count.
-	"
-
-	local INCREMENT_COUNT=1
-	local TALLY_NAME=default
-	local RAW=false
-
-	local SET_VALUE=
-
-	while [[ $# -gt 0 ]]
-	do
-		case $1 in
-			-c | --increment-count ) INCREMENT_COUNT=$2; shift 1 ;;
-			-n | --tally-name      ) TALLY_NAME=$2; shift 1 ;;
-
-			-g | --get   ) INCREMENT_COUNT=0 ;;
-
-			-s | --set   ) SET_VALUE=$2; shift 1 ;;
-			-r | --reset ) SET_VALUE=0 ;;
-
-			--raw ) RAW=true ;;
-
-			-h | --help ) USAGE; return 0 ;;
-
-			* ) ERROR "unknown argument '$1'" ;;
-		esac
-		shift 1
-	done
-
-	[ $TALLY_NAME ] && echo "$TALLY_NAME" | grep -qv '/' \
-		|| ERROR "invalid tally name '$TALLY_NAME'"
-
-	local TALLY_FILENAME="$TALLY_PATH/$TALLY_NAME.txt"
-
-	CHECK_ERRORS --no-fail || return 1
-
-	##########################################
-
-	local NEW_VALUE CURRENT_VALUE=0
-	[ $SET_VALUE ] && NEW_VALUE=$SET_VALUE || {
-		[ -f "$TALLY_FILENAME" ] && {
-			CURRENT_VALUE=$(cat "$TALLY_FILENAME" | tail -n1 | grep '^[0-9]\+')
-		}
-		
-		[ $CURRENT_VALUE ] || {
-			ERROR "malformed tally file '$TALLY_FILENAME'; aborting"
-			return 1
-		}
-
-		NEW_VALUE=$(($CURRENT_VALUE + $INCREMENT_COUNT))
-	}
-
-	##########################################
-
-	local TALLY_DIR="$(dirname "$TALLY_FILENAME")"
-
-	[ -d "$TALLY_DIR" ] || mkdir -p "$TALLY_DIR"
-	[ -d "$TALLY_DIR" ] || {
-		ERROR "unable to write to '$TALLY_DIR'; aborting"
-		return 1
-	}
-
-	echo "# autogenerated tally file; avoid direct modification\n$NEW_VALUE" > "$TALLY_FILENAME" || {
-		ERROR "failed to write to '$TALLY_FILENAME': aborting"
-		return 1
-	}
-
-	##########################################
-	
-	case $RAW in
-		true  ) printf "$NEW_VALUE" ;;
-		false )
-			case $TALLY_NAME in
-				default ) INFO "current tally : $NEW_VALUE" ;;
-				*       ) INFO "$TALLY_NAME : $NEW_VALUE" ;;
-			esac
-	esac
-}

zsh/lib/scwrypts/run.module.zsh

@@ -112,28 +112,11 @@ SCWRYPTS__GET_RUNSTRING() {
 SCWRYPTS__GET_RUNSTRING__zsh() {
 	__CHECK_DEPENDENCY zsh || return 1
 
-	local SCWRYPT_FILENAME
-
-	[ $(eval echo '$SCWRYPTS_TYPE__'$SCWRYPT_GROUP) ] \
-		&& SCWRYPT_FILENAME="$GROUP_PATH/$SCWRYPT_NAME" \
-		|| SCWRYPT_FILENAME="$GROUP_PATH/$SCWRYPT_TYPE/$SCWRYPT_NAME" \
-		;
-
-	echo "source '$SCWRYPT_FILENAME'; CHECK_ENVIRONMENT; MAIN"
-
-	return 0
-}
-
-SCWRYPTS__GET_RUNSTRING__zsh_v3_compatibility() {
-	__CHECK_DEPENDENCY zsh || return 1
-
 	[ $(eval echo '$SCWRYPTS_TYPE__'$SCWRYPT_GROUP) ] \
 		&& echo "source $GROUP_PATH/$SCWRYPT_NAME" \
 		|| echo "source $GROUP_PATH/$SCWRYPT_TYPE/$SCWRYPT_NAME" \
 		;
 
-	WARNING "scwrypts zsh/v3 runstrings are now deprecated; please update to scwrypts v4 format"
-
 	return 0
 }
 

zsh/lib/system/vim/vundle.module.zsh

@@ -20,7 +20,7 @@ VUNDLE__PLUGIN_LIST=$(ls $VUNDLE__PLUGIN_DIR | grep -v 'Vundle.vim' | grep -v 'b
 source $VUNDLE__BUILD_DEFINITIONS
 for PLUGIN in $(echo $VUNDLE__PLUGIN_LIST)
 do
-	which VUNDLE__BUILD__$PLUGIN >/dev/null 2>/dev/null || {
+	typeset -f VUNDLE__BUILD__$PLUGIN >/dev/null 2>/dev/null || {
 		echo -e "\nVUNDLE__BUILD__$PLUGIN() {\n	# ... build steps from $HOME/.vim/$PLUGIN \n}" \
 			>> $VUNDLE__BUILD_DEFINITIONS
 		VUNDLE__BUILD__$PLUGIN() {}

zsh/lib/utils/dependencies.zsh

@@ -17,13 +17,6 @@ __CHECK_DEPENDENCY() {
 		$E "application '$1' "$([[ $OPTIONAL -eq 1 ]] && echo preferred || echo required)" but not available on PATH $(__CREDITS $1)"
 		return 1
 	}
-
-	[[ $DEPENDENCY =~ ^yq$ ]] && {
-		yq --version | grep -q mikefarah \
-			|| WARNING 'detected kislyuk/yq but mikefarah/yq is preferred (compatibility may vary)'
-	}
-
-	return 0
 }
 
 __CHECK_COREUTILS() {
@@ -43,7 +36,7 @@ __CHECK_COREUTILS() {
 	done
 
 	[[ $NON_GNU_DEPENDENCY_COUNT -gt 0 ]] && {
-		WARNING 'scripts rely on GNU coreutils; compatibility may vary'
+		WARNING 'scripts rely on GNU coreutils; functionality may be limited'
 		IS_MACOS && REMINDER 'GNU coreutils can be installed and linked through Homebrew'
 	}
 

zsh/lib/utils/io.zsh

@@ -43,11 +43,11 @@ SUCCESS()  { PREFIX="SUCCESS  ✔" COLOR=$__GREEN  PRINT "$@"; }
 WARNING()  { PREFIX="WARNING  " COLOR=$__ORANGE PRINT "$@"; }
 STATUS()   { PREFIX="STATUS    " COLOR=$__BLUE   PRINT "$@"; }
 REMINDER() { PREFIX="REMINDER " COLOR=$__PURPLE PRINT "$@"; }
-INFO()     { PREFIX="INFO     ℹ" COLOR=$__WHITE  PRINT "$@"; }
+INFO()     { PREFIX="INFO     " COLOR=$__WHITE  PRINT "$@"; }
 
 PROMPT() {
 	PREFIX="PROMPT   " COLOR=$__CYAN PRINT "$@"
-	PREFIX="USER     ⌨" COLOR=$__CYAN PRINT '' --no-line-end
+	PREFIX="USER     " COLOR=$__CYAN PRINT '' --no-line-end
 }
 
 FAIL()  { ERROR "${@:2}"; exit $1; }
@@ -142,7 +142,6 @@ INPUT() {
 Yn() {
 	PROMPT "$@ [Yn]"
 	[ $CI ] && { echo y; return 0; }
-	[ $__SCWRYPTS_YES ] && [[ $__SCWRYPTS_YES -eq 1 ]] && { echo y; return 0; }
 
 	local Yn; READ -k Yn; echo >&2
 	[[ $Yn =~ [nN] ]] && return 1 || return 0
@@ -151,7 +150,6 @@ Yn() {
 yN() {
 	PROMPT "$@ [yN]"
 	[ $CI ] && { echo y; return 0; }
-	[ $__SCWRYPTS_YES ] && [[ $__SCWRYPTS_YES -eq 1 ]] && { echo y; return 0; }
 
 	local yN; READ -k yN; echo >&2
 	[[ $yN =~ [yY] ]] && return 0 || return 1
@@ -220,12 +218,3 @@ EDIT() {
 	$EDITOR $@ </dev/tty >/dev/tty
 	SUCCESS "finished editing '$1'!"
 }
-
-YQ() {
-	yq --version | grep -q mikefarah || {
-		yq $@
-		return $?
-	}
-
-	yq eval '... comments=""' | yq $@
-}

zsh/media/youtube/download

@@ -1,8 +1,13 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use media/youtube
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+DOWNLOAD_VIDEO() {
 	local URLS=($@)
 
 	[[ ${#URLS[@]} -eq 0 ]] && URLS=($(echo '' | FZF_HEAD 'enter URL'))
@@ -18,3 +23,6 @@ MAIN() {
 		&& SUCCESS "downloaded to '$YT__OUTPUT_DIR/$FILENAME'" \
 		|| { ERROR "failed to download '$FILENAME'"; return 2; }
 }
+
+#####################################################################
+DOWNLOAD_VIDEO $@

zsh/media/youtube/get-audio-clip

@@ -1,8 +1,13 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use media/youtube
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+GET_AUDIO_CLIP() {
 	local URLS=($@)
 
 	[[ ${#URLS[@]} -eq 0 ]] && URLS=($(echo '' | FZF_HEAD 'enter URL'))
@@ -44,3 +49,6 @@ MAIN() {
 		&& SUCCESS "created clip '$OUTPUT_FILE'" \
 		|| { ERROR "error creating clip '$(basename $OUTPUT_FILE)' (see above)"; return 3; }
 }
+
+#####################################################################
+GET_AUDIO_CLIP $@

zsh/misc/tally

@@ -1,8 +0,0 @@
-#!/bin/zsh
-use misc/tally
-#####################################################################
-
-MAIN() {
-	unset USAGE
-	TALLY $@
-}

zsh/office/latex/build-pdf

@@ -1,8 +1,13 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use office/latex
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+PDFLATEX() {
 	[ ! $1 ] && FAIL 1 'must provide filename'
 	local FILENAME=$(LATEX__GET_MAIN_FILENAME "$1")
 
@@ -21,3 +26,6 @@ MAIN() {
 
 	SUCCESS "created '$(echo $FILENAME | sed 's/\.[^.]*$/.pdf/')'"
 }
+
+#####################################################################
+PDFLATEX $@

zsh/office/latex/cleanup

@@ -1,8 +1,13 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use office/latex
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+CLEAN_LATEX_LOGFILES() {
 	local DIRECTORY=$(SCWRYPTS__GET_REALPATH ".")
 	[ $1 ] && DIRECTORY="$(dirname "$(LATEX__GET_MAIN_FILENAME "$1")")"
 	[ $DIRECTORY ] && [ -d $DIRECTORY ] \
@@ -13,3 +18,6 @@ MAIN() {
 
 	SUCCESS "cleaned up latex artifacts in '$DIRECTORY'"
 }
+
+#####################################################################
+CLEAN_LATEX_LOGFILES $@

zsh/office/latex/create-new

@@ -1,10 +1,15 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use office/latex
+
+CHECK_ENVIRONMENT
 #####################################################################
 
 TEMPLATE_DIR="${0:a:h}/templates"
 
-MAIN() {
+CREATE_NEW_LATEX_DOCUMENT_FROM_TEMPLATE() {
 	local DOCUMENT_DIR="$EXECUTION_DIR"
 	local TEMPLATE=$(GET_TEMPLATES | FZF 'select a template')
 	[ ! $TEMPLATE ] && ABORT
@@ -34,8 +39,6 @@ MAIN() {
 	SUCCESS "finished generating '$(basename $DOCUMENT_FILE)' from '$TEMPLATE'"
 }
 
-#####################################################################
-
 GET_TEMPLATES() {
 	find "$TEMPLATE_DIR" -type d | sed "s^$TEMPLATE_DIR/*^^; /^$/d"
 }
@@ -56,4 +59,4 @@ SLUGIFY_TITLE() {
 }
 
 #####################################################################
-MAIN $@
+CREATE_NEW_LATEX_DOCUMENT_FROM_TEMPLATE $@

zsh/office/latex/get-pdf

@@ -1,7 +1,10 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use office/latex
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+LATEX__GET_PDF $@
-	LATEX__GET_PDF $@
-}

zsh/office/latex/open-pdf

@@ -1,10 +1,18 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use office/latex
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+OPEN_PDF() {
 	local PDF=$(LATEX__GET_PDF $@)
 	[ ! $PDF ] && return 1
 
 	OPEN "$PDF"
 }
+
+#####################################################################
+OPEN_PDF $@

zsh/office/memo/open

@@ -1,8 +1,13 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use office/memo
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+OPEN_MEMO() {
 	local MEMO_NAME=$(MEMO__LIST_ALL | FZF_TAIL 'select/create a memo')
 	[ ! "$MEMO_NAME" ] && ABORT
 
@@ -21,3 +26,6 @@ MAIN() {
 
 	EDIT "$MEMO_FILE"
 }
+
+#####################################################################
+OPEN_MEMO $@

zsh/office/memo/remove

@@ -1,8 +1,13 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use office/memo
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+DELETE_MEMO() {
 	local MEMO_NAME=$(MEMO__LIST_ALL | FZF 'select a memo to delete')
 	local MEMO_FILE="$MEMO__DIR/$MEMO_NAME.$MEMO__FILETYPE"
 	[ "$MEMO_NAME" ] && [ -f "$MEMO_FILE" ] || ABORT
@@ -23,3 +28,6 @@ MAIN() {
 		|| FAIL 1 "failed to remove memo '$MEMO_NAME'" \
 		;
 }
+
+#####################################################################
+DELETE_MEMO $@

zsh/redis/curl

@@ -1,8 +1,13 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use redis
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+CURL_WITH_CACHE() {
 	[ ! $TTL ] && TTL=10
 
 	[[ $(REDIS__ENABLED) -eq 0 ]] && {
@@ -41,6 +46,7 @@ MAIN() {
 	echo $OUTPUT
 }
 
-#####################################################################
-
 GET_URL_KEY() { echo "scwrypts:curl:$1" | sed 's/\s\+/+/g'; }
+
+#####################################################################
+CURL_WITH_CACHE $@

zsh/scwrypts/configure

@@ -1,33 +1,36 @@
 #!/bin/zsh               
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use scwrypts/meta
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+USER_CONFIG_OVERRIDES="$SCWRYPTS_CONFIG_PATH/config.zsh"
-	local USER_CONFIG_OVERRIDES="$SCWRYPTS_CONFIG_PATH/config.zsh"
+
+[ ! -f "$USER_CONFIG_OVERRIDES" ] && {
+	STATUS 'first-time setup detected; creating local configuration override...'
+	cp "$DEFAULT_CONFIG" "$USER_CONFIG_OVERRIDES"
+
+	EDIT $USER_CONFIG_OVERRIDES
+
+	STATUS 'attempting first-time build for virtual environments'
+	SCWRYPTS__RUN --name scwrypts/virtualenv/update-all --group scwrypts --type zsh \
+		&& SUCCESS 'finished updating virtualenvs' \
+		|| WARNING 'unable to create one or more virtualenv (see above)' \
+		;
+
+	REMINDER '
+		in the future, you can use the following scwrypt to update required virtual
+		environments (equivalent to "npm install" or "pip install -r requirements"):
 	
-	[ ! -f "$USER_CONFIG_OVERRIDES" ] && {
+		scwrypts --name scwrypts/virtualenv/update-all --group scwrypts --type zsh
-		STATUS 'first-time setup detected; creating local configuration override...'
+	'
-		cp "$DEFAULT_CONFIG" "$USER_CONFIG_OVERRIDES"
+} || {
-	
+	EDIT "$USER_CONFIG_OVERRIDES"
-		EDIT $USER_CONFIG_OVERRIDES
-	
-		STATUS 'attempting first-time build for virtual environments'
-		SCWRYPTS__RUN --name scwrypts/virtualenv/update-all --group scwrypts --type zsh \
-			&& SUCCESS 'finished updating virtualenvs' \
-			|| WARNING 'unable to create one or more virtualenv (see above)' \
-			;
-	
-		REMINDER '
-			in the future, you can use the following scwrypt to update required virtual
-			environments (equivalent to "npm install" or "pip install -r requirements"):
-		
-			scwrypts --name scwrypts/virtualenv/update-all --group scwrypts --type zsh
-		'
-	} || {
-		EDIT "$USER_CONFIG_OVERRIDES"
-	}
-	
-	
-	SUCCESS 'saved new configuration'
-	REMINDER 'changes which affect the hot-key plugin will require a ZSHRC reload'
 }
+
+
+SUCCESS 'saved new configuration'
+REMINDER 'changes which affect the hot-key plugin will require a ZSHRC reload'

zsh/scwrypts/environment/copy

@@ -1,35 +1,38 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use scwrypts/environment-files
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+PROMPT 'choose an environment to copy'
-	PROMPT 'choose an environment to copy'
+TEMPLATE_ENV_NAME=$(SCWRYPTS__SELECT_ENV)
-	TEMPLATE_ENV_NAME=$(SCWRYPTS__SELECT_ENV)
+[ ! $TEMPLATE_ENV_NAME ] && ABORT
-	[ ! $TEMPLATE_ENV_NAME ] && ABORT
+
-	
+STATUS "selected '$TEMPLATE_ENV_NAME'"
-	STATUS "selected '$TEMPLATE_ENV_NAME'"
+
-	
+PROMPT 'enter new environment name'
-	PROMPT 'enter new environment name'
+ENV_NAME=$(echo '' | FZF_HEAD 'new environment')
-	ENV_NAME=$(echo '' | FZF_HEAD 'new environment')
+[ ! $ENV_NAME ] && ABORT
-	[ ! $ENV_NAME ] && ABORT
+SCWRYPTS__GET_ENV_NAMES | grep -q $ENV_NAME && FAIL 1 "'$ENV_NAME' already exists"
-	SCWRYPTS__GET_ENV_NAMES | grep -q $ENV_NAME && FAIL 1 "'$ENV_NAME' already exists"
+
-	
+for GROUP in ${SCWRYPTS_GROUPS[@]}
-	for GROUP in ${SCWRYPTS_GROUPS[@]}
+do
-	do
+	TEMPLATE_ENV_FILE=$(SCWRYPTS__GET_ENV_FILE $TEMPLATE_ENV_NAME $GROUP 2>/dev/null)
-		TEMPLATE_ENV_FILE=$(SCWRYPTS__GET_ENV_FILE $TEMPLATE_ENV_NAME $GROUP 2>/dev/null)
+	ENV_FILE=$(SCWRYPTS__GET_ENV_FILE $ENV_NAME $GROUP 2>/dev/null)
-		ENV_FILE=$(SCWRYPTS__GET_ENV_FILE $ENV_NAME $GROUP 2>/dev/null)
+
-	
+	STATUS "creating environment '$ENV_NAME'"
-		STATUS "creating environment '$ENV_NAME'"
+	cat "$TEMPLATE_ENV_FILE" \
-		cat "$TEMPLATE_ENV_FILE" \
+		| sed 's/ # from.*//' \
-			| sed 's/ # from.*//' \
+		> "$ENV_FILE" \
-			> "$ENV_FILE" \
+		&& SUCCESS "created '$ENV_FILE'" \
-			&& SUCCESS "created '$ENV_FILE'" \
+		|| FAIL 2 "something went wrong creating '$ENV_FILE'"
-			|| FAIL 2 "something went wrong creating '$ENV_FILE'"
+done
-	done
+
-	
+STATUS "synchronizing environments"
-	STATUS "synchronizing environments"
+SCWRYPTS__RUN --name scwrypts/environment/synchronize --group scwrypts --type zsh -- --no-prompt \
-	SCWRYPTS__RUN --name scwrypts/environment/synchronize --group scwrypts --type zsh -- --no-prompt \
+	&& SUCCESS "finished copy environment '$TEMPLATE_ENV_NAME > $ENV_NAME'" \
-		&& SUCCESS "finished copy environment '$TEMPLATE_ENV_NAME > $ENV_NAME'" \
+	|| FAIL 3 'error during synchronization of new environment (see above)' \
-		|| FAIL 3 'error during synchronization of new environment (see above)' \
+	;
-		;
-}

zsh/scwrypts/environment/delete

@@ -1,33 +1,36 @@
 #!/bin/zsh               
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use scwrypts/environment-files
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+PROMPT 'choose an environment to delete'
-	PROMPT 'choose an environment to delete'
+ENV_NAME=$(SCWRYPTS__SELECT_ENV)
-	ENV_NAME=$(SCWRYPTS__SELECT_ENV)
+[ ! $ENV_NAME ] && ABORT
-	[ ! $ENV_NAME ] && ABORT
+
-	
+ENV_FILES=($(SCWRYPTS__GET_ENV_FILES $ENV_NAME))
-	ENV_FILES=($(SCWRYPTS__GET_ENV_FILES $ENV_NAME))
+
-	
+STATUS "preparing to remove '$ENV_NAME'"
-	STATUS "preparing to remove '$ENV_NAME'"
+
-	
+WARNING "
-	WARNING "
+	the '$ENV_NAME' environment will be removed configured options
-		the '$ENV_NAME' environment will be removed configured options
+	and stored credentials will be lost forever:
-		and stored credentials will be lost forever:
+
-	
+	$(echo $ENV_FILES | sed 's| /|\n - /|g; s/^/ - /')
-		$(echo $ENV_FILES | sed 's| /|\n - /|g; s/^/ - /')
+ "
-	 "
+
-	
+yN 'continue?' || ABORT
-	yN 'continue?' || ABORT
+
-	
+STATUS "removing environment"
-	STATUS "removing environment"
+for ENV_FILE in ${ENV_FILES[@]}
-	for ENV_FILE in ${ENV_FILES[@]}
+do
-	do
+	rm "$ENV_FILE" \
-		rm "$ENV_FILE" \
+		&& SUCCESS "removed '$ENV_FILE'" \
-			&& SUCCESS "removed '$ENV_FILE'" \
+		|| ERROR "unable to remove '$ENV_FILE'; is it protected?" \
-			|| ERROR "unable to remove '$ENV_FILE'; is it protected?" \
+		;
-			;
+done
-	done
+
-	
+CHECK_ERRORS -n || FAIL 2 "some errors ocurred when cleaning up $ENV_NAME"
-	CHECK_ERRORS -n || FAIL 2 "some errors ocurred when cleaning up $ENV_NAME"
-}

zsh/scwrypts/environment/edit

@@ -1,42 +1,45 @@
 #!/bin/zsh               
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use scwrypts/environment-files
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+[ $1 ] && ENV_NAME="$1"
-	[ $1 ] && ENV_NAME="$1"
+
-	
+[ ! $1 ] && {
-	[ ! $1 ] && {
+	[ $SCWRYPTS_ENV ] \
-		[ $SCWRYPTS_ENV ] \
+		&& ENV_NAME=$SCWRYPTS_ENV \
-			&& ENV_NAME=$SCWRYPTS_ENV \
+		|| ENV_NAME=$(SCWRYPTS__SELECT_OR_CREATE_ENV)
-			|| ENV_NAME=$(SCWRYPTS__SELECT_OR_CREATE_ENV)
-	}
-	[ ! $ENV_NAME ] && ABORT
-	
-	ENV_FILES=($(SCWRYPTS__GET_ENV_FILES $ENV_NAME 2>/dev/null))
-	for ENV_FILE in ${ENV_FILES[@]}
-	do
-		[ ! -f "$ENV_FILE" ] && {
-			STATUS "Creating '$ENV_FILE'..." \
-				&& mkdir -p "$(dirname "$ENV_FILE")" \
-				&& touch "$ENV_FILE" \
-				&& ((CREATED+=1)) \
-				&& SUCCESS "created '$ENV_NAME'" \
-				|| { ERROR "failed to create '$ENV_FILE'"; exit 1; }
-		}
-	
-		[ $CREATED ] && [[ $CREATED -gt 0 ]] && {
-			STATUS "detected new environment files; performing sync" \
-				&& SCWRYPTS__RUN --name scwrypts/environment/synchronize --group scwrypts --type zsh -- --no-prompt \
-				|| FAIL 1 "failure during sync for '$ENV_NAME'" \
-		}
-			;
-	done
-	
-	EDIT $ENV_FILES
-	
-	SCWRYPTS__RUN --name scwrypts/environment/synchronize --group scwrypts --type zsh -- --no-prompt \
-		|| FAIL 4 'failed to run environment sync' \
-		;
-	
-	SUCCESS "environment '$ENV_NAME' successfully modified"
 }
+[ ! $ENV_NAME ] && ABORT
+
+ENV_FILES=($(SCWRYPTS__GET_ENV_FILES $ENV_NAME 2>/dev/null))
+for ENV_FILE in ${ENV_FILES[@]}
+do
+	[ ! -f "$ENV_FILE" ] && {
+		STATUS "Creating '$ENV_FILE'..." \
+			&& mkdir -p "$(dirname "$ENV_FILE")" \
+			&& touch "$ENV_FILE" \
+			&& ((CREATED+=1)) \
+			&& SUCCESS "created '$ENV_NAME'" \
+			|| { ERROR "failed to create '$ENV_FILE'"; exit 1; }
+	}
+
+	[ $CREATED ] && [[ $CREATED -gt 0 ]] && {
+		STATUS "detected new environment files; performing sync" \
+			&& SCWRYPTS__RUN --name scwrypts/environment/synchronize --group scwrypts --type zsh -- --no-prompt \
+			|| FAIL 1 "failure during sync for '$ENV_NAME'" \
+	}
+		;
+done
+
+EDIT $ENV_FILES
+
+SCWRYPTS__RUN --name scwrypts/environment/synchronize --group scwrypts --type zsh -- --no-prompt \
+	|| FAIL 4 'failed to run environment sync' \
+	;
+
+SUCCESS "environment '$ENV_NAME' successfully modified"

zsh/scwrypts/environment/synchronize

@@ -1,8 +1,13 @@
 #!/bin/zsh               
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use scwrypts/environment-files
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+SYNCHRONIZE() {
 	while [[ $# -gt 0 ]]
 	do
 		case $1 in
@@ -171,4 +176,4 @@ CLEANUP_ENVIRONMENT_FILE() {
 	rm "$1.temp"
 }
 
-#####################################################################
+#####################################################################

zsh/scwrypts/logs/clear

@@ -1,20 +1,22 @@
 #!/bin/zsh               
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+cd $SCWRYPTS_ROOT
-	cd $SCWRYPTS_ROOT
+
-	
+STATUS "Found $(ls $SCWRYPTS_LOG_PATH | wc -l) log files"
-	STATUS "Found $(ls $SCWRYPTS_LOG_PATH | wc -l) log files"
+WARNING "
-	WARNING "
+	this will permanently clear all local cloud script logs found in
-		this will permanently clear all local cloud script logs found in
+	'$SCWRYPTS_LOG_PATH'
-		'$SCWRYPTS_LOG_PATH'
+"
-	"
+
-	
+yN 'continue?' || ABORT
-	yN 'continue?' || ABORT
+
-	
+STATUS 'removing logfiles'
-	STATUS 'removing logfiles'
+rm -rf $SCWRYPTS_LOG_PATH/* \
-	rm -rf $SCWRYPTS_LOG_PATH/* \
+	&& SUCCESS 'done' \
-		&& SUCCESS 'done' \
+	|| { ERROR 'failed :c'; exit 2; }\
-		|| { ERROR 'failed :c'; exit 2; }\
+	;
-		;
-}

zsh/scwrypts/logs/view

@@ -1,13 +1,15 @@
 #!/bin/zsh               
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+cd $SCWRYPTS_ROOT
-	cd $SCWRYPTS_ROOT
+PROMPT 'select a script log'
-	PROMPT 'select a script log'
+LOG_FILE=$(ls -t $SCWRYPTS_LOG_PATH | FZF 'logfile')
-	LOG_FILE=$(ls -t $SCWRYPTS_LOG_PATH | FZF 'logfile')
+[ ! $LOG_FILE ] && { ERROR 'user abort'; exit 1; }
-	[ ! $LOG_FILE ] && { ERROR 'user abort'; exit 1; }
+
-	
+STATUS 'opening logfile'
-	STATUS 'opening logfile'
+LESS "$SCWRYPTS_LOG_PATH/$LOG_FILE"
-	LESS "$SCWRYPTS_LOG_PATH/$LOG_FILE"
+SUCCESS 'done'
-	SUCCESS 'done'
-}

zsh/scwrypts/virtualenv/refresh

@@ -1,27 +1,30 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use scwrypts/virtualenv
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+while [[ $# -gt 0 ]]
-	while [[ $# -gt 0 ]]
+do
-	do
+	case $1 in
-		case $1 in
+		-g | --group ) ENV_GROUP="$2"; shift 1 ;; 
-			-g | --group ) ENV_GROUP="$2"; shift 1 ;; 
+	esac
-		esac
+	shift 1
-		shift 1
+done
-	done
+
-	
+[ ! $ENV_GROUP ] && ENV_GROUP=scwrypts
-	[ ! $ENV_GROUP ] && ENV_GROUP=scwrypts
+
-	
+ENV_TYPE=$(echo $AVAILABLE_VIRTUALENVS | sed 's/ \+/\n/' | FZF 'select an environment to refresh')
-	ENV_TYPE=$(echo $AVAILABLE_VIRTUALENVS | sed 's/ \+/\n/' | FZF 'select an environment to refresh')
+[ ! $ENV_TYPE ] && ABORT
-	[ ! $ENV_TYPE ] && ABORT
+
-	
+REMINDER "
-	REMINDER "
+	this will permanently remove all artifacts for the scwrypts $ENV_TYPE environment
-		this will permanently remove all artifacts for the scwrypts $ENV_TYPE environment
+	(safe unless you have put something important in $(GET_VIRTUALENV_PATH $ENV_GROUP $ENV_TYPE))
-		(safe unless you have put something important in $(GET_VIRTUALENV_PATH $ENV_GROUP $ENV_TYPE))
+	"
-		"
+
-	
+Yn "drop and recreate $ENV_TYPE virtual environment?" || ABORT
-	Yn "drop and recreate $ENV_TYPE virtual environment?" || ABORT
+
-	
+REFRESH_VIRTUALENV $ENV_GROUP $ENV_TYPE
-	REFRESH_VIRTUALENV $ENV_GROUP $ENV_TYPE
-}

zsh/scwrypts/virtualenv/update-all

@@ -1,21 +1,25 @@
 #!/bin/zsh
+echo hey
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use scwrypts/virtualenv
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+STATUS 'beginning update for all environments'
-	STATUS 'beginning update for all environments'
+
-	
+FAILED_COUNT=0
-	FAILED_COUNT=0
+
-	
+for ENV_GROUP in ${SCWRYPTS_GROUPS[@]}
-	for ENV_GROUP in ${SCWRYPTS_GROUPS[@]}
+do
+	for ENV_TYPE in ${AVAILABLE_VIRTUALENVS[@]}
 	do
-		for ENV_TYPE in ${AVAILABLE_VIRTUALENVS[@]}
+		UPDATE_VIRTUALENV $ENV_GROUP $ENV_TYPE || ((FAILED_COUNT+=1))
-		do
-			UPDATE_VIRTUALENV $ENV_GROUP $ENV_TYPE || ((FAILED_COUNT+=1))
-		done
 	done
-	
+done
-	[[ $FAILED_COUNT -eq 0 ]] \
+
-		&& SUCCESS 'all environments up-to-date' \
+[[ $FAILED_COUNT -eq 0 ]] \
-		|| FAIL $FAILED_COUNT "failed to update $FAILED_COUNT more environment(s)"
+	&& SUCCESS 'all environments up-to-date' \
-}
+	|| FAIL $FAILED_COUNT "failed to update $FAILED_COUNT more environment(s)"

zsh/system/config/settings

@@ -1,7 +1,9 @@
 #!/bin/zsh
-use system/config
+DEPENDENCIES+=()
-#####################################################################
+REQUIRED_ENV+=()
 
-MAIN() {
+use system/config
-	EDIT "$CONFIG__USER_SETTINGS"
+
-}
+CHECK_ENVIRONMENT
+#####################################################################
+EDIT "$CONFIG__USER_SETTINGS"

zsh/system/config/symlinks

@@ -1,16 +1,19 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use system/config
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+SETUP_SYMLINKS() {
 	while read SYMLINK
 	do
 		SETUP_SYMLINK $(echo $SYMLINK | awk '{print $1;}') $(echo $SYMLINK | awk '{print $2}')
 	done < <(echo $SYMLINKS | sed -n '/^[^#]/p')
 }
 
-#####################################################################
-
 SETUP_SYMLINK() {
 	[ ! $2 ] && FAIL 1 'must provide SOURCE_CONFIG and TARGET_CONFIG'
 
@@ -39,3 +42,6 @@ SETUP_SYMLINK() {
 		|| FAIL 3 "failed to create link '$TARGET_CONFIG'" \
 		;
 }
+
+#####################################################################
+SETUP_SYMLINKS $@

zsh/system/config/terminfo

@@ -1,10 +1,13 @@
 #!/bin/zsh
 DEPENDENCIES+=(tic)
+REQUIRED_ENV+=()
 
 use system/config
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+SETUP_TERMINFO() {
 	[ ! $TERMINFO_PATH ] && return 0
 	[ ! -d $TERMINFO_PATH ] && FAIL 1 "TERMINFO_PATH='$TERMINFO_PATH' does not exist"
 
@@ -19,3 +22,6 @@ MAIN() {
 
 	CHECK_ERRORS
 }
+
+#####################################################################
+SETUP_TERMINFO $@

zsh/system/config/update

@@ -1,10 +1,13 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use scwrypts/meta
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+STATUS 'updating all config files and links'
-	STATUS 'updating all config files and links'
+SCWRYPTS__RUN --name system/config/symlinks --group scwrypts --type zsh || exit 1
-	SCWRYPTS__RUN --name system/config/symlinks --group scwrypts --type zsh || exit 1
+SCWRYPTS__RUN --name system/config/terminfo --group scwrypts --type zsh || exit 2
-	SCWRYPTS__RUN --name system/config/terminfo --group scwrypts --type zsh || exit 2
+SUCCESS 'finished updating config files and links'
-	SUCCESS 'finished updating config files and links'
-}

zsh/system/i3/create-local-font-override

@@ -0,0 +1,102 @@
+#!/bin/zsh
+DEPENDENCIES+=(
+	diff
+)
+REQUIRED_ENV+=(
+	I3__MODEL_CONFIG
+)
+
+CHECK_ENVIRONMENT
+#####################################################################
+
+REGEX_FONT='^\(font [^0-9]*\)\(.*\)'
+REGEX_DMENU="^\\(.*dmenu_run .*-fn '[^0-9]*\\)\\([0-9]*\\)'"
+REGEX_BORDER='^\(for_window.*border pixel \)\(.*\)'
+
+INSTALL() {
+	local USAGE="
+		usage: [...options...]
+
+		options
+		  -f, --force             force replacement of existing i3config
+		  -n, --no-link           if output config and template are the same, don't create link
+
+		  -h, --help              print this message and exit
+
+		environment
+		  I3__MODEL_CONFIG        fully-qualified path to sourced i3config
+		  I3__GLOBAL_FONT_SIZE    global font size
+		  I3__DMENU_FONT_SIZE     (optional) font size for 'dmenu' command
+		  I3__BORDER_PIXEL_SIZE   (optional) pixel-width of window borders
+
+		I3 provides no way to include dynamic variables in your config.
+		The main difference I want between my i3 configurations is font-size
+		to match the current monitor. Since i3-msg provides no way to change
+		font size, I run this command to update those variables on a local
+		copy of my sourced config
+	"
+	local FORCE=0
+	local AUTOLINK=1
+	while [[ $# -gt 0 ]]
+	do
+		case $1 in 
+			-f | --force ) FORCE=1 ;;
+			-n | --no-link ) AUTOLINK=0 ;;
+			-h | --help ) USAGE; exit 0 ;;
+		esac
+		shift 1
+	done
+
+	STATUS 'reading local i3config'
+	[[ ^$I3__MODEL_CONFIG$ =~ ^$HOME/.config/i3/config$ ]] && {
+		STATUS "model configuration is default configuration"
+		I3__MODEL_CONFIG="$I3__MODEL_CONFIG.template"
+		[ ! -f "$I3__MODEL_CONFIG" ] && {
+			STATUS "creating template"
+			cp "$HOME/.config/i3/config" "$I3__MODEL_CONFIG.template"
+		}
+		STATUS "referring to '$I3__MODEL_CONFIG'"
+	}
+	local CONFIG=$(cat "$I3__MODEL_CONFIG")
+	[ ! $CONFIG ] && FAIL 1 "failed to read config at '$I3__MODEL_CONFIG'"
+
+	local CONFIG_FILE="$HOME/.config/i3/config"
+	[ ! -d $(dirname "$CONFIG_FILE") ] && mkdir -p "$(dirname "$CONFIG_FILE")"
+
+	[ -f "$CONFIG_FILE" ] && mv "$CONFIG_FILE" "$CONFIG_FILE.bak"
+
+	[ $I3__GLOBAL_FONT_SIZE ] && {
+		STATUS "setting global font size to '$I3__GLOBAL_FONT_SIZE'"
+		CONFIG=$(echo $CONFIG | sed "s/$REGEX_FONT/\\1$I3__GLOBAL_FONT_SIZE/")
+	}
+
+	[ $I3__DMENU_FONT_SIZE ] && {
+		STATUS "setting dmenu font size to '$I3__DMENU_FONT_SIZE'"
+		CONFIG=$(echo $CONFIG | sed "s/$REGEX_DMENU/\\1$I3__DMENU_FONT_SIZE'/")
+	}
+
+	[ $I3__BORDER_PIXEL_SIZE ] && {
+		STATUS "setting border pixel size to '$I3__BORDER_PIXEL_SIZE'"
+		CONFIG=$(echo $CONFIG | sed "s/$REGEX_BORDER/\\1$I3__BORDER_PIXEL_SIZE/")
+	}
+
+	echo $CONFIG > "$CONFIG_FILE"
+	[ -f "$CONFIG_FILE.bak" ] \
+		&& diff "$CONFIG_FILE" "$CONFIG_FILE.bak" -q >/dev/null \
+		&& mv "$CONFIG_FILE.bak" "$CONFIG_FILE" \
+		&& INFO "no changes were made" \
+		;
+
+	[[ $AUTOLINK -eq 1 ]] \
+		&& diff "$CONFIG_FILE" "$I3__MODEL_CONFIG" -q >/dev/null \
+		&& rm "$CONFIG_FILE" \
+		&& ln -s "$I3__MODEL_CONFIG" "$CONFIG_FILE" \
+		&& INFO "output is the same as model, i3config has been linked to model" \
+		;
+
+	[[ $FORCE -eq 1 ]] && rm "$CONFIG.bak" >/dev/null 2>&1
+	return 0
+}
+
+#####################################################################
+INSTALL $@

zsh/system/i3/launch-or-show

@@ -0,0 +1,136 @@
+#!/bin/zsh
+DEPENDENCIES+=(
+	i3-msg
+	xdotool
+	xrandr
+)
+REQUIRED_ENV+=()
+
+use system/desktop/notify
+
+CHECK_ENVIRONMENT
+#####################################################################
+
+LAUNCH_OR_SHOW() {
+	INFO $@
+	local USAGE="
+		usage: <path-executable> [client-class] [...options...]
+
+		options
+		  -c, --client <string>   if different from the executable name, xprop CLIENT_CLASS
+
+		  -s, --scale <value>     (default: 0.8 or 0.5 if screen width >3000px)
+		  -x, --x-offset <value>  (default: 0.0)
+		  -y, --y-offset <value>  (default: 0.0)
+
+		  -a, --always-launch     invoke executable even if client-class exists
+		  -n, --no-resize         don't resize the window (ignores -sxy flags)
+		  -l, --no-center         leave the window wherever it was last positioned
+
+		  --has-statusbar-icon    (default: false) use if program has a statusbar icon
+
+		  -h, --help              print this message and exit
+
+		Makes it easy to bind appications to key shortcuts without having to
+		spin up redundant instances or cycle through the scratchpad queue.
+
+		Performs a variety of tasks based on states:
+		  1) starts and application
+		  2) adds all instances of the specified application to the scratchpad
+		  3) (toggle) hides all visible instances
+		  4) (toggle) shows all scratchpad-hidden instances
+	"
+	local APPLICATION CLIENT_CLASS
+
+	local XFFSET=0.0
+	local YFFSET=0.0
+	local SCALE=0.8
+	[[ $(xrandr | grep primary | awk '{print $4;}' | sed 's/x.*//') -gt 3000 ]] \
+		&& SCALE=0.5
+
+	local ALWAYS_LAUNCH=0
+	local RESIZE=1
+	local MOVE=1
+	local MIN_ACTIVE=1
+
+	while [[ $# -gt 0 ]]
+	do
+		case $1 in 
+			-c | --client   ) CLIENT_CLASS="$2"; shift 1 ;;
+			-x | --x-offset ) XFFSET=$2; shift 1 ;;
+			-y | --y-offset ) YFFSET=$2; shift 1 ;;
+			-s | --scale    ) SCALE=$2;  shift 1 ;;
+
+			-a | --always-launch ) ALWAYS_LAUNCH=1 ;;
+			-n | --no-resize     ) RESIZE=0 ;;
+			-l | --no-center     ) MOVE=0 ;;
+
+			--has-statusbar-icon ) MIN_ACTIVE=2 ;;
+
+			-h | --help ) USAGE; exit 0 ;;
+
+			* )
+				[ ! $APPLICATION  ] && APPLICATION="$1" \
+					|| ERROR "extra positional argument '$1'"
+		esac
+		shift 1
+	done
+
+	[ ! $APPLICATION  ] && ERROR 'path-executable required'
+	[ ! $CLIENT_CLASS ] && CLIENT_CLASS=$APPLICATION
+
+	[ $APPLICATION ] && {
+		__CHECK_DEPENDENCY $APPLICATION || {
+			ERROR "$APPLICATION is not installed"
+			NOTIFY "ERROR: $APPLICATION not found"
+		}
+	}
+
+	CHECK_ERRORS
+
+	xrandr | grep primary | awk '{print $4;}' | grep -q '^[0-9]\+$' || {
+		xrandr --output $(xrandr | grep ' connected' | awk '{print $1;}' | head -n1) --primary
+	}
+
+	local CURRENTLY_ACTIVE=$(xdotool search --onlyvisible --classname $CLIENT_CLASS 2>/dev/null | wc -l)
+
+	local LAUNCH_APP=$ALWAYS_LAUNCH
+	STATUS "looking for window process ids"
+	xdotool search --class $CLIENT_CLASS || LAUNCH_APP=1
+
+	[[ $LAUNCH_APP -eq 1 ]] && {
+		STATUS 'launching application'
+		i3-msg "exec --no-startup-id $APPLICATION;"
+		sleep .5
+	}
+
+	STATUS 'getting target window size'
+	WINDOW_SIZE=$(\
+		xrandr \
+			| grep 'connected primary' \
+			| sed 's/.*connected primary \([^x]*\)x\([^+]*\).*/\1 \2/' \
+			| awk -v f=$SCALE -v x=$XFFSET -v y=$YFFSET \
+				'{print int($1*f+x)," ",int($2*f+y);}'\
+	)
+	INFO "window size: $WINDOW_SIZE"
+
+	STATUS 'moving window to scratchpad'
+	i3-msg "[class=$CLIENT_CLASS] move scratchpad"
+
+	[[ $RESIZE -eq 1 ]] \
+		&& STATUS 'resizing window' \
+		&& i3-msg "[class=$CLIENT_CLASS] resize set $WINDOW_SIZE"
+
+	[[ $CURRENTLY_ACTIVE -lt $MIN_ACTIVE ]] && {
+		STATUS 'pulling window from scratchpad to foreground'
+		i3-msg "[class=$CLIENT_CLASS] scratchpad show"
+	}
+
+	STATUS 'moving window to center of current screen'
+	[[ $MOVE -eq 1 ]] && i3-msg "[class=$CLIENT_CLASS] move position center"
+
+	return 0
+}
+
+#####################################################################
+LAUNCH_OR_SHOW $@

zsh/system/packages/build

@@ -1,7 +1,9 @@
 #!/bin/zsh
-use scwrypts/meta
+DEPENDENCIES+=()
-#####################################################################
+REQUIRED_ENV+=()
 
-MAIN() {
+use scwrypts/meta
-	SCWRYPTS__RUN --name system/packages/install --group scwrypts --type zsh -- --only-build $@
+
-}
+CHECK_ENVIRONMENT
+#####################################################################
+SCWRYPTS__RUN --name system/packages/install --group scwrypts --type zsh -- --only-build $@

zsh/system/packages/download

@@ -1,7 +1,9 @@
 #!/bin/zsh
-use scwrypts/meta
+DEPENDENCIES+=()
-#####################################################################
+REQUIRED_ENV+=()
 
-MAIN() {
+use scwrypts/meta
-	SCWRYPTS__RUN --name system/packages/install --group scwrypts --type zsh -- --only-pull $@
+
-}
+CHECK_ENVIRONMENT
+#####################################################################
+SCWRYPTS__RUN --name system/packages/install --group scwrypts --type zsh -- --only-pull $@

zsh/system/packages/install

@@ -1,8 +1,13 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use system/packages/git
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+INSTALL() {
 	local USAGE="
 		usage: [...options...]
 
@@ -81,3 +86,6 @@ MAIN() {
 	[[ $SKIP_BUILD -eq 1 ]] && return 0
 	BUILD
 }
+
+#####################################################################
+INSTALL $@

zsh/system/packages/update

@@ -1,7 +1,9 @@
 #!/bin/zsh
-use scwrypts/meta
+DEPENDENCIES+=()
-#####################################################################
+REQUIRED_ENV+=()
 
-MAIN() {
+use scwrypts/meta
-	SCWRYPTS__RUN --name system/packages/install --group scwrypts --type zsh -- --update $@
+
-}
+CHECK_ENVIRONMENT
+#####################################################################
+SCWRYPTS__RUN --name system/packages/install --group scwrypts --type zsh -- --update $@

zsh/system/vim/vundle/edit-build-actions

@@ -1,7 +1,9 @@
 #!/bin/zsh
-use system/vim/vundle
+DEPENDENCIES+=()
-#####################################################################
+REQUIRED_ENV+=()
 
-MAIN() {
+use system/vim/vundle
-	EDIT "$VUNDLE__BUILD_DEFINITIONS"
+
-}
+CHECK_ENVIRONMENT
+#####################################################################
+EDIT "$VUNDLE__BUILD_DEFINITIONS"

zsh/system/vim/vundle/install

@@ -1,13 +1,16 @@
 #!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
 use system/vim/vundle
+
+CHECK_ENVIRONMENT
 #####################################################################
 
-MAIN() {
+PLUGIN_INSTALL() {
-	[ -d "$HOME/.vim/bundle/Vundle.vim" ] || {
+	VUNDLE__PLUGIN_INSTALL || return 1
-		mkdir -p "$HOME/.vim/bundle/"
-		git clone https://github.com/VundleVim/Vundle.vim.git "$HOME/.vim/bundle/Vundle.vim"
-	}
-
-	VUNDLE__PLUGIN_INSTALL  || return 1
 	VUNDLE__REBUILD_PLUGINS || return 2
 }
+
+#####################################################################
+PLUGIN_INSTALL $@

zsh/system/vim/vundle/rebuild

@@ -1,7 +1,9 @@
 #!/bin/zsh
-use system/vim/vundle
+DEPENDENCIES+=()
-#####################################################################
+REQUIRED_ENV+=()
 
-MAIN() {
+use system/vim/vundle
-	VUNDLE__REBUILD_PLUGINS $@
+
-}
+CHECK_ENVIRONMENT
+#####################################################################
+VUNDLE__REBUILD_PLUGINS $@