earlybird

OCaml debug adapter
README

ocamlearlybird is a debug adapter purely written in OCaml. See debug adapter protocol to get more information.

Installation

ocamlearlybird can be installed with opam:

opam install earlybird

To use ocamlearlybird in VS Code. Install the extension

Features

  • [x] Auto discover sources heuristically

  • [x] Line breakpoints and column breakpoints

  • [x] Basic next, step in, step out and continue commands

  • [x] Inspect stack frames, local variables, closure variables and global variables

  • [ ] Function breakpoints

  • [ ] Limited expression evaluation

  • [ ] Conditional breakpoints

  • [ ] Time travel

Documentation

By default ocamlearlybird use stdin and stdout for debug adapter protocol. To launch ocamlearlybird as debug adapter in server mode:

ocamlearlybird --server --port=4711

Example launch configuration

{
  "name": "Debug",
  "type": "ocaml-debugger",
  "request": "launch",
  "program": "${workspaceRoot}/_build/default/main.bc",
  "console": "internalConsole",
  "dotMerlins": ["${workspaceRoot}/.merlin"],
  "noDebug": false,
  "stopOnEntry": false,
  "env": {
    "OCAMLRUNPARAM": "b"
  }
}
Install
Sources
earlybird-0.1.4.tbz
md5=c5bfd3bde1c1e8b5f8ae69c485d3ea90
Dependencies
Reverse Dependencies