z_mirror/pesticide

git clone https://git.raiguard.me/z_mirror/pesticide

Caleb HeuerUpdate Go module for Codeberg388f8ba

trunk
branchestrunkall refs →
1.4 KiB58 linesraw

Pesticide

A command-line UI for debuggers based on the Debug Adapter Protocol.

Installation

Install Go and run

go install codeberg.org/raiguard/pesticide

This will install the pesticide executable into your go/bin directory.

Usage / configuration

Place a pesticide.json file in your project directory and specify your adapter configurations. The file is JSON formatted:

{
  "adapters": {
    "fmtk": {
      "cmd": "fmtk debug /home/rai/dev/factorio/1.1/bin/x64/factorio",
      "args": {
        "hookControl": [ "UltimateResearchQueue" ],
        "modsPath": "/home/rai/dev/factorio/1.1/mods"
      }
    },
    "mock": {
      "cmd": "mockserver",
      "addr": ":54321"
    }
  }
}
  • cmd: A command-line command to execute.
  • addr: An IP address to connect to. This can be used in combination with cmd.
  • args: Any adapter-specific arguments.

Launch the pesticide executable and it will source the configuration file. You can now run commands.

Current commands

The project is usable, but is far from complete. Please open an issue if there is a capability or command that you are missing!

  • backtrace
  • break <filename> <line>
  • finish
  • continue
  • down
  • evaluate <expression>
  • launch <adapter name>
  • next
  • pause
  • quit
  • step
  • up
1# Pesticide
2
3A command-line UI for debuggers based on the [Debug Adapter Protocol](https://microsoft.github.io/debug-adapter-protocol/).
4
5## Installation
6
7Install [Go](https://golang.org) and run
8
9```
10go install codeberg.org/raiguard/pesticide
11```
12
13This will install the `pesticide` executable into your `go/bin` directory.
14
15## Usage / configuration
16
17Place a `pesticide.json` file in your project directory and specify your adapter configurations. The file is JSON formatted:
18
19```json
20{
21  "adapters": {
22    "fmtk": {
23      "cmd": "fmtk debug /home/rai/dev/factorio/1.1/bin/x64/factorio",
24      "args": {
25        "hookControl": [ "UltimateResearchQueue" ],
26        "modsPath": "/home/rai/dev/factorio/1.1/mods"
27      }
28    },
29    "mock": {
30      "cmd": "mockserver",
31      "addr": ":54321"
32    }
33  }
34}
35```
36
37- `cmd`: A command-line command to execute.
38- `addr`: An IP address to connect to. This can be used in combination with `cmd`.
39- `args`: Any adapter-specific arguments.
40
41Launch the `pesticide` executable and it will source the configuration file. You can now run commands.
42
43### Current commands
44
45The project is usable, but is far from complete. Please open an issue if there is a capability or command that you are missing!
46
47- `backtrace`
48- `break <filename> <line>`
49- `finish`
50- `continue`
51- `down`
52- `evaluate <expression>`
53- `launch <adapter name>`
54- `next`
55- `pause`
56- `quit`
57- `step`
58- `up`