Golang delve: Difference between revisions
From wikinotes
No edit summary |
|||
(5 intermediate revisions by the same user not shown) | |||
Line 8: | Line 8: | ||
|- | |- | ||
| github || https://github.com/go-delve/delve | | github || https://github.com/go-delve/delve | ||
|- | |||
| command docs || https://github.com/go-delve/delve/blob/master/Documentation/cli/README.md | |||
|- | |||
| editor plugins || https://github.com/go-delve/delve/blob/master/Documentation/EditorIntegration.md | |||
|- | |- | ||
|} | |} | ||
</blockquote><!-- Documentation --> | </blockquote><!-- Documentation --> | ||
= Locations = | |||
<blockquote> | |||
{| class="wikitable" | |||
|- | |||
| <code>~/.config/dlv/config.yml</code> || config options | |||
|- | |||
|} | |||
</blockquote><!-- Locations --> | |||
= Install = | = Install = | ||
Line 18: | Line 31: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
</blockquote><!-- Install --> | </blockquote><!-- Install --> | ||
= Configuration = | |||
<blockquote> | |||
== Persistent == | |||
<blockquote> | |||
<syntaxhighlight lang="yaml"> | |||
# ~/.config/dlv/config.yml | |||
max-string-len: 1000 | |||
max-array-values: 1000 | |||
</syntaxhighlight> | |||
</blockquote><!-- Persistent --> | |||
== Dynamic == | |||
<blockquote> | |||
Within a delve session, you can modify debugger config values. | |||
<syntaxhighlight lang="bash"> | |||
config max-string-len 1000 | |||
</syntaxhighlight> | |||
</blockquote><!-- Dynamic --> | |||
</blockquote><!-- Configuration --> | |||
= Usage = | = Usage = | ||
Line 23: | Line 57: | ||
Delve builds your executable automatically with flags required for it to debug your program. | Delve builds your executable automatically with flags required for it to debug your program. | ||
== Start Delve == | |||
<blockquote> | |||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
# start debugger | # start debugger | ||
dlv debug [example.com/x/foo/package] [-- [--your-params]] | dlv debug [example.com/x/foo/package] [-- [--your-params]] # run program | ||
dlv test | |||
dlv test # run tests in PWD | |||
dlv test ./internal/foo # run local tests in dir | |||
dlv test example.com/x/foo/package # run package on GOPATH | |||
dlv test -- -test.run ^TestSanitizePath$ # run matching tests in PWD | |||
# useful test params: | |||
-test.run # regex test to match | |||
-test.v # verbose (print tests as run) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
</blockquote><!-- Start Delve --> | |||
== Breakpoint == | |||
<blockquote> | |||
You can add breakpoints in src, or interactively | |||
<syntaxhighlight lang="go"> | <syntaxhighlight lang="go"> | ||
runtime.Breakpoint() // delve breakpoint | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash"> | |||
b main.main # add breakpoint to 'main.go's 'main' method | b main.main # add breakpoint to 'main.go's 'main' method | ||
b main.go:10 # add breakpoint to 'main.go's line 10 | b main.go:10 # add breakpoint to 'main.go's line 10 | ||
</syntaxhighlight> | |||
</blockquote><!-- Breakpoint --> | |||
== Session == | |||
<blockquote> | |||
Add your breakpoints, then continue to execute your program | |||
<syntaxhighlight lang="go"> | |||
c # continue (start executing) | c # continue (start executing) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Line 45: | Line 103: | ||
<enter> # repeat last command | <enter> # repeat last command | ||
</syntaxhighlight> | </syntaxhighlight> | ||
</blockquote><!-- Session --> | |||
</blockquote><!-- Usage --> | </blockquote><!-- Usage --> |
Latest revision as of 01:15, 17 July 2022
delve is a go debugger.
It is more knowledgeable about the go runtime than golang gdb .
There are also editor integrations.
Documentation
Locations
~/.config/dlv/config.yml
config options
Install
go install github.com/go-delve/delve/cmd/dlv@latest
Configuration
Persistent
# ~/.config/dlv/config.yml max-string-len: 1000 max-array-values: 1000Dynamic
Within a delve session, you can modify debugger config values.
config max-string-len 1000
Usage
Delve builds your executable automatically with flags required for it to debug your program.
Start Delve
# start debugger dlv debug [example.com/x/foo/package] [-- [--your-params]] # run program dlv test # run tests in PWD dlv test ./internal/foo # run local tests in dir dlv test example.com/x/foo/package # run package on GOPATH dlv test -- -test.run ^TestSanitizePath$ # run matching tests in PWD # useful test params: -test.run # regex test to match -test.v # verbose (print tests as run)Breakpoint
You can add breakpoints in src, or interactively
runtime.Breakpoint() // delve breakpointb main.main # add breakpoint to 'main.go's 'main' method b main.go:10 # add breakpoint to 'main.go's line 10Session
Add your breakpoints, then continue to execute your program
c # continue (start executing)Inspect your program, learn
p yourVar # print var l # print location n # next line (enters loop, not skip to end) s # step into line <enter> # repeat last command