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]
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"]
