id       = "delve"
name     = "Delve"
homepage = "https://github.com/go-delve/delve"
description = "A debugger for the Go programming language."
executables   = ["dlv"]

[dotfiles]

# Delve's official CLI documentation says config.yml is in
# $XDG_CONFIG_HOME/dlv, ~/.config/dlv on Linux, and ~/.dlv on other systems.
# The XDG spelling is represented by [configHome], while the macOS legacy
# location is listed explicitly.
# https://github.com/go-delve/delve/blob/master/Documentation/cli/README.md
paths = ["[configHome]/dlv/config.yml", "~/.dlv/config.yml"]

exclude = []
secret = []

[commands]
format = 1
label = "Debug Go code"
description = "Start a Delve debug session for a package, its tests or a built binary. Attach, core, trace, DAP and redirect options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }


[[commands.subcommand]]
path = ["debug"]
label = "Debug a package"

[[commands.subcommand.source]]
id = "src"
kind = "help"
url = "https://github.com/go-delve/delve/blob/master/Documentation/usage/dlv_debug.md"
evidence = """
dlv debug [package] [flags]
      --continue        Continue the debugged process on start.
      --output string   Output path for the binary.
      --build-flags string               Build flags, to be passed to the compiler. For example: --build-flags="-tags=integration -mod=vendor -cover -v"
      --headless                         Run debug server only, in headless mode. Server will accept both JSON-RPC or DAP client connections.
  -l, --listen string                    Debugging server listen address. Prefix with 'unix:' to use a unix domain socket. (default "127.0.0.1:0")
      --wd string                        Working directory for running the program.
"""

[[commands.subcommand.field]]
id = "package"
label = "Package"
description = "Defaults to the main package in the current directory."
type = "string"
position = 0
sources = ["src"]

[[commands.subcommand.field]]
id = "continue"
label = "Continue on start"
type = "boolean"
option = ["--continue"]
sources = ["src"]

[[commands.subcommand.field]]
id = "output"
label = "Binary output path"
type = "path"
option = ["--output"]
path = { kind = "file", role = "output" }
sources = ["src"]

[[commands.subcommand.field]]
id = "build_flags"
label = "Build flags"
description = "Passed to the Go compiler, e.g. -tags=integration."
type = "string"
option = ["--build-flags"]
sources = ["src"]

[[commands.subcommand.field]]
id = "headless"
label = "Headless server"
description = "Run the debug server only, without a terminal client."
type = "boolean"
option = ["--headless"]
sources = ["src"]

[[commands.subcommand.field]]
id = "listen"
label = "Listen address"
type = "string"
option = ["--listen", "-l"]
sources = ["src"]

[[commands.subcommand.field]]
id = "wd"
label = "Working directory"
type = "path"
option = ["--wd"]
path = { kind = "directory", role = "input" }
sources = ["src"]

[[commands.subcommand.task]]
id = "debug"
label = "Debug a package"
fields = ["package", "continue", "build_flags"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["package", "continue"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["output", "build_flags", "headless", "listen", "wd"]

[[commands.subcommand]]
path = ["test"]
label = "Debug tests"

[[commands.subcommand.source]]
id = "src"
kind = "help"
url = "https://github.com/go-delve/delve/blob/master/Documentation/usage/dlv_test.md"
evidence = """
dlv test [package] [flags]
      --output string   Output path for the binary.
      --build-flags string               Build flags, to be passed to the compiler. For example: --build-flags="-tags=integration -mod=vendor -cover -v"
      --headless                         Run debug server only, in headless mode. Server will accept both JSON-RPC or DAP client connections.
  -l, --listen string                    Debugging server listen address. Prefix with 'unix:' to use a unix domain socket. (default "127.0.0.1:0")
      --wd string                        Working directory for running the program.
"""

[[commands.subcommand.field]]
id = "package"
label = "Package"
description = "Defaults to the package in the current directory."
type = "string"
position = 0
sources = ["src"]

[[commands.subcommand.field]]
id = "output"
label = "Test binary output path"
type = "path"
option = ["--output"]
path = { kind = "file", role = "output" }
sources = ["src"]

[[commands.subcommand.field]]
id = "build_flags"
label = "Build flags"
description = "Passed to the Go compiler, e.g. -tags=integration."
type = "string"
option = ["--build-flags"]
sources = ["src"]

[[commands.subcommand.field]]
id = "headless"
label = "Headless server"
description = "Run the debug server only, without a terminal client."
type = "boolean"
option = ["--headless"]
sources = ["src"]

[[commands.subcommand.field]]
id = "listen"
label = "Listen address"
type = "string"
option = ["--listen", "-l"]
sources = ["src"]

[[commands.subcommand.field]]
id = "wd"
label = "Working directory"
type = "path"
option = ["--wd"]
path = { kind = "directory", role = "input" }
sources = ["src"]

[[commands.subcommand.task]]
id = "test"
label = "Debug package tests"
fields = ["package", "build_flags"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["package"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["output", "build_flags", "headless", "listen", "wd"]

[[commands.subcommand]]
path = ["exec"]
label = "Debug a binary"

[[commands.subcommand.source]]
id = "src"
kind = "help"
url = "https://github.com/go-delve/delve/blob/master/Documentation/usage/dlv_exec.md"
evidence = """
dlv exec <path/to/binary> [flags]
      --continue     Continue the debugged process on start.
      --headless                         Run debug server only, in headless mode. Server will accept both JSON-RPC or DAP client connections.
  -l, --listen string                    Debugging server listen address. Prefix with 'unix:' to use a unix domain socket. (default "127.0.0.1:0")
      --wd string                        Working directory for running the program.
"""

[[commands.subcommand.field]]
id = "binary"
label = "Binary"
type = "path"
position = 0
path = { kind = "file", role = "input" }
sources = ["src"]

[[commands.subcommand.field]]
id = "continue"
label = "Continue on start"
type = "boolean"
option = ["--continue"]
sources = ["src"]

[[commands.subcommand.field]]
id = "headless"
label = "Headless server"
description = "Run the debug server only, without a terminal client."
type = "boolean"
option = ["--headless"]
sources = ["src"]

[[commands.subcommand.field]]
id = "listen"
label = "Listen address"
type = "string"
option = ["--listen", "-l"]
sources = ["src"]

[[commands.subcommand.field]]
id = "wd"
label = "Working directory"
type = "path"
option = ["--wd"]
path = { kind = "directory", role = "input" }
sources = ["src"]

[[commands.subcommand.task]]
id = "exec"
label = "Debug a binary"
fields = ["binary", "continue"]
required = ["binary"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["binary", "continue"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["headless", "listen", "wd"]