shexjs / shex.js / 29376363217

75%

Build Type

push

github

Committed by Eric Prud'hommeaux

Commit Message

debuggers: shexmap-debug and shex-debug CLIs (design doc phases 2 and 4-CLI)

Both REPLs suspend by blocking on stdin -- the prompt IS the pause, so
no worker is needed in a terminal.  I/O is injected, so the command
loops are unit-tested with scripted sessions; the bins add a
one-byte-at-a-time fs.readSync(0) line reader.

shexmap-debug (@shexjs/extension-map): drives MaterializerDebugger.
  -t target.shex (--val file | --bindings file) [-j vars] [-r root]
  (stdin is the command channel, so the validation output moves to
  --val).  Commands: s/n/o/c, b LINE[:COL] (via locate.exprAt),
  bp PREDICATE, bn NODE, info/l/h/q.  Pauses print the constraint's
  source line with a caret; completion prints the quad count and the
  never-bound/unused-static warnings.

shex-debug (@shexjs/cli): shape-level validation stepping over the
  validator's tracker (enter/exit/recurse events, depth-based
  into/over/out).  -x schema -d data -n node [-s shape] with
  shex-validate's resolution conventions (node against the data source,
  shape against the schema source).  Breakpoints: b LINE[:COL] (via
  locate.shapeAt), bs SHAPE, bn NODE (the lexical form of a focus node).
  q aborts via a DebugQuit throw.  Constraint-level granularity awaits
  the regex engines' debugHooks (design doc phase 5).

Shared: EditorServices.sourceExcerpt renders the gutter-numbered
source/caret display for both.  Relative IRIs in breakpoint arguments
resolve against the schema base.

Tests: 7 shexmap-debug REPL cases, 6 shex-debug REPL cases, CLI
integration entries for both harnesses; 5071 passing.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Coverage Stats

2438 of 3852 branches covered (63.29%)

Branch coverage included in aggregate %.

291 of 341 new or added lines in 5 files covered. (85.34%)

5484 of 6812 relevant lines covered (80.5%)

6539.59 hits per line