Modified behavior of --help/-h and added commands -H/--help--all

bash_completion.sh

@@ -133,7 +133,7 @@ _buildtest ()
 
  COMPREPLY=() # Array variable storing the possible completions.
 
- declare -a buildtest_opts=("--color" "--config" "--debug" "--editor" "--help" "--helpcolor" "--logpath" "--loglevel" "--print-log" "--no-color" "--report" "--version" "--view-log" "-c" "-d" "-h" "-l" "-p" "-r" "-V")
+ declare -a buildtest_opts=("--color" "--config" "--debug" "--editor" "--help" "--helpcolor" "--help-all" "--logpath" "--loglevel" "--print-log" "--no-color" "--report" "--version" "--view-log" "-c" "-d" "-h" "-l" "-p" "-r" "-V" "-H")
 
  commands_with_input=( "--color" "--config" "-c" "--report" "-r" "--loglevel" "-l" "--editor" ) # Array variable storing commands which require an input argument from the user.
 
@@ -200,7 +200,7 @@ _buildtest ()
  COMPREPLY=( $( compgen -W "$opts" -- $cur ) )
  ;;
  path)
- local opts="-b -be -e -h -o -s -t --buildscript --buildenv --errfile --help --outfile --stagedir --testpath"
+ local opts="-b -be -e -h -o -s -t --buildscript --buildenv --errfile --help  --outfile --stagedir --testpath"
  COMPREPLY=( $( compgen -W "$(_builder_names)" -- $cur ) )
  if [[ $cur == -* ]] ; then
  COMPREPLY=( $( compgen -W "$opts" -- $cur ) )
@@ -458,7 +458,7 @@ _buildtest ()
  *)
  local cmds="build buildspec cd cdash clean config debugreport docs help info inspect history path report schema schemadocs stats stylecheck tutorial-examples unittests"
  local alias_cmds="bd bc cg debug it h hy rt style test"
- local opts="--color --config --debug --editor --help --helpcolor --logpath --loglevel --print-log --no-color --report --version --view-log -c -d -h -l -p -r -V"
+ local opts="--color --config --debug --editor --help --helpcolor --help-all --logpath --loglevel --print-log --no-color --report --version --view-log -c -d -h -l -p -r -H -V"
 
  case "${cur}" in
  # print main options to buildtest

buildtest/cli/__init__.py

@@ -4,6 +4,7 @@
 """
 import argparse
 import datetime
+import sys
 
 from pygments.styles import STYLE_MAP
 from rich.color import Color, ColorParseError
@@ -12,6 +13,11 @@
 from buildtest.defaults import console
 from buildtest.schemas.defaults import schema_table
 
+# Variables needed to show all sub commands and their help mesaage
+help1 = "-H" in sys.argv
+help2 = "--help-all" in sys.argv
+show_all_help = help1 or help2
+
 
 def build_filters_format(val):
  """This method is used as validate argument type for ``buildtest build --filter``.
@@ -260,6 +266,9 @@
  help="Print available color options in a table format.",
  )
  parser.add_argument("-r", "--report", help="Specify path to test report file")
+ parser.add_argument(
+ "-H", "--help-all", help="Show help for all commands", action="help"
+ )
 
  subparsers = parser.add_subparsers(title="COMMANDS", dest="subcommands", metavar="")
 
@@ -353,8 +362,16 @@
  "-y", "--yes", action="store_true", help="Confirm yes for all prompts"
  )
 
- subparsers.add_parser("docs", help="Open buildtest docs in browser")
- subparsers.add_parser("schemadocs", help="Open buildtest schema docs in browser")
+ # Subcommands that do not need to be shown in --help
+ if show_all_help:
+ subparsers.add_parser(
+ "schemadocs", help="Open buildtest schema docs in browser"
+ )
+ subparsers.add_parser("docs", help="Open buildtest docs in browser")
+ else:
+ subparsers.add_parser("schemadocs")
+ subparsers.add_parser("docs")
+
  subparsers.add_parser(
  "debugreport",
  help="Display system information and additional information for debugging purposes.",
@@ -405,9 +422,13 @@
  subparsers (argparse._SubParsersAction): Subparser object to add subparser
  """
 
- stylecheck_parser = subparsers.add_parser(
- "stylecheck", aliases=["style"], help="Run buildtest style checks"
- )
+ # Subcommands that do not need to be shown in --help
+ if show_all_help:
+ stylecheck_parser = subparsers.add_parser(
+ "stylecheck", aliases=["style"], help="Run buildtest style checks"
+ )
+ else:
+ stylecheck_parser = subparsers.add_parser("stylecheck", aliases=["style"])
 
  stylecheck_parser.add_argument(
  "--no-black", action="store_true", help="Don't run black style check"
@@ -430,9 +451,14 @@
  subparsers (argparse._SubParsersAction): Subparser object to add subparser
  """
 
- unittests_parser = subparsers.add_parser(
- "unittests", help="Run buildtest unit tests", aliases=["test"]
- )
+ # Subcommands that do not need to be shown in --help
+ if show_all_help:
+ unittests_parser = subparsers.add_parser(
+ "unittests", help="Run buildtest unit tests", aliases=["test"]
+ )
+ else:
+ unittests_parser = subparsers.add_parser("unittests", aliases=["test"])
+
  unittests_parser.add_argument(
  "-c",
  "--coverage",
@@ -458,10 +484,14 @@
  subparsers (argparse._SubParsersAction): Subparser object to add subparser
  """
 
- subparsers.add_parser(
- "tutorial-examples",
- help="Generate documentation examples for Buildtest Tutorial",
- )
+ # Subcommands that do not need to be shown in --help
+ if show_all_help:
+ subparsers.add_parser(
+ "tutorial-examples",
+ help="Generate documentation examples for Buildtest Tutorial",
+ )
+ else:
+ subparsers.add_parser("tutorial-examples")
 
 
 def path_menu(subparsers):