hearback 0.1.0

Listener-side output re-validation decorator against schema/predicate.

hearback

Listener-side counterpart to echo-confirmation: a decorator that re-validates function outputs against a schema or predicate before they leave the call boundary.

Install

pip install hearback

Usage

from hearback import hearback, HearbackError

@hearback(lambda n: isinstance(n, int) and n >= 0)
def absolute_delta(a, b):
    return abs(a - b)

assert absolute_delta(3, 10) == 7

@hearback(str)
def label(x):
    return x  # must be a str

assert label("ok") == "ok"
try:
    label(123)
except HearbackError:
    pass

Roadmap

This is an early 0.1.0 release with active development planned:

• JSON Schema / pydantic integration
• Async function support
• Structured advisory payloads on failure

Author

Coldbricks — [e-mail]