Metadata-Version: 2.4
Name: liveprobe
Version: 0.2.0
Summary: Zero-dependency runtime agent for LiveProbe
Author: LiveProbe contributors
License-Expression: MIT
Project-URL: Homepage, https://github.com/mohammed2945/LiveProbe
Project-URL: Repository, https://github.com/mohammed2945/LiveProbe
Keywords: debugging,observability,liveprobe
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Typing :: Typed
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Dynamic: license-file

# liveprobe

Python 3.12+ runtime agent for LiveProbe using `sys.monitoring`.

```python
import liveprobe

agent = liveprobe.start(
    service_id="billing",
    broker_url="http://127.0.0.1:7070",
    api_key="dev-key",
    commit_sha="abcdef1234567890",
)
```

`commit_sha` is required unless `LIVEPROBE_COMMIT_SHA` or `GIT_COMMIT` is set.
`api_key` defaults to `LIVEPROBE_API_KEY`.

The agent supports `debug`, `info`, `warn`, and `error` log events,
broker-compiled safe expressions for conditions, watches, logs, and metrics,
and optional bounded locals on selected stack frames. Expressions read only
captured dictionaries/sequences; they cannot call Python code, inspect
attributes, or mutate application state. All expression and frame-local output
uses the configured serializer limits and redaction policy.
Numeric expressions use finite IEEE-754 values and reject integer inputs or
results outside the safe integer range so behavior is identical across SDKs.
