gdlv

README

Gdlv is a graphical frontend to Delve for Linux, Windows and macOS.

Demo video here.

Setup

First install the current version of Delve, following Delve's install instructions.

Once Delve is installed, clone the repository and use go install to install gdlv:

$ git clone https://github.com/aarzilli/gdlv
$ cd gdlv
$ go install

If you are on Go 1.16 or later you can also use the new global install command, without cloning the repository first:

$ go install github.com/aarzilli/gdlv@latest

Use Ctrl+plus and Ctrl+minus, or config zoom 1.5 to change font size. See help for a list of available commands.

Other backends

On Linux and Windows gdlv uses shiny to draw its window and receive mouse and keyboard input from the Operating System. On macOS gio is used instead. This behavior can be changed using build tags:

go install -tags=nucular_gio github.com/aarzilli/gdlv@latest

will force gdlv to use nucular_gio everywhere, conversely -tags=nucular_shiny will select the shiny backend on macOS. Additionally, on macOS, -tags=nucular_shiny,metal can be used to make shiny draw using the metal API.

News

2024-09-24 / Version 1.13

• Added way to see captured variables inside function closures

2024-03-04 / Version 1.12

• Function names in the stacktrace window is shortened by default
• Add next-instruction command
• Make the text in the variables window selectable
• Miscellaneous bug fixes

2023-09-24 / Version 1.11

• Better display of suspended breakpoints
• Add libraries command
• When printing a channel also print a list of goroutines waiting on it

2023-06-13 / Version 1.10

• Better display of long string variables in the variables window
• Added formatting directives to print command and variables window (see help print)
• Support multi-target debugging where Delve supports it
• Miscellaneous bug fixes

2023-01-05 / Version 1.9

• Show an indicator when the current frame changes between continues
• Miscellaneous bug fixes

2022-05-13 / Version 1.8

• Extended type shortening rules to support simple generic types
• Miscellaneous bug fixes

2021-09-23 / Version 1.7

• Add watchpoint support
• Add Go doc menu item, in the variables panel contextual menu, to quickly call go doc for a variable's type
• Add hit count conditions for breakpoints
• Add call command
• Add goroutines filtering rules

2021-04-09 / Version 1.6

• Print goroutine wait wait reason and wait time when available
• Add dump command, creates core dump of the attached process

2021-01-10 / Version 1.5

• Better disassembly view
• File descriptor redirects
• Miscellaneous bug fixes

2020-04-25 / Version 1.4

• Support reverse step/next/stepout
• Support logical breakpoints
• Fixes copying from scrollback editor
• Fixes listing recentering on current line after a target resume

2020-03-27 / Version 1.3

• Show goroutine labels
• Support interrupting a recording

2020-01-28 / Version 1.2

• Highlight changed variables in a different color
• Add source code links in scrollback

2019-11-22 / Version 1.1

• Added option to filter the goroutines window to only the goroutines matching a specified pattern.
• Added -r option to the restart command which will rerecord the target (if it was recorded), also added the flaky script which runs the program repeatedly (rerecording it) until it hits any breakpoint.
• Added -tags command line option to specify build tags for the target program.

2019-10-22 / Version 1.0 tagged

2019-06-07

• Added Starlark as a scripting language

2019-05-11

• Start from main.main instead of runtime.main.
• Better interface when concurrent breakpoints happen during next, step or stepout.

2018-12-14

• Deferred calls view.
• Limit number of goroutines that are loaded (improves performance when debugging programs with tens of thousands of goroutines while the goroutines window is opened).
• Make pastel theme the default theme.
• Fixed bug handling disabled breakpoints.

2018-11-23

• Fix build on go1.9
• New, extended, syntax for pinning expressions dp @f/somefunc/ a will evaluate a in the first frame calling somefunc.

2018-10-29

• Pastel theme

2018-09-26

• Breakpoint persistence
• pretty printing of time.Time variables
• Notification for truncated stack traces
• Ability to have an expression's value printed to the command window every time a continue command completes.

2018-08-26

• Fixed some race conditions
• Redesigned detail views, they are now updated while stepping through the code

2018-08-16

• Highlight variable names
• Expose starting location of goroutines
• Miscellaneous bug fixes

2018-07-02

• Support font changes
• Sort variables by declaration line
• Miscellaneous bug fixes

2018-06-13

• Print return values when stepping out of a function
• Allow setting breakpoints after the program has exited

2018-05-21

• Implemented path substitution rules

2018-02-12

• Implemented "Continue to line"
• Let restart change program arguments
• Made load parameters configurable

2017-12-20

• Support for upcoming go 1.10.
• Changed how split windows are implemented (floating windows with docking).

2017-09-17

• "Find Element" command: search through a slice or an array for the element matching a given expression.
• New red theme.
• Only recompile if one of the source files changed.
• step -last command option to step into the last call on the line.
• Search command history with Ctrl+R

2017-06-29

• Pinning of expressions to specific execution frames.
• Keybindings for continue, next, step and stepout
• Compact visualization for interface values

2017-06-04

• Custom formatters for user defined types.
• Better executable building for go1.9

2017-05-18

• Better formatting for maps and integer variables.

2017-05-07

• Added core command
• Support for multiple backends
• Added "replay" startup command, "checkpoint" command and "Checkpoints" view.

2017-03-01

• Horizontal scrollbars for all panels

2017-02-09

• Goroutines panel will show a breakpoint icon for goroutines stopped at a breakpoint.

2017-02-06

• Implemented selective step into. Right click on a function call on the current line to step into that function call (note: not that function, that function call). Also accessible through the step command with step -list: