Metadata-Version: 2.4
Name: tracelink
Version: 0.2.0
Summary: Full-stack cross-end debug tracer — NDJSON + readable, scope-filtered, AI-friendly
Author-email: qinquan-ai <qin16778@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/qinquan/tracelink
Project-URL: Documentation, https://github.com/qinquan/tracelink#readme
Project-URL: Issues, https://github.com/qinquan/tracelink/issues
Project-URL: Changelog, https://github.com/qinquan/tracelink/blob/main/CHANGELOG.md
Keywords: tracing,debug,logging,ndjson,skill,ai-agent,scope,fastapi,starlette
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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 :: Libraries :: Python Modules
Classifier: Topic :: System :: Logging
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Provides-Extra: fastapi
Requires-Dist: starlette>=0.27; extra == "fastapi"
Provides-Extra: dev
Requires-Dist: pytest>=7.4; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.7; extra == "dev"

# tracelink

Full-stack cross-end debug tracer — NDJSON + readable, scope-filtered, AI-friendly.

## Install

```bash
pip install tracelink
```

With FastAPI/Starlette support:

```bash
pip install tracelink[fastapi]
```

## Quick Start

```python
from tracelink import debug_tracer

debug_tracer.start_scope('delete-work')
debug_tracer.entry('router.py:delete', 'user clicked delete', {'user_id': 123}, scope='delete-work')
debug_tracer.end_scope('delete-work')
```

## Features

- **Scope-filtered**: group related log entries by scope name
- **AI-friendly NDJSON**: each entry is one JSON line, easy for AI agents to parse
- **Zero dependencies**: core uses only Python stdlib
- **FastAPI/Starlette middleware**: plug-and-play HTTP middleware
- **Dashboard**: built-in web UI to browse traces

## CLI

```bash
tracelink --port 8080
```

## Links

- [Homepage](https://github.com/qinquan/tracelink)
- [Documentation](https://github.com/qinquan/tracelink#readme)
- [Issues](https://github.com/qinquan/tracelink/issues)
