Skip to content

Make real API traces readable with expected and observed diagrams - #26

Merged
PerchAnton merged 2 commits into
mainfrom
interaction-check/readable-workflows
Oct 28, 2026
Merged

PerchAnton merged 2 commits into
mainfrom
interaction-check/readable-workflows

Conversation

@PerchAnton

Copy link
Copy Markdown
Owner

Property callback logs were hard to interpret without the adapter's semantics, and the purpose of an external replay was unclear. Add a focused python-dispatch walkthrough that distinguishes assignments, new callbacks, the cumulative log and the property value, with optional expected/observed Mermaid diagrams and plain tables. A deliberately wrong expectation demonstrates the first mismatch without alleging an upstream bug.

Explain the existing rat-salsa case through its five real method calls, the adapter/runtime cost, and rendering/focus/clipboard limits. Keep ordinary native tests as the first choice and link the existing pyee #228 rather than duplicate it. Runner code, protocol and runtime dependencies are unchanged; these are current-source examples, not a new release.

Validation: 54 unit tests pass from both checkout and unpacked sdist; 3 native tests and 5 replay steps run against python-dispatch 0.2.3; wrong expectation fails at step 2; generated reports/source hashes checked; wheel/sdist pass strict metadata checks and a clean offline wheel installation. CI reruns the example and checks recorded diagrams.

@PerchAnton
PerchAnton merged commit 077f259 into main Oct 28, 2026
20 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant