Add -h option to all commands and cover it with tests

Author: pesse

README.md

@@ -55,10 +55,20 @@ ALTER SESSION SET NLS_TERRITORY='AMERICA';
 ```
 
 ## Usage
-Currently, utPLSQL-cli supports the following commands:
+Currently, utPLSQL-cli supports the following sub-commands:
 - run
 - info
 - reporters
+- help
+
+To get more info about a command, use 
+```
+utplsql <sub-command> -h
+```
+Example:
+```
+utplsql run -h
+```
 
 #### \<ConnectionURL>
 

src/main/java/org/utplsql/cli/ReportersCommand.java

@@ -7,6 +7,7 @@
 import org.utplsql.api.reporter.inspect.ReporterInspector;
 import org.utplsql.cli.exception.DatabaseConnectionFailed;
 import picocli.CommandLine.Command;
+import picocli.CommandLine.Option;
 import picocli.CommandLine.Parameters;
 
 import javax.sql.DataSource;
@@ -22,6 +23,9 @@ public class ReportersCommand implements ICommand {
     @Parameters(description = UtplsqlPicocliCommand.COMMANDLINE_PARAM_DESCRIPTION, arity = "1")
     private String connectionString;
 
+    @Option(names = "-h", usageHelp = true, description = "display this help and exit")
+    boolean help;
+
     @Override
     public int run() {
 

src/main/java/org/utplsql/cli/VersionInfoCommand.java

@@ -6,6 +6,7 @@
 import org.utplsql.api.db.DefaultDatabaseInformation;
 import org.utplsql.api.exception.UtPLSQLNotInstalledException;
 import picocli.CommandLine.Command;
+import picocli.CommandLine.Option;
 import picocli.CommandLine.Parameters;
 
 import javax.sql.DataSource;
@@ -18,6 +19,9 @@ public class VersionInfoCommand implements ICommand {
     @Parameters(description = UtplsqlPicocliCommand.COMMANDLINE_PARAM_DESCRIPTION, arity = "0..1")
     private String connectionString;
 
+    @Option(names = "-h", usageHelp = true, description = "display this help and exit")
+    boolean help;
+
     public int run() {
 
         System.out.println(CliVersionInfo.getInfo());

src/test/java/org/utplsql/cli/CliHelpTest.java

@@ -20,6 +20,36 @@ void show_basic_help_on_help_command() {
         assertTrue(output.contains("Usage:"));
     }
 
+    @Test
+    void show_help_for_run_command() {
+        capturer = new SystemCapturer.SystemOutCapturer();
+        capturer.start();
+        TestHelper.runApp("run", "-h");
+        String output = capturer.stop();
+
+        assertTrue(output.contains("Usage:"));
+    }
+
+    @Test
+    void show_help_for_reporters_command() {
+        capturer = new SystemCapturer.SystemOutCapturer();
+        capturer.start();
+        TestHelper.runApp("reporters", "-h");
+        String output = capturer.stop();
+
+        assertTrue(output.contains("Usage:"));
+    }
+
+    @Test
+    void show_help_for_info_command() {
+        capturer = new SystemCapturer.SystemOutCapturer();
+        capturer.start();
+        TestHelper.runApp("reporters", "-h");
+        String output = capturer.stop();
+
+        assertTrue(output.contains("Usage:"));
+    }
+
     @Test
     void write_help_to_error_out_on_unknown_command() {
         capturer = new SystemCapturer.SystemErrCapturer();