package earlybird

All checked builds pass
  1. Overview
  2. Docs
OCaml debug adapter

Install

dune-project
 Dependency

Authors

Maintainers

Sources

earlybird-1.3.6.tbz
sha256=cc9abe42e6ee8b59f788fb59198125447ba14e68ab52317806bb3252fa11a6cc
sha512=04414670ce66d6d3433fb73737a0a3a04a64484a9b396037aff201c04f05be874ec04fe6b1d8cbf910959e2af6c3b2ace4aacb7479fbd714ec53d6e256f8d9e3

Description

Added to opam-repository:

README

OCaml earlybird

ci workflow status GitHub release status opam package status

OCaml debug adapter.

Installation

opam install earlybird

Usage

VS Code

See Debugging OCaml programs (experimental) in VSCode OCaml Platform README. This requires VSCode OCaml Platform 1.13 or newer.

Configuration

Field

Type

Default value

Description

program

string

(required)

The path of debuggee program.

arguments

string[]

[]

The command-line arguments for the debuggee program.

cwd

string

The working directory for debuggee program.

env

{[var: string]: string}

{}

Environment variables passed to the debuggee program.

stopOnEntry

boolean

false

Automatically stop after launch.

console

'internalConsole' \|
'integratedTerminal' \|
'externalTerminal'

internalConsole

Where to launch the debug target: internal console, integrated terminal, or external terminal.

followForkMode

'forkChild' \| 'forkParent'

forkParent

Set which process the debugger follows on fork.

source_dirs

string[]

[]

The path to search sources.

onlyDebugGlob

string

true

Only debug sources which match onlyDebugGlob.

yieldSteps

number

4096

Max steps to execute in batch. Debugger can not response other requests when executing steps in batch.

_debugLog

string

File to Log debug messages.

Troubleshooting

Breakpoints not hit with (lang dune 3.0) and above

Change to (lang dune 3.7) or above and add (map_workspace_root false) to your dune-project. See dune documentation for more information.

Examples

utop

Screen capture of debugging utop.

Launch configuration used:

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "test_program",
            "type": "ocaml.earlybird",
            "request": "launch",
            "stopOnEntry": true,
            "console": "integratedTerminal",
            "program": "${workspaceFolder}/_build/default/examples/interact/test_program.bc",
            "onlyDebugGlob": "<${workspaceFolder}/**/*>",
            "yieldSteps": 1024,
            "cwd": "${workspaceFolder}"
        }
    ]
}

Dependencies (20)

  1. dap >= "1.0.6" & < "1.1.0"
  2. lru >= "0.3.0"
  3. csexp >= "1.3.2"
  4. sexplib >= "v0.14.0"
  5. path_glob >= "0.2"
  6. fmt >= "0.8.9"
  7. logs >= "0.7.0"
  8. cmdliner >= "1.1.0"
  9. lwt_react >= "1.1.3"
  10. lwt_ppx >= "2.0.1"
  11. lwt >= "5.4.0"
  12. iter >= "1.2.1"
  13. ppx_optcomp >= "v0.11"
  14. ocaml-compiler-libs >= "v0.12.3"
  15. menhirLib >= "20201216"
  16. menhir >= "20201216" & build
  17. ppx_deriving_yojson >= "3.6.1"
  18. ppx_deriving >= "5.1"
  19. ocaml >= "4.12.0"
  20. dune >= "3.7"

Dev Dependencies (1)

  1. odoc with-doc

Optional Dependencies

None

Used by

None

Conflicts

None

Build status

Results of building earlybird with each compiler on check.ci.ocaml.org, run of against opam-repository 8d8d144. All results for this package.

Each result links to its build log. To keep crawlers from overloading the site, build logs require a GitHub sign-in (see ocurrent/opam-health-check). On your first log, GitHub asks you to “Authorize opam-health-check”, the OCurrent app that runs these checks; it sees only your public profile, not your repositories. The sign-in lasts 30 days.

Version OCaml 4.11 OCaml 4.14 OCaml 5.2 OCaml 5.4 OCaml 5.5
1.3.6 (this version) n/a good good good good
1.1.0 good n/a n/a n/a n/a
  • good Package successfully built
  • partial One of the dependencies failed to build
  • bad Package failed to build
  • n/a Package is not available in this environment
  • internal Internal failure