mq-dap 0.7.0 - Docs.rs

Debug Adapter Protocol implementation for mq.

Usage

Start the DAP server (typically done automatically by your editor):

# Start the DAP server
mq-dbg

# Debug a specific query file
mq-dbg query.mq input.md

Once connected to a DAP client:

Set Breakpoints: Click in the gutter or use your editor's breakpoint command
Conditional Breakpoints: Only stop when an mq expression evaluates truthy, e.g. x > 3
Hit Count Breakpoints: Only stop once the hit count condition is met. A bare number, e.g. 3, is shorthand for hit_count >= 3; otherwise it's evaluated as an mq expression with hit_count bound to the current hit count, e.g. hit_count >= 3 && x == 1
Logpoints: Log a message instead of stopping; uses mq's own ${expr} string interpolation syntax, e.g. x is ${x}. ${self} yields the current pipeline value and ${$VAR} reads the environment variable VAR
Start Debugging: Launch the debugger with your query file
Step Through Code: Use step over, step in, and step out commands
Inspect Variables: Hover over variables or view them in the variables pane
Watch Expressions: Add mq expressions to your editor's watch pane to re-evaluate them against the current scope every time execution stops
View Call Stack: See the current execution stack in the call stack pane

# Create a query file
echo '.h | let y = to_text() | breakpoint() | y' > query.mq

# Start debugging
mq-dbg query.mq input.md

git clone https://github.com/harehare/mq
cd mq
cargo build --release -p mq-dap

cargo test -p mq-dap

Licensed under the MIT License.