Add help option to test command line args

When test binaries are run with unknown options or with the standard
-h option, a help menu will print all available options.

This is much more convenient than having to dig through unity.c to
find every option.

Author: Skinner927

src/unity.c

@@ -2329,6 +2329,17 @@ int UnityParseOptions(int argc, char** argv)
                     UnityPrint("ERROR: Unknown Option ");
                     UNITY_OUTPUT_CHAR(argv[i][1]);
                     UNITY_PRINT_EOL();
+                    /* fall-through to display help */
+                case 'h':
+                    UnityPrint("Options: "); UNITY_PRINT_EOL();
+                    UnityPrint("-l        List all tests"); UNITY_PRINT_EOL();
+                    UnityPrint("-f TEST   Only run tests with TEST in the name"); UNITY_PRINT_EOL();
+                    UnityPrint("-n TEST   Only run tests with TEST in the name"); UNITY_PRINT_EOL();
+                    UnityPrint("-h        Show this help menu"); UNITY_PRINT_EOL();
+                    UnityPrint("-q        Quiet/Decrease verbosity"); UNITY_PRINT_EOL();
+                    UnityPrint("-v        Increase verbosity"); UNITY_PRINT_EOL();
+                    UnityPrint("-x TEST   Exclude tests with TEST in the name"); UNITY_PRINT_EOL();
+                    UNITY_OUTPUT_FLUSH();
                     return 1;
             }
         }

test/Makefile

@@ -5,7 +5,7 @@ endif
 ifeq ($(findstring clang, $(CC)), clang)
 E = -Weverything
 CFLAGS += $E -Wno-unknown-warning-option -Wno-missing-prototypes
-CFLAGS += -Wno-unused-macros -Wno-padded -Wno-missing-noreturn
+CFLAGS += -Wno-unused-macros -Wno-padded -Wno-missing-noreturn -Wno-covered-switch-default
 endif
 CFLAGS += -std=c99 -pedantic -Wall -Wextra -Werror
 #CFLAGS += -Wconversion #disabled because if falsely complains about the isinf and isnan macros

test/tests/test_generate_test_runner.rb

@@ -1158,9 +1158,43 @@
       :to_pass => [ ],
       :to_fail => [ ],
       :to_ignore => [ ],
-      :text => [ "ERROR: Unknown Option z" ],
+      :text => [
+        "ERROR: Unknown Option z",
+        "Options:",
+        "-l        List all tests",
+        "-f TEST   Only run tests with TEST in the name",
+        "-n TEST   Only run tests with TEST in the name",
+        "-h        Show this help menu",
+        "-q        Quiet/Decrease verbosity",
+        "-v        Increase verbosity",
+        "-x TEST   Exclude tests with TEST in the name",
+      ],
     }
   },
+
+  { :name => 'ArgsHelp',
+      :testfile => 'testdata/testRunnerGenerator.c',
+      :testdefines => ['TEST', 'UNITY_USE_COMMAND_LINE_ARGS'],
+      :options => {
+        :cmdline_args => true,
+      },
+      :cmdline_args => "-h",
+      :expected => {
+        :to_pass => [ ],
+        :to_fail => [ ],
+        :to_ignore => [ ],
+        :text => [
+          "Options:",
+          "-l        List all tests",
+          "-f TEST   Only run tests with TEST in the name",
+          "-n TEST   Only run tests with TEST in the name",
+          "-h        Show this help menu",
+          "-q        Quiet/Decrease verbosity",
+          "-v        Increase verbosity",
+          "-x TEST   Exclude tests with TEST in the name",
+        ],
+      }
+    },
 ]
 
 def runner_test(test, runner, expected, test_defines, cmdline_args, features)