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
History
Ivan Yonchovski 8fe8f76cd6 [dap] Provide global keybindings for dap-mode 
- added the same bindings you normally have under `SPC m d` under `SPC d`
similar to what Debug layer does. Most of the dap-bindings are not content
sensitive(e. g. rerun last debug session) and it doesn't make sense to restrict
them only to particular major modes.
- Moved `spacemacs/browse-docs-online-at-point` from `SPC d b` to `SPC h b d` to
avoid collisions.
2020-04-16 21:52:18 +02:00
..
config.el Fix filenames in layer file headers 2020-02-20 00:07:30 +01:00
layers.el [core] Fix layer dependencies based on layer variables 2019-09-30 02:00:48 -04:00
packages.el [dap] Provide global keybindings for dap-mode 2020-04-16 21:52:18 +02:00
README.org [dap] Provide global keybindings for dap-mode 2020-04-16 21:52:18 +02:00

README.org

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 keybinding defined under SPC m. 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 ()
    (add-to-list 'spacemacs--dap-supported-modes 'java-mode))

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

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 launching
SPC d e eval
SPC d I inspect
SPC d l 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