TakeV/spacemacs
Archived
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/layers/+tools/dap/README.org
Maximilian Wolff 1fd90fc1dc
Update instructions for dap integration and update existing layers 
The previous way of adding dap to a layer did add the mode
unconditionally to `spacemacs--dap-supported-modes` causing
dap bindings to be added also when no lsp backend was used.
2020-05-16 23:40:38 +02:00

5.3 KiB
Raw Blame History

DAP layer

Description

Experimental integrated visual debugger using Debug Adapter Protocol.

Debug Adapter Protocol is a wire protocol for communication between client and Debug Server. It similar to the LSP but providers integration with debug server.

Features:

Fully featured IDE-like debugger providing:

  • Launch/Attach
  • Breakpoints
  • Exceptions
  • Pause & Continue
  • Step In/Out/Over
  • Callstacks
  • Threads
  • Multiple simultaneous debug sessions
  • Evaluating statements
  • Debug/Run configurations
  • Debug REPL

Layer installation

To use this configuration layer, add it to your ~/.spacemacs. You will need to add dap to the existing dotspacemacs-configuration-layers list in this file.

Configuration

DAP configuration in supported layers

By default dap layer registers global key binding defined under SPC d. If you want to have debug bindings under major mode leader you may do the following:

For instance the java layer:

  (defun java/pre-init-dap-mode ()
    (pcase (spacemacs//java-backend)
       (`lsp (add-to-list 'spacemacs--dap-supported-modes 'java-mode)))
    (add-hook 'java-mode-local-vars-hook #'spacemacs//java-setup-dap))

See the java layer for further example on how to setup dap-mode correctly

Variables

Variable name Default Description
dap-enable-mouse-support t Enable/disable mouse support

Key bindings

Declared prefixes

The following prefixes have been declared:

prefix name
SPC d debug
SPC d b breakpoints
SPC d d debugging
SPC d e eval
SPC d I inspect
SPC d w debug windows
SPC d S context switching
SPC d T toggles

Transient state

Most of the DAP functions can be easily repeated using the built-in DAP transient state which can be initiate with SPC m d ..

Key binding Description
SPC m d . debug transient state

Start/Stop

Key binding Description
SPC d A abandon all process
SPC d a abandon current session
SPC d d d start debugging
SPC d d e edit debug template
SPC d d l debug last configuration
SPC d d r debug recent configuration

Breakpoints

Key binding Description
SPC d b b toggle a breakpoint
SPC d b c change breakpoint condition
SPC d b l change breakpoint log condition
SPC d b h change breakpoint hit count
SPC d b a add a breakpoint
SPC d b d delete a breakpoint
SPC d b D clear all breakpoints
SPC d w b list breakpoints

Navigation

Key binding Description
SPC d c continue
SPC d i step in
SPC d o step out
SPC d s next step
SPC d r restart frame
SPC d S f switch frame
SPC d S s switch session
SPC d S t switch thread
SPC d w o goto output buffer if present
SPC d w s list sessions

Evaluation and REPL

Key binding Description
SPC d '_ Run debug REPL
SPC d e e eval
SPC d e r eval region
SPC d e t eval value at point

Inspection

Key binding Description
SPC d I i inspect
SPC d I r inspect region
SPC d I t inspect value at point
SPC d v inspect value at point
SPC d w l list local variables
SPC d T m toggle mouse support for value inspection

References