Metadata-Version: 2.4
Name: hearback
Version: 0.1.0
Summary: Listener-side output re-validation decorator against schema/predicate.
Project-URL: Homepage, https://github.com/coldbricks/hearback
Project-URL: Repository, https://github.com/coldbricks/hearback
Project-URL: Issues, https://github.com/coldbricks/hearback/issues
Author-email: Coldbricks <coldbricks@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: decorator,output,predicate,schema,validation
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# 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

```bash
pip install hearback
```

## Usage

```python
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 — coldbricks@gmail.com
