traceact 0.1.0__py3-none-any.whl

traceact-0.1.0.dist-info/METADATA

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: traceact
+Version: 0.1.0
+Summary: X-ray vision for your code. Lightweight action-level tracing for Python.
+Author: Mohammed Shehu
+License-Expression: MIT
+Project-URL: Homepage, https://mohammedshehu.com
+Project-URL: Repository, https://github.com/traceact/traceact
+Keywords: tracing,observability,debugging,devtools,ai-agents
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Dynamic: license-file
+
+# TraceAct
+
+X-ray vision for your code.
+
+TraceAct is a lightweight Python package for action-level tracing. It records the full story of what happens when a function runs — every step taken, every resource touched, every event recorded, and every failure encountered — so you can understand what actually happened without guessing.
+
+Built for AI coding agents and human developers alike.
+
+## Install
+
+```bash
+pip install traceact
+```
+
+Or from source:
+
+```bash
+pip install -e .
+```
+
+## Quick start
+
+```python
+from traceact import traced_action, configure, TraceConfig, JsonlSink
+
+configure(
+    config=TraceConfig(sink_mode="blocking"),
+    sinks=[JsonlSink("data/traces.jsonl")],
+)
+
+@traced_action(action="note.create", kind="app", actor="user")
+def create_note(title, body):
+    ...
+```
+
+## Manual tracing
+
+```python
+from traceact import ActionTrace
+
+with ActionTrace.start(action="note.create", kind="app") as trace:
+    trace.input({"title": "Hello"})
+    trace.step("Validated input")
+    trace.event(kind="db", operation="insert", target="notes")
+    trace.output({"note_id": "note_123"})
+```
+
+## Concepts
+
+| Concept | Meaning |
+|---|---|
+| `Trace` | The full story of one action |
+| `Step` | A human-readable timeline marker |
+| `Event` | A structured operation (db, http, file, model, etc.) |
+| `Touch` | A resource involved in the trace |
+| `Sink` | Where the trace is written |
+
+## Requirements
+
+Python 3.9+. No runtime dependencies.
+
+## License
+
+MIT
+
+---
+
+Built by [Mo Shehu](https://mohammedshehu.com).

traceact-0.1.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+traceact/__init__.py,sha256=sMq5qteI9idXvFF2yiISXwyOB8HbaQMmTr9_zPdfzLg,1362
+traceact/budget.py,sha256=fYcIZbiDk5QhZN5Dc2RAcJE5QKG1D0sk6I6HTHBG1P0,4249
+traceact/config.py,sha256=4IgTmBUB60crCW7gzlez1ShxTDW6xd5eEkdZILv4Tfc,8083
+traceact/context.py,sha256=2XM8PTc857Xhez9BJjCRfT3s_BmnhgymWArBPsI0yN4,4934
+traceact/decorators.py,sha256=mjcOWJ1MZGxafYQom4q9TbDioMRK-NAL0S6d7SnUSvc,15722
+traceact/helpers.py,sha256=aPTCayuzRwg6Oj4uuVTDzz4-fEjF-cmR1AmwyCDKDqM,4309
+traceact/ids.py,sha256=Pc6LwHQQwuLrPlKrYV933HGgjSUTi-j1Ulv_OKDLIrE,1994
+traceact/sinks.py,sha256=eUUm5t0NOhrn2bDkJMmwiEzToskv8a1JnaaDS0YQ32M,6354
+traceact/trace.py,sha256=vCGgywUtddsKNC26bNq1AiUlY4L8jYTEAUI576nLAGY,45954
+traceact-0.1.0.dist-info/licenses/LICENSE,sha256=76IWhiLn3BGteRUpqvBhZGru-yLseXQqKcOQA-zUh6g,1071
+traceact-0.1.0.dist-info/METADATA,sha256=x5HEn4_cjBclAX_GDiSSHjlQFZL608jBCcyJkHpEXw0,2527
+traceact-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+traceact-0.1.0.dist-info/top_level.txt,sha256=yHKwgc84AGGiGWWHvU-qE-DD5QKe8vn-Sb79QxFG1Ho,9
+traceact-0.1.0.dist-info/RECORD,,

traceact-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

traceact-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohammed Shehu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

traceact-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+traceact