readback 0.1.0

Validation via echo-confirmation: readback(value, confirm_fn).

readback

Validation via echo-confirmation. Send a value, read it back through a confirm function, and fail closed on mismatch — the classic command-then-verify pattern used in safety and control systems.

Install

pip install readback

Usage

from readback import readback, ReadbackError

sent = {"motor": "arm", "rpm": 1200}
confirmed = readback(sent, confirm_fn=lambda: {"motor": "arm", "rpm": 1200})
assert confirmed == sent

try:
    readback(sent, confirm_fn=lambda: {"motor": "arm", "rpm": 0})
except ReadbackError as e:
    assert e.expected == sent
    assert e.got["rpm"] == 0

Roadmap

This is an early 0.1.0 release with active development planned:

• Tolerance / partial-match policies
• Async confirm functions
• Structured logging of mismatch traces

Author

Coldbricks — [e-mail]