File: adding-debug-server.md

package info (click to toggle)
dap-mode 0.8-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 7,556 kB
  • sloc: lisp: 6,299; makefile: 31; java: 27; xml: 23
file content (32 lines) | stat: -rw-r--r-- 1,145 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# Extending DAP with new Debug servers

There are two methods that are used for registering remote extensions:

  - `dap-register-debug-provider` - register a method to call for
    populating startup parameters. It should either populate
    `:debugPort` and `:host` in case of TCP Debug Adapter Server or
    `:dap-server-path` when STD out must be used for Debug Adapter
    Server communication.
  - `dap-register-debug-template` register a debug template which will
    be available when `dap-debug` is called. The debug template must
    specify `:type` key which will be used to determine the provider to
    be called to populate missing fields.

Example

For full example you may check `dap-java.el`.

``` elisp
(dap-register-debug-provider
 "programming-language-name"
 (lambda (conf)
   (plist-put conf :debugPort 1234)
   (plist-put conf :host "localhost")
   conf))

(dap-register-debug-template "Example Configuration"
                             (list :type "java"
                                   :request "launch"
                                   :args ""
                                   :name "Run Configuration"))
```