debugger-cli 0.1.3

LLM-friendly debugger CLI using the Debug Adapter Protocol
Documentation 
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

# Complex Variable Verification Test
# Tests local variable inspection and type checking

name: "Complex Variable Verification"
description: "Verifies local variables, types, and expression evaluation"

# Compile the test program
setup:
  - shell: "gcc -g tests/fixtures/simple.c -o tests/fixtures/test_simple_c"

# Debug target configuration
target:
  program: "../fixtures/test_simple_c"
  args: []
  stop_on_entry: true

# Test steps
steps:
  # 1. Set a breakpoint
  - action: command
    command: "break main"
    expect:
      success: true

  # 2. Continue to breakpoint
  - action: command
    command: "continue"

  # 3. Wait for stop
  - action: await
    timeout: 10
    expect:
      reason: "breakpoint"
      file: "simple.c"

  # 4. Step to initialize variables
  - action: command
    command: "next"

  - action: await
    timeout: 10

  - action: command
    command: "next"

  - action: await
    timeout: 10

  - action: command
    command: "next"

  - action: await
    timeout: 10

  # 5. Inspect local variables
  - action: inspect_locals
    asserts:
      - name: "x"
        type: "int"
      - name: "y"
        type: "int"

  # 6. Evaluate an expression
  - action: evaluate
    expression: "x + y"
    expect:
      result_contains: ""  # Just verify it evaluates without error

  # 7. Check stack
  - action: inspect_stack
    asserts:
      - index: 0
        function: "main"
        file: "simple.c"

  # 8. Continue to exit
  - action: command
    command: "continue"

  - action: await
    timeout: 10
    expect:
      reason: "exited"