NAME¶

dlv-test - Compile test binary and begin debugging program.

SYNOPSIS¶

dlv test [package] [flags]

DESCRIPTION¶

Compiles a test binary with optimizations disabled and begins a new debug session.

The test command allows you to begin a new debug session in the context of your unit tests. By default Delve will debug the tests in the current directory. Alternatively you can specify a package name, and Delve will debug the tests in that package instead. Double-dashes -- can be used to pass arguments to the test program:

dlv test [package] -- -test.run TestSomething -test.v -other-argument

See also: 'go help testflag'.

OPTIONS¶

-h, --help[=false] help for test

--output="" Output path for the binary.

OPTIONS INHERITED FROM PARENT COMMANDS¶

--accept-multiclient[=false] Allows a headless server to accept multiple client connections via JSON-RPC or DAP.

--allow-non-terminal-interactive[=false] Allows interactive sessions of Delve that don't have a terminal as stdin, stdout and stderr

--api-version=1 Selects JSON-RPC API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md.

--backend="default" Backend selection (see 'dlv help backend').

--build-flags="" Build flags, to be passed to the compiler. For example: --build-flags="-tags=integration -mod=vendor -cover -v"

--check-go-version[=true] Exits if the version of Go in use is not compatible (too old or too new) with the version of Delve.

--disable-aslr[=false] Disables address space randomization

--headless[=false] Run debug server only, in headless mode. Server will accept both JSON-RPC or DAP client connections.

--init="" Init file, executed by the terminal client.

-l, --listen="127.0.0.1:0" Debugging server listen address. Prefix with 'unix:' to use a unix domain socket.

--log[=false] Enable debugging server logging.

--log-dest="" Writes logs to the specified file or file descriptor (see 'dlv help log').

--log-output="" Comma separated list of components that should produce debug output (see 'dlv help log')

--only-same-user[=true] Only connections from the same user that started this instance of Delve are allowed to connect.

-r, --redirect=[] Specifies redirect rules for target process (see 'dlv help redirect')

--wd="" Working directory for running the program.

SEE ALSO¶

dlv(1)