fix viash -> Viash in CLI documentation

add a few lines on how to use viash run to a component using the package bundle
strip a few stripMargin calls that are not needed

Author: hcannoodt

src/main/scala/io/viash/cli/CLIConf.scala

@@ -56,7 +56,7 @@ trait ViashCommand {
   )
   val config = registerTrailArg[String](
     name = "config",
-    descr = "A viash config file (example: `config.vsh.yaml`). This argument can also be a script with the config as a header.",
+    descr = "A Viash config file (example: `config.vsh.yaml`). This argument can also be a script with the config as a header.",
     default = Some("config.vsh.yaml"),
     required = true
   )
@@ -65,7 +65,7 @@ trait ViashCommand {
     short = Some('c'),
     default = Some(Nil),
 
-    descr = "Modify a viash config at runtime using @[dynamic config modding](config_mod)."
+    descr = "Modify a Viash config at runtime using @[dynamic config modding](config_mod)."
   )
 }
 trait ViashRunner {
@@ -110,7 +110,7 @@ trait ViashNs {
   val src = registerOpt[String](
     name = "src",
     short = Some('s'),
-    descr = "A source directory containing viash config files, possibly structured in a hierarchical folder structure. Default: src/.",
+    descr = "A source directory containing Viash config files, possibly structured in a hierarchical folder structure. Default: src/.",
     default = None
   )
   val platform = registerOpt[String](
@@ -153,7 +153,7 @@ trait ViashNs {
     name = "config_mod",
     short = Some('c'),
     default = Some(Nil),
-    descr = "Modify a viash config at runtime using @[dynamic config modding](config_mod)."
+    descr = "Modify a Viash config at runtime using @[dynamic config modding](config_mod)."
   )
 }
 
@@ -237,12 +237,14 @@ class CLIConf(arguments: Seq[String]) extends ScallopConf(arguments) with Loggin
   val run = new DocumentedSubcommand("run") with ViashCommand with WithTemporary with ViashRunner with ViashLogger {
     banner(
       "viash run",
-      "Executes a viash component from the provided viash config file. viash generates a temporary executable and immediately executes it with the given parameters.",
-      "viash run config.vsh.yaml [-p docker] [-k true/false]  -- [arguments for script]")
+      """Executes a Viash component from the provided Viash config file. Viash generates a temporary executable and immediately executes it with the given parameters.
+        |Alternatively, a component can be fetched directly for Viash-Hub.""".stripMargin,
+      """viash run config.vsh.yaml [-p docker] [-k true/false]  -- [arguments for script]
+        |viash run vsh://toolbox/v0.1.0/yq -- --input input.yaml --output output.yaml --eval '.name'""".stripMargin)
 
     footer(
       s"""  -- param1 param2 ...    Extra parameters to be passed to the component itself.
-         |                          -- is used to separate viash arguments from the arguments
+         |                          -- is used to separate Viash arguments from the arguments
          |                          of the component.
          |
          |The temporary directory can be altered by setting the VIASH_TEMP directory. Example:
@@ -253,7 +255,7 @@ class CLIConf(arguments: Seq[String]) extends ScallopConf(arguments) with Loggin
   object build extends DocumentedSubcommand("build") with ViashCommand with ViashLogger {
     banner(
       "viash build",
-      "Build an executable from the provided viash config file.",
+      "Build an executable from the provided Viash config file.",
       "viash build config.vsh.yaml -o output [-p docker] [-m] [-s]")
 
     val output = registerOpt[String](
@@ -279,7 +281,7 @@ class CLIConf(arguments: Seq[String]) extends ScallopConf(arguments) with Loggin
   object test extends DocumentedSubcommand("test") with ViashCommand with WithTemporary with ViashRunner with ViashLogger {
     banner(
       "viash test",
-      "Test the component using the tests defined in the viash config file.",
+      "Test the component using the tests defined in the Viash config file.",
       "viash test config.vsh.yaml [-p docker] [-k true/false] [--setup cachedbuild]")
 
     val setup = registerOpt[String](
@@ -347,7 +349,7 @@ class CLIConf(arguments: Seq[String]) extends ScallopConf(arguments) with Loggin
     object build extends DocumentedSubcommand("build") with ViashNs with ViashNsBuild with ViashLogger {
       banner(
         "viash ns build",
-        "Build a namespace from many viash config files.",
+        "Build a namespace from many Viash config files.",
         "viash ns build [-n nmspc] [-s src] [-t target] [-p docker] [--setup] [--push] [--parallel] [--flatten]")
 
       val setup = registerOpt[String](
@@ -371,7 +373,7 @@ class CLIConf(arguments: Seq[String]) extends ScallopConf(arguments) with Loggin
     object test extends DocumentedSubcommand("test") with ViashNs with WithTemporary with ViashRunner with ViashLogger {
       banner(
         "viash ns test",
-        "Test a namespace containing many viash config files.",
+        "Test a namespace containing many Viash config files.",
         "viash ns test [-n nmspc] [-s src] [-p docker] [--parallel] [--tsv file.tsv] [--setup cachedbuild] [--append]")
 
       val setup = registerOpt[String](
@@ -408,7 +410,7 @@ class CLIConf(arguments: Seq[String]) extends ScallopConf(arguments) with Loggin
     object list extends DocumentedSubcommand("list") with ViashNs with ViashLogger {
       banner(
         "viash ns list",
-        "List a namespace containing many viash config files.",
+        "List a namespace containing many Viash config files.",
         "viash ns list [-n nmspc] [-s src] [-p docker]")
 
       val format = registerChoice(
@@ -491,7 +493,7 @@ class CLIConf(arguments: Seq[String]) extends ScallopConf(arguments) with Loggin
 
       val cmd = registerTrailArg[String](
         name = "cmd",
-        descr = "The command to execute for each viash config file in the namespace.",
+        descr = "The command to execute for each Viash config file in the namespace.",
         required = true
       )
     }
@@ -511,8 +513,8 @@ class CLIConf(arguments: Seq[String]) extends ScallopConf(arguments) with Loggin
     object resource extends DocumentedSubcommand("resource") with ViashLogger {
       banner(
         "viash export resource",
-        """Export an internal resource file""".stripMargin,
-        """viash export resource runners/nextflow/WorkflowHelper.nf [--output foo.nf]""".stripMargin
+        """Export an internal resource file""",
+        """viash export resource runners/nextflow/WorkflowHelper.nf [--output foo.nf]"""
       )
 
       val path = registerTrailArg[String](
@@ -531,8 +533,8 @@ class CLIConf(arguments: Seq[String]) extends ScallopConf(arguments) with Loggin
     object cli_schema extends DocumentedSubcommand("cli_schema") with ViashLogger {
       banner(
         "viash export cli_schema",
-        """Export the schema of the Viash CLI as a JSON""".stripMargin,
-        """viash export cli_schema [--output file.json] [--format json]""".stripMargin
+        """Export the schema of the Viash CLI as a JSON""",
+        """viash export cli_schema [--output file.json] [--format json]"""
       )
       val output = registerOpt[String](
         name = "output",
@@ -551,8 +553,8 @@ class CLIConf(arguments: Seq[String]) extends ScallopConf(arguments) with Loggin
     object cli_autocomplete extends DocumentedSubcommand("cli_autocomplete") with ViashLogger {
       banner(
         "viash export bash_autocomplete",
-        """Export the autocomplete script as to be used in Bash or Zsh""".stripMargin,
-        """viash export bash_autocomplete [--output viash_autocomplete_bash] [--zsh]""".stripMargin
+        """Export the autocomplete script as to be used in Bash or Zsh""",
+        """viash export bash_autocomplete [--output viash_autocomplete_bash] [--zsh]"""
       )
       val output = registerOpt[String](
         name = "output",
@@ -571,8 +573,8 @@ class CLIConf(arguments: Seq[String]) extends ScallopConf(arguments) with Loggin
     object config_schema extends DocumentedSubcommand("config_schema") with ViashLogger {
       banner(
         "viash export config_schema",
-        """Export the schema of a Viash config as a JSON""".stripMargin,
-        """viash export config_schema [--output file.json] [--format json]""".stripMargin
+        """Export the schema of a Viash config as a JSON""",
+        """viash export config_schema [--output file.json] [--format json]"""
       )
       val output = registerOpt[String](
         name = "output",
@@ -591,8 +593,8 @@ class CLIConf(arguments: Seq[String]) extends ScallopConf(arguments) with Loggin
     object json_schema extends DocumentedSubcommand("json_schema") with ViashLogger {
       banner(
         "viash export json_schema",
-        """Export the json schema to validate a Viash config""".stripMargin,
-        """viash export json_schema [--output file.json] [--format json]""".stripMargin
+        """Export the json schema to validate a Viash config""",
+        """viash export json_schema [--output file.json] [--format json]"""
       )
       val output = registerOpt[String](
         name = "output",