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.v -other-argument

       See also: 'go help testflag'.

OPTIONS

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

       --output="debug.test"      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.

       --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)