refactor: standardize help generation

plugins/shell/commands

@@ -1,29 +1,12 @@
 #!/usr/bin/env bash
 [[ " help shell:help " == *" $1 "* ]] || exit "$DOKKU_NOT_IMPLEMENTED_EXIT"
+source "$PLUGIN_AVAILABLE_PATH/shell/help-functions"
 set -eo pipefail
 [[ $DOKKU_TRACE ]] && set -x
 
 case "$1" in
   help | shell:help)
-    help_content_func() {
-      declare desc="return shell plugin help content"
-      cat <<help_content
-    shell, Spawn dokku shell
-help_content
-    }
-
-    if [[ $1 == "shell:help" ]]; then
-      echo -e 'Usage: dokku shell'
-      echo ''
-      echo 'Dokku shell is an interactive dokku prompt.'
-      echo ''
-      echo 'Note: See dokku enter:help for shell access to containers.'
-      echo ''
-      echo 'Additional commands:'
-      help_content_func | sort | column -c2 -t -s,
-    else
-      help_content_func
-    fi
+    cmd-shell-help "$@"
     ;;
 
   *)

plugins/shell/help-functions

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+set -eo pipefail
+[[ $DOKKU_TRACE ]] && set -x
+
+cmd-shell-help() {
+  declare desc="help command"
+  declare CMD="$1"
+  local plugin_name="shell"
+  local plugin_description="Interactive dokku prompt"
+
+  if [[ "$CMD" == "$plugin_name:help" ]]; then
+    echo -e "Usage: dokku $plugin_name[:COMMAND]"
+    echo ''
+    echo "$plugin_description"
+    echo ''
+    echo 'Additional commands:'
+    fn-help-content | sort | column -c2 -t -s,
+  elif [[ $(ps -o command= $PPID) == *"--all"* ]]; then
+    fn-help-content
+  else
+    cat <<help_desc
+    $plugin_name, $plugin_description
+help_desc
+  fi
+}
+
+fn-help-content() {
+  declare desc="return help content"
+  cat <<help_content
+    shell, Spawn dokku shell
+help_content
+}