shexjs / shex.js

75%

Build Type

push

github

Committed by Eric Prud'hommeaux

Commit Message

validation: constraint-level debug events (design doc phase 5)

Both regex engines take an optional debugHooks argument to compile();
onConstraint fires each time the engine (re)considers a
TripleConstraint -- in eval-threaded-nerr's matchTripleConstraint and
in eval-simple-1err's TripleConstraintState transition -- with the
focus node and the candidate triples.  ShExValidator forwards a new
debugHooks option to compile, so any caller can watch the match loop.

shex-debug steps into them: constraint events pause one level below
their enclosing shape (s descends to constraint granularity, n skips
back to shape granularity), b LINE now prefers the constraint on the
line (falling back to the enclosing shape), and bp PREDICATE breaks on
every constraint with that predicate; node breakpoints match constraint
focus nodes too.

DebugHooks-test covers both engines: per-constraint events with
focus/candidate payloads, nested-shape re-evaluation, and
results-identical-without-hooks; the REPL tests grow constraint
stepping, position-breakpoint-on-constraint, and bp.  5082 passing.

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

Coverage Stats

2461 of 3886 branches covered (63.33%)

Branch coverage included in aggregate %.

78 of 82 new or added lines in 3 files covered. (95.12%)

3 existing lines in 1 file now uncovered.

5628 of 6964 relevant lines covered (80.82%)

6397.85 hits per line