nextmv 1.0.0__py3-none-any.whl → 1.0.0.dev0__py3-none-any.whl

nextmv/cli/cloud/run/create.py

@@ -68,7 +68,7 @@ def create(
             "--tail",
             "-t",
             help="Tail the logs until the run completes. Logs are streamed to [magenta]stderr[/magenta]. "
-            "Specify log output location with --logs.",
+            "Specify log output location with [code]--logs[/code].",
             rich_help_panel="Output control",
         ),
     ] = False,
@@ -79,7 +79,7 @@ def create(
             "-w",
             help="Wait for the run to complete. Run result is printed to [magenta]stdout[/magenta] for "
             "[magenta]json[/magenta], to a dir for [magenta]multi-file[/magenta]. "
-            "Specify output location with --output.",
+            "Specify output location with [code]--output[/code].",
             rich_help_panel="Output control",
         ),
     ] = False,
@@ -129,7 +129,7 @@ def create(
             metavar="INSTANCE_ID",
             rich_help_panel="Run configuration",
         ),
-    ] = None,
+    ] = "latest",
     integration_id: Annotated[
         str | None,
         typer.Option(
@@ -210,99 +210,101 @@ def create(
     Create a new Nextmv Cloud application run.
 
     Input for the run should be given through [magenta]stdin[/magenta] or the
-    --input flag. When using the --input flag, the value can be one of the
-    following:
+    [code]--input[/code] flag. When using the [code]--input[/code] flag, the
+    value can be one of the following:
 
-    - [yellow]<FILE_PATH>[/yellow]: path to a [magenta]file[/magenta] containing
+    - [green]<FILE_PATH>[/green]: path to a [magenta]file[/magenta] containing
       the input data. Use with the [magenta]json[/magenta], and
       [magenta]text[/magenta] content formats.
-    - [yellow]<DIR_PATH>[/yellow]: path to a [magenta]directory[/magenta]
+    - [green]<DIR_PATH>[/green]: path to a [magenta]directory[/magenta]
       containing the input data files. Use with the
       [magenta]multi-file[/magenta] content format.
-    - [yellow]<.tar.gz PATH>[/yellow]: path to a [magenta].tar.gz[/magenta] file
+    - [green]<.tar.gz_PATH>[/green]: path to a [magenta].tar.gz[/magenta] file
       containing tarred input data files. Use with the
       [magenta]multi-file[/magenta] content format.
 
     The CLI determines how to send the input to the application based on the
     value.
 
-    Use the --wait flag to wait for the run to complete, polling for results.
-    Using the --output flag will also activate waiting, and allows you to
-    specify a destination (file or dir) for the output, depending on the
-    content type.
+    Use the [code]--wait[/code] flag to wait for the run to complete, polling
+    for results. Using the [code]--output[/code] flag will also activate
+    waiting, and allows you to specify a destination (file or dir) for the
+    output, depending on the content type.
 
-    Use the --tail flag to stream logs to [magenta]stderr[/magenta] until the
-    run completes. Using the --logs flag will also activate waiting, and allows
-    you to specify a file to write the logs to.
+    Use the [code]--tail[/code] flag to stream logs to
+    [magenta]stderr[/magenta] until the run completes. Using the
+    [code]--logs[/code] flag will also activate waiting, and allows you to
+    specify a file to write the logs to.
 
     An application run executes against a specific instance. An instance
     represents the combination of executable code and configuration. You can
-    specify the instance with the --instance-id flag. These are the possible
-    values for this flag:
+    specify the instance with the [code]--instance-id[/code] flag. These are
+    the possible values for this flag:
 
-    - [yellow]unspecified[/yellow]: Run against the default instance of the
-      application. When an application is created, the default instance is [magenta]latest[/magenta].
-    - [yellow]latest[/yellow]: uses the special [magenta]latest[/magenta]
+    - [green]latest[/green]: uses the special [magenta]latest[/magenta]
       instance of the application. This corresponds to the latest pushed
-      executable.
-    - [yellow]<INSTANCE_ID>[/yellow]: uses the instance with the given ID.
+      executable. This is the default behavior.
+    - [green]default[/green]: if the application has a [italic]default[/italic]
+      instance configured, then it uses that instance. Setting the flag's value
+      to [code]''[/code] (empty string) has the same effect.
+    - [green]<INSTANCE_ID>[/green]: uses the instance with the given ID.
 
     [bold][underline]Examples[/underline][/bold]
 
     - Read a [magenta]json[/magenta] input via [magenta]stdin[/magenta], from an [magenta]input.json[/magenta] file,
       and submit a run to an app with ID [magenta]hare-app[/magenta], using the [magenta]latest[/magenta] instance.
-        $ [dim]cat input.json | nextmv cloud run create --app-id hare-app[/dim]
+        $ [green]cat input.json | nextmv cloud run create --app-id hare-app[/green]
 
     - Read a [magenta]json[/magenta] input from an [magenta]input.json[/magenta] file, and
       submit a run to an app with ID [magenta]hare-app[/magenta], using the [magenta]latest[/magenta] instance.
-        $ [dim]nextmv cloud run create --app-id hare-app --input input.json[/dim]
+        $ [green]nextmv cloud run create --app-id hare-app --input input.json[/green]
 
     - Read a [magenta]json[/magenta] input from an [magenta]input.json[/magenta] file, and
       submit a run to an app with ID [magenta]hare-app[/magenta], using the [magenta]latest[/magenta] instance.
       Wait for the run to complete and print the result to [magenta]stdout[/magenta].
-        $ [dim]nextmv cloud run create --app-id hare-app --input input.json --wait[/dim]
+        $ [green]nextmv cloud run create --app-id hare-app --input input.json --wait[/green]
 
     - Read a [magenta]json[/magenta] input from an [magenta]input.json[/magenta] file, and
       submit a run to an app with ID [magenta]hare-app[/magenta], using the [magenta]latest[/magenta] instance.
       Tail the run's logs, streaming to [magenta]stderr[/magenta].
-        $ [dim]nextmv cloud run create --app-id hare-app --input input.json --tail[/dim]
+        $ [green]nextmv cloud run create --app-id hare-app --input input.json --tail[/green]
 
     - Read a [magenta]json[/magenta] input from an [magenta]input.json[/magenta] file, and
       submit a run to an app with ID [magenta]hare-app[/magenta], using the [magenta]latest[/magenta] instance.
       Wait for the run to complete and write the result to an [magenta]output.json[/magenta] file.
-        $ [dim]nextmv cloud run create --app-id hare-app --input input.json --output output.json[/dim]
+        $ [green]nextmv cloud run create --app-id hare-app --input input.json --output output.json[/green]
 
     - Read a [magenta]json[/magenta] input from an [magenta]input.json[/magenta] file, and
       submit a run to an app with ID [magenta]hare-app[/magenta], using the [magenta]latest[/magenta] instance.
       Wait for the run to complete, and write the logs to a [magenta]logs.log[/magenta] file.
-        $ [dim]nextmv cloud run create --app-id hare-app --input input.json --logs logs.log[/dim]
+        $ [green]nextmv cloud run create --app-id hare-app --input input.json --logs logs.log[/green]
 
     - Read a [magenta]json[/magenta] input from an [magenta]input.json[/magenta] file, and submit a run to an app with
       ID [magenta]hare-app[/magenta], using the [magenta]latest[/magenta] instance. Wait for the run to complete. Tail
       the run's logs, streaming to [magenta]stderr[/magenta]. Write the logs to a [magenta]logs.log[/magenta] file.
       Write the result to an [magenta]output.json[/magenta] file.
-        $ [dim]nextmv cloud run create --app-id hare-app --input input.json --tail --logs logs.log \\
-            --output output.json [/dim]
+        $ [green]nextmv cloud run create --app-id hare-app --input input.json --tail --logs logs.log \\
+            --output output.json [/green]
 
     - Read a [magenta]multi-file[/magenta] input from an [magenta]inputs[/magenta] directory, and
       submit a run to an app with ID [magenta]hare-app[/magenta], using the [magenta]default[/magenta] instance.
-        $ [dim]nextmv cloud run create --app-id hare-app --input inputs --instance-id default[/dim]
+        $ [green]nextmv cloud run create --app-id hare-app --input inputs --instance-id default[/green]
 
     - Read a [magenta]multi-file[/magenta] input from an [magenta]inputs[/magenta] directory, and
       submit a run to an app with ID [magenta]hare-app[/magenta], using the [magenta]default[/magenta] instance.
       Wait for the run to complete, and save the results to the default location (a directory named after the run ID).
-        $ [dim]nextmv cloud run create --app-id hare-app --input inputs --instance-id default --wait[/dim]
+        $ [green]nextmv cloud run create --app-id hare-app --input inputs --instance-id default --wait[/green]
 
     - Read a [magenta]multi-file[/magenta] input from an [magenta]inputs[/magenta] directory, and
       submit a run to an app with ID [magenta]hare-app[/magenta], using the [magenta]burrow[/magenta] instance.
       Wait for the run to complete and download the result files to an [magenta]outputs[/magenta] directory.
-        $ [dim]nextmv cloud run create --app-id hare-app --input inputs --instance-id burrow --output outputs[/dim]
+        $ [green]nextmv cloud run create --app-id hare-app --input inputs --instance-id burrow --output outputs[/green]
     """
 
     # Validate that input is provided.
     stdin = sys.stdin.read().strip() if sys.stdin.isatty() is False else None
     if stdin is None and (input is None or input == ""):
-        error("Input data must be provided via the --input flag or [magenta]stdin[/magenta].")
+        error("Input data must be provided via the [code]--input[/code] flag or [magenta]stdin[/magenta].")
 
     # Instantiate the basic requirements to start a new run.
     cloud_app = build_app(app_id=app_id, profile=profile)
@@ -318,6 +320,10 @@ def create(
     )
     run_options = build_run_options(options)
 
+    # Handles the default instance.
+    if instance_id == "default":
+        instance_id = ""
+
     # Start the run before deciding if we should poll or not.
     input_kwarg = resolve_input_kwarg(
         stdin=stdin,

nextmv/cli/cloud/run/get.py

@@ -46,7 +46,7 @@ def get(
             "-w",
             help="Wait for the run to complete. Run result is printed to [magenta]stdout[/magenta] for "
             "[magenta]json[/magenta], to a dir for [magenta]multi-file[/magenta]. "
-            "Specify output location with --output.",
+            "Specify output location with [code]--output[/code].",
         ),
     ] = False,
     profile: ProfileOption = None,
@@ -54,8 +54,8 @@ def get(
     """
     Get the result (output) of a Nextmv Cloud application run.
 
-    Use the --wait flag to wait for the run to complete, polling
-    for results. Using the --output flag will also activate
+    Use the [code]--wait[/code] flag to wait for the run to complete, polling
+    for results. Using the [code]--output[/code] flag will also activate
     waiting, and allows you to specify a destination (file or dir) for the
     output, depending on the content type.
 
@@ -63,25 +63,25 @@ def get(
 
     - Get the results of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta].
-        $ [dim]nextmv cloud run get --app-id hare-app --run-id burrow-123[/dim]
+        $ [green]nextmv cloud run get --app-id hare-app --run-id burrow-123[/green]
 
     - Get the results of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. Wait for the run to complete if necessary.
-        $ [dim]nextmv cloud run get --app-id hare-app --run-id burrow-123 --wait[/dim]
+        $ [green]nextmv cloud run get --app-id hare-app --run-id burrow-123 --wait[/green]
 
     - Get the results of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. The app is a [magenta]json[/magenta] app.
       Save the results to a [magenta]results.json[/magenta] file.
-        $ [dim]nextmv cloud run get --app-id hare-app --run-id burrow-123 --output results.json[/dim]
+        $ [green]nextmv cloud run get --app-id hare-app --run-id burrow-123 --output results.json[/green]
 
     - Get the results of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. The app is a [magenta]multi-file[/magenta] app.
       Save the results to the [magenta]results[/magenta] dir.
-        $ [dim]nextmv cloud run get --app-id hare-app --run-id burrow-123 --output results[/dim]
+        $ [green]nextmv cloud run get --app-id hare-app --run-id burrow-123 --output results[/green]
 
     - Get the results of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. Use the profile named [magenta]hare[/magenta].
-        $ [dim]nextmv cloud run get --app-id hare-app --run-id burrow-123 --profile hare[/dim]
+        $ [green]nextmv cloud run get --app-id hare-app --run-id burrow-123 --profile hare[/green]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/run/input.py

@@ -35,21 +35,21 @@ def input(
     Get the input of a Nextmv Cloud application run.
 
     By default, the input is fetched and printed to [magenta]stdout[/magenta].
-    Use the --output flag to save the input to a file.
+    Use the [code]--output[/code] flag to save the input to a file.
 
     [bold][underline]Examples[/underline][/bold]
 
     - Get the input of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. Input is printed to [magenta]stdout[/magenta].
-        $ [dim]nextmv cloud run input --app-id hare-app --run-id burrow-123[/dim]
+        $ [green]nextmv cloud run input --app-id hare-app --run-id burrow-123[/green]
 
     - Get the input of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. Save the input to a [magenta]input.json[/magenta] file.
-        $ [dim]nextmv cloud run input --app-id hare-app --run-id burrow-123 --output input.json[/dim]
+        $ [green]nextmv cloud run input --app-id hare-app --run-id burrow-123 --output input.json[/green]
 
     - Get the input of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. Use the profile named [magenta]hare[/magenta].
-        $ [dim]nextmv cloud run input --app-id hare-app --run-id burrow-123 --profile hare[/dim]
+        $ [green]nextmv cloud run input --app-id hare-app --run-id burrow-123 --profile hare[/green]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/run/list.py

@@ -43,25 +43,25 @@ def list(
     Get the list of runs for a Nextmv Cloud application.
 
     By default, the list of runs is fetched and printed to [magenta]stdout[/magenta].
-    Use the --output flag to save the list to a file.
+    Use the [code]--output[/code] flag to save the list to a file.
 
-    You can use the optional --status flag to filter runs by their status.
+    You can use the optional [code]--status[/code] flag to filter runs by their status.
 
     [bold][underline]Examples[/underline][/bold]
 
     - Get the list of runs for an app with ID [magenta]hare-app[/magenta]. List is printed to [magenta]stdout[/magenta].
-        $ [dim]nextmv cloud run list --app-id hare-app[/dim]
+        $ [green]nextmv cloud run list --app-id hare-app[/green]
 
     - Get the list of runs for an app with ID [magenta]hare-app[/magenta]. Save the list to a
       [magenta]runs.json[/magenta] file.
-        $ [dim]nextmv cloud run list --app-id hare-app --output runs.json[/dim]
+        $ [green]nextmv cloud run list --app-id hare-app --output runs.json[/green]
 
     - Get the list of runs for an app with ID [magenta]hare-app[/magenta].
       Use the profile named [magenta]hare[/magenta].
-        $ [dim]nextmv cloud run list --app-id hare-app --profile hare[/dim]
+        $ [green]nextmv cloud run list --app-id hare-app --profile hare[/green]
 
     - Get the list of [magenta]queued[/magenta] runs for an app with ID [magenta]hare-app[/magenta].
-        $ [dim]nextmv cloud run list --app-id hare-app --status queued[/dim]
+        $ [green]nextmv cloud run list --app-id hare-app --status queued[/green]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/run/logs.py

@@ -38,7 +38,7 @@ def logs(
             "--tail",
             "-t",
             help="Tail the logs until the run completes. Logs are streamed to [magenta]stderr[/magenta]. "
-            "Specify log output location with --output.",
+            "Specify log output location with [code]--output[/code].",
         ),
     ] = False,
     timeout: Annotated[
@@ -54,31 +54,32 @@ def logs(
     Get the logs of a Nextmv Cloud application run.
 
     By default, the logs are fetched and printed to [magenta]stderr[/magenta].
-    Use the --tail flag to stream logs to [magenta]stderr[/magenta] until the
-    run completes. Using the --output flag will also activate waiting, and
-    allows you to specify a file to write the logs to.
+    Use the [code]--tail[/code] flag to stream logs to
+    [magenta]stderr[/magenta] until the run completes. Using the
+    [code]--output[/code] flag will also activate waiting, and allows you to
+    specify a file to write the logs to.
 
     [bold][underline]Examples[/underline][/bold]
 
     - Get the logs of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. Logs are printed to [magenta]stderr[/magenta].
-        $ [dim]nextmv cloud run logs --app-id hare-app --run-id burrow-123[/dim]
+        $ [green]nextmv cloud run logs --app-id hare-app --run-id burrow-123[/green]
 
     - Get the logs of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. Tail the logs until the run completes.
-        $ [dim]nextmv cloud run logs --app-id hare-app --run-id burrow-123 --tail[/dim]
+        $ [green]nextmv cloud run logs --app-id hare-app --run-id burrow-123 --tail[/green]
 
     - Get the logs of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. Save the logs to a [magenta]logs.log[/magenta] file.
-        $ [dim]nextmv cloud run logs --app-id hare-app --run-id burrow-123 --output logs.log[/dim]
+        $ [green]nextmv cloud run logs --app-id hare-app --run-id burrow-123 --output logs.log[/green]
 
     - Get the logs of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. Tail the logs and save them to a [magenta]logs.log[/magenta] file.
-        $ [dim]nextmv cloud run logs --app-id hare-app --run-id burrow-123 --tail --output logs.log[/dim]
+        $ [green]nextmv cloud run logs --app-id hare-app --run-id burrow-123 --tail --output logs.log[/green]
 
     - Get the logs of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. Use the profile named [magenta]hare[/magenta].
-        $ [dim]nextmv cloud run logs --app-id hare-app --run-id burrow-123 --profile hare[/dim]
+        $ [green]nextmv cloud run logs --app-id hare-app --run-id burrow-123 --profile hare[/green]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/run/metadata.py

@@ -34,21 +34,21 @@ def metadata(
     Get the metadata of a Nextmv Cloud application run.
 
     By default, the metadata is fetched and printed to [magenta]stdout[/magenta].
-    Use the --output flag to save the metadata to a file.
+    Use the [code]--output[/code] flag to save the metadata to a file.
 
     [bold][underline]Examples[/underline][/bold]
 
     - Get the metadata of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. Metadata is printed to [magenta]stdout[/magenta].
-        $ [dim]nextmv cloud run metadata --app-id hare-app --run-id burrow-123[/dim]
+        $ [green]nextmv cloud run metadata --app-id hare-app --run-id burrow-123[/green]
 
     - Get the metadata of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. Save the metadata to a [magenta]metadata.json[/magenta] file.
-        $ [dim]nextmv cloud run metadata --app-id hare-app --run-id burrow-123 --output metadata.json[/dim]
+        $ [green]nextmv cloud run metadata --app-id hare-app --run-id burrow-123 --output metadata.json[/green]
 
     - Get the metadata of a run with ID [magenta]burrow-123[/magenta], belonging to an app with ID
       [magenta]hare-app[/magenta]. Use the profile named [magenta]hare[/magenta].
-        $ [dim]nextmv cloud run metadata --app-id hare-app --run-id burrow-123 --profile hare[/dim]
+        $ [green]nextmv cloud run metadata --app-id hare-app --run-id burrow-123 --profile hare[/green]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/run/track.py

@@ -143,86 +143,87 @@ def track(
     """
     Track an external run as a Nextmv Cloud application run.
 
-    Please see the help of the --content-type option for details on valid
-    content types.
+    Please see the help of the [code]--content-type[/code] option for details
+    on valid content types.
 
     If the content type is [magenta]json[/magenta] or [magenta]text[/magenta],
     then input for the run can be given through [magenta]stdin[/magenta]. The
-    --input option allows you to specify a file or directory path for the
-    input, instead of using [magenta]stdin[/magenta]. In the case of
+    [code]--input[/code] option allows you to specify a file or directory path
+    for the input, instead of using [magenta]stdin[/magenta]. In the case of
     [magenta]multi-file[/magenta] content type, the input must be given through
-    a directory specified via the --input option.
+    a directory specified via the [code]--input[/code] option.
 
-    The --output option allows you to specify a file or directory path for the
-    output of the run. The behavior depends on the content type. If the content
-    type is [magenta]json[/magenta] or [magenta]text[/magenta], then a file
-    path must be provided. If the content type is
+    The [code]--output[/code] option allows you to specify a file or directory
+    path for the output of the run. The behavior depends on the content type.
+    If the content type is [magenta]json[/magenta] or [magenta]text[/magenta],
+    then a file path must be provided. If the content type is
     [magenta]multi-file[/magenta], then a directory path must be provided.
 
     Run logs, assets, and statistics can be provided via files using the
-    --logs, --assets, and --statistics options, respectively. Assets and
-    statistics must be provided as [magenta]json[/magenta] files, while logs
-    must be provided as a utf-8 encoded text file.
+    [code]--logs[/code], [code]--assets[/code], and [code]--statistics[/code]
+    options, respectively. Assets and statistics must be provided as
+    [magenta]json[/magenta] files, while logs must be provided as a utf-8
+    encoded text file.
 
     [bold][underline]Examples[/underline][/bold]
 
     - Track a [magenta]successful[/magenta] [magenta]json[/magenta] run via [magenta]stdin[/magenta]
       input, for an app with ID [magenta]hare-app[/magenta].
-        $ [dim]cat input.json | nextmv cloud run track --app-id hare-app --status succeeded[/dim]
+        $ [green]cat input.json | nextmv cloud run track --app-id hare-app --status succeeded[/green]
 
     - Track a [magenta]successful[/magenta] [magenta]json[/magenta] run with input from an
       [magenta]input.json[/magenta] file and output from an
       [magenta]output.json[/magenta] file, for an app with ID
       [magenta]hare-app[/magenta].
-        $ [dim]nextmv cloud run track --app-id hare-app --status succeeded --input input.json \\
-            --output output.json[/dim]
+        $ [green]nextmv cloud run track --app-id hare-app --status succeeded --input input.json \\
+            --output output.json[/green]
 
     - Track a [magenta]successful[/magenta] [magenta]json[/magenta] run including logs from a
       [magenta]logs.log[/magenta] file, for an app with ID
       [magenta]hare-app[/magenta].
-        $ [dim]nextmv cloud run track --app-id hare-app --status succeeded --input input.json \\
-            --output output.json --logs logs.log[/dim]
+        $ [green]nextmv cloud run track --app-id hare-app --status succeeded --input input.json \\
+            --output output.json --logs logs.log[/green]
 
     - Track a [magenta]successful[/magenta] [magenta]json[/magenta] run with assets and statistics
       from [magenta]json[/magenta] files, for an app with ID
       [magenta]hare-app[/magenta].
-        $ [dim]nextmv cloud run track --app-id hare-app --status succeeded --input input.json \\
-            --output output.json --assets assets.json --statistics statistics.json[/dim]
+        $ [green]nextmv cloud run track --app-id hare-app --status succeeded --input input.json \\
+            --output output.json --assets assets.json --statistics statistics.json[/green]
 
     - Track a [magenta]failed[/magenta] run with an error message, for an app with ID
       [magenta]hare-app[/magenta].
-        $ [dim]nextmv cloud run track --app-id hare-app --status failed --input input.json \\
-            --error-msg "Solver timed out"[/dim]
+        $ [green]nextmv cloud run track --app-id hare-app --status failed --input input.json \\
+            --error-msg "Solver timed out"[/green]
 
     - Track a [magenta]successful[/magenta] [magenta]text[/magenta] run with text content type,
       for an app with ID [magenta]hare-app[/magenta].
-        $ [dim]nextmv cloud run track --app-id hare-app --status succeeded --input input.txt \\
-            --output output.txt --content-type text[/dim]
+        $ [green]nextmv cloud run track --app-id hare-app --status succeeded --input input.txt \\
+            --output output.txt --content-type text[/green]
 
     - Track a [magenta]successful[/magenta] [magenta]multi-file[/magenta] run from an
       [magenta]inputs[/magenta] directory with output to an
       [magenta]outputs[/magenta] directory, for an app with ID
       [magenta]hare-app[/magenta], using the [magenta]default[/magenta]
       instance.
-        $ [dim]nextmv cloud run track --app-id hare-app --status succeeded --input inputs \\
-            --output outputs --content-type multi-file --instance-id default[/dim]
+        $ [green]nextmv cloud run track --app-id hare-app --status succeeded --input inputs \\
+            --output outputs --content-type multi-file --instance-id default[/green]
 
     - Track a [magenta]successful[/magenta] run with a name, description, and duration, for an app
       with ID [magenta]hare-app[/magenta].
-        $ [dim]nextmv cloud run track --app-id hare-app --status succeeded --input input.json \\
-            --output output.json --name "Production run" --description "Weekly optimization" --duration 5000[/dim]
+        $ [green]nextmv cloud run track --app-id hare-app --status succeeded --input input.json \\
+            --output output.json --name "Production run" --description "Weekly optimization" --duration 5000[/green]
 
     - Track a [magenta]successful[/magenta] [magenta]json[/magenta] run with all available options,
       for an app with ID [magenta]hare-app[/magenta].
-        $ [dim]nextmv cloud run track --app-id hare-app --status succeeded --input input.json \\
+        $ [green]nextmv cloud run track --app-id hare-app --status succeeded --input input.json \\
             --output output.json --logs logs.log --assets assets.json --statistics statistics.json \\
-                --name "Full run" --description "Complete example" --duration 10000 --instance-id burrow[/dim]
+                --name "Full run" --description "Complete example" --duration 10000 --instance-id burrow[/green]
     """
 
     # Validate that input is provided.
     stdin = sys.stdin.read().strip() if sys.stdin.isatty() is False else None
     if stdin is None and (input is None or input == ""):
-        error("Input data must be provided via the --input flag or [magenta]stdin[/magenta].")
+        error("Input data must be provided via the [code]--input[/code] flag or [magenta]stdin[/magenta].")
 
     # Instantiate the basic requirements to start a new run.
     cloud_app = build_app(app_id=app_id, profile=profile)
@@ -392,7 +393,7 @@ def resolve_input(
                 error(
                     "Input provided via [magenta]stdin[/magenta] is [magenta]json[/magenta], "
                     f"but the specified content format is {content_format.value}. "
-                    "--content-format should be set to [magenta]json[/magenta]."
+                    "[code]--content-format[/code] should be set to [magenta]json[/magenta]."
                 )
 
         except json.JSONDecodeError:
@@ -401,7 +402,7 @@ def resolve_input(
                 error(
                     "Input provided via [magenta]stdin[/magenta] is [magenta]text[/magenta], "
                     f"but the specified content format is {content_format.value}. "
-                    "--content-format should be set to [magenta]text[/magenta]."
+                    "[code]--content-format[/code] should be set to [magenta]text[/magenta]."
                 )
 
         tracked_run.input = input_data

nextmv/cli/cloud/scenario/create.py

@@ -100,7 +100,7 @@ def create(
             "--wait",
             "-w",
             help="Wait for the scenario test to complete. Results are printed to [magenta]stdout[/magenta]. "
-            "Specify output location with --output.",
+            "Specify output location with [code]--output[/code].",
             rich_help_panel="Output control",
         ),
     ] = False,
@@ -112,21 +112,21 @@ def create(
     A scenario test allows you to run multiple scenarios with different inputs,
     instances/versions, and configurations in a single test.
 
-    Use the --wait flag to wait for the scenario test to complete,
-    polling for results. Using the --output flag will also
+    Use the [code]--wait[/code] flag to wait for the scenario test to complete,
+    polling for results. Using the [code]--output[/code] flag will also
     activate waiting, and allows you to specify a destination file for the
     results.
 
     [bold][underline]Scenarios[/underline][/bold]
 
     Scenarios are provided as [magenta]json[/magenta] objects using the
-    --scenarios flag. Each scenario defines the configuration for a scenario
-    test execution.
+    [code]--scenarios[/code] flag. Each scenario defines the configuration for
+    a scenario test execution.
 
     You can provide scenarios in three ways:
     - A single scenario as a [magenta]json[/magenta] object.
-    - Multiple scenarios by repeating the --scenarios flag.
-    - Multiple scenarios as a [magenta]json[/magenta] array in a single --scenarios flag.
+    - Multiple scenarios by repeating the [code]--scenarios[/code] flag.
+    - Multiple scenarios as a [magenta]json[/magenta] array in a single [code]--scenarios[/code] flag.
 
     Each scenario must have the following fields:
     - [magenta]instance_id[/magenta]: ID of the instance to use for this scenario (required).
@@ -142,7 +142,7 @@ def create(
         - [magenta]values[/magenta]: List of values for the configuration option.
 
     Example object format:
-    [dim]{
+    [green]{
         "instance_id": "bunny-hopper-v2",
         "scenario_input": {
             "scenario_input_type": "input_set",
@@ -157,12 +157,12 @@ def create(
                 "values": ["optimized", "balanced", "safe"]
             }
         ]
-    }[/dim]
+    }[/green]
 
     [bold][underline]Examples[/underline][/bold]
 
     - Create a scenario test with a single scenario.
-        $ [dim]SCENARIO='{
+        $ [green]SCENARIO='{
             "instance_id": "warren-planner-v1",
             "scenario_input": {
                 "scenario_input_type": "input_set",
@@ -172,10 +172,10 @@ def create(
                 }
             }
         }'
-        nextmv cloud scenario create --app-id hare-app --name "Spring Meadow Routes" --scenarios "$SCENARIO"[/dim]
+        nextmv cloud scenario create --app-id hare-app --name "Spring Meadow Routes" --scenarios "$SCENARIO"[/green]
 
     - Create with multiple scenarios by repeating the flag.
-        $ [dim]SCENARIO1='{
+        $ [green]SCENARIO1='{
             "instance_id": "hop-optimizer",
             "scenario_input": {
                 "scenario_input_type": "input_set",
@@ -196,10 +196,10 @@ def create(
             }
         }'
         nextmv cloud scenario create --app-id hare-app --name "Lettuce Delivery Optimization" \\
-            --scenarios "$SCENARIO1" --scenarios "$SCENARIO2"[/dim]
+            --scenarios "$SCENARIO1" --scenarios "$SCENARIO2"[/green]
 
     - Create with multiple scenarios in a single [magenta]json[/magenta] array.
-        $ [dim]SCENARIOS='[
+        $ [green]SCENARIOS='[
             {
                 "instance_id": "burrow-builder",
                 "scenario_input": {
@@ -222,10 +222,10 @@ def create(
             }
         ]'
         nextmv cloud scenario create --app-id hare-app --name "Warren Construction Plans" \\
-            --scenarios "$SCENARIOS"[/dim]
+            --scenarios "$SCENARIOS"[/green]
 
     - Create a scenario test and wait for it to complete.
-        $ [dim]SCENARIO='{
+        $ [green]SCENARIO='{
             "instance_id": "foraging-route",
             "scenario_input": {
                 "scenario_input_type": "input_set",
@@ -236,10 +236,10 @@ def create(
             }
         }'
         nextmv cloud scenario create --app-id hare-app --name "Autumn Carrot Collection" --scenarios "$SCENARIO" \\
-            --wait[/dim]
+            --wait[/green]
 
     - Create a scenario test and save the results to a file, waiting for completion.
-        $ [dim]SCENARIO='{
+        $ [green]SCENARIO='{
             "instance_id": "safe-hopper",
             "scenario_input": {
                 "scenario_input_type": "input_set",
@@ -250,10 +250,10 @@ def create(
             }
         }'
         nextmv cloud scenario create --app-id hare-app --name "Fox Avoidance Routes" --scenarios "$SCENARIO" \\
-            --output bunny-safety-results.json[/dim]
+            --output bunny-safety-results.json[/green]
 
     - Create a scenario test with configuration options.
-        $ [dim]SCENARIO='{
+        $ [green]SCENARIO='{
             "instance_id": "hop-optimizer",
             "scenario_input": {
                 "scenario_input_type": "input_set",
@@ -269,7 +269,7 @@ def create(
                 }
             ]
         }'
-        nextmv cloud scenario create --app-id hare-app --name "Speed Analysis" --scenarios "$SCENARIO"[/dim]
+        nextmv cloud scenario create --app-id hare-app --name "Speed Analysis" --scenarios "$SCENARIO"[/green]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)