Metadata-Version: 2.4
Name: buzzkill
Version: 0.1.0
Summary: Haptic/BLE emergency-stop helper: guaranteed shutdown callbacks.
Project-URL: Homepage, https://github.com/coldbricks/buzzkill
Project-URL: Repository, https://github.com/coldbricks/buzzkill
Project-URL: Issues, https://github.com/coldbricks/buzzkill/issues
Author-email: Coldbricks <coldbricks@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: ble,context-manager,emergency-stop,shutdown,signal
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

# buzzkill

Guaranteed emergency-stop helper for Python. Wrap critical sections so a
user-supplied shutdown callback always runs — on normal exit, on exception,
or on SIGINT. Planned roadmap includes BLE device registry and haptic
feedback for real hardware kill-switches.

## Install

```bash
pip install buzzkill
```

## Usage

```python
from buzzkill import EmergencyStop

stopped = []

def cut_power():
    stopped.append("power_cut")

with EmergencyStop(cut_power):
    # work that must never leave hardware/live state dangling
    pass

assert stopped == ["power_cut"]
```

## Roadmap

This is an early **0.1.0** release with active development planned:

- BLE device registry for pairing emergency-stop hardware
- Haptic / status feedback hooks
- Cross-platform signal coverage refinements

## Author

Coldbricks — coldbricks@gmail.com
