⚠️ This project has migrated to Codeberg.

Pesticide

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

Installation

Install Go and run

go install github.com/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