id          = "gauge"
name        = "Gauge"
homepage    = "https://docs.gauge.org/configuration.html"
description = "Gauge is a light weight cross-platform test automation tool."
executables      = ["gauge"]

[dotfiles]

# https://docs.gauge.org/configuration.html — global gauge.properties is at
# ~/.gauge/config on macOS/Linux and %APPDATA%\\gauge\\config on Windows.
paths  = ["~/.gauge/config", "%APPDATA%/gauge/config"]
secret = []

[commands]
format = 1
label = "Run specs"
description = "Run Gauge specs and scenarios with environment, tag and parallel-execution filters. Retry, strategy and rerun options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]
id = "src"
kind = "manual"
url = "https://github.com/getgauge/gauge/blob/master/cmd/run.go"
revision = "master 2026-10"
evidence = """
Use:   "run [flags] [args]"
gauge run --tags "login" -s -p specs/
-v, --verbose  Enable step level reporting on console, default being scenario level
--simple-console  Removes colouring and simplifies the console output
-e, --env  Specifies the environment to use
-t, --tags  Executes the specs and scenarios tagged with given tags
-r, --table-rows  Executes the specs and scenarios only for the selected rows. It can be specified by range as 2-4 or as list 2,4
-p, --parallel  Execute specs in parallel
-n  Specify number of parallel execution streams
"""

[[commands.field]]
id = "specs"
label = "Specs or directories"
type = "path"
position = 0
multiple = true
min = 0
path = { kind = "any", role = "input" }
sources = ["src"]

[[commands.field]]
id = "env"
label = "Environment"
type = "string"
option = ["--env", "-e"]
sources = ["src"]

[[commands.field]]
id = "tags"
label = "Tags expression"
type = "string"
option = ["--tags", "-t"]
sources = ["src"]

[[commands.field]]
id = "table_rows"
label = "Table rows"
description = "A range such as 2-4 or a list such as 2,4."
type = "string"
option = ["--table-rows", "-r"]
sources = ["src"]

[[commands.field]]
id = "parallel"
label = "Run in parallel"
type = "boolean"
option = ["--parallel", "-p"]
sources = ["src"]

[[commands.field]]
id = "streams"
label = "Parallel streams"
type = "integer"
option = ["-n"]
sources = ["src"]

[[commands.field]]
id = "verbose"
label = "Step-level output"
type = "boolean"
option = ["--verbose", "-v"]
sources = ["src"]

[[commands.field]]
id = "simple_console"
label = "Simple console output"
type = "boolean"
option = ["--simple-console"]
sources = ["src"]

[[commands.task]]
id = "run"
label = "Run specs"
fields = ["specs", "env", "tags", "verbose"]
required = []

[[commands.task]]
id = "run-parallel"
label = "Run in parallel"
set = { parallel = [true] }
lock = ["parallel"]
fields = ["specs", "parallel", "streams", "env", "tags"]
required = []

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["specs", "env", "tags", "parallel", "streams"]
[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["table_rows", "verbose", "simple_console"]