Metadata-Version: 2.1
Name: sharetrace
License: MIT
Description-Content-Type: text/markdown
Summary: Capture and share detailed traceback information
Project-URL: Issues, https://github.com/RyanDraves/sharetrace/issues
Project-URL: Repository, https://github.com/RyanDraves/sharetrace
Requires-Python: >=3.10
Requires-Dist: inquirerpy<1,>=0.3.4
Requires-Dist: jinja2<4,>=3.1.0
Requires-Dist: marshmallow-dataclass<9,>=8.7.1
Requires-Dist: pygments<3,>=2.16.0
Requires-Dist: rich<14,>=13.9.4
Requires-Dist: rich-click<2,>=1.8.3
Version: 1.0.0

# Sharetrace
A Python library & CLI for capturing and sharing comprehensive traceback information.

## Overview

Sharetrace makes it easier to share Python exceptions and tracebacks with others by capturing:

- Full exception details (type, message, traceback)
- Code context around each frame in the stack trace
- Git repository information (if available)
- System information (Python version, platform, etc.)
- Local variable values at each frame

All this information is saved to a cache directory as JSON files that can later be used to generate shareable HTML reports.

## Usage

### Capture Traceback Information

```python
import sharetrace

# Install the exception hook (call this early in your program)
sharetrace.install_exception_hook()

# Now any unhandled exceptions will be captured automatically
raise ValueError("This will be captured!")
```

### Generate Shareable HTML Pages

Just invoke the interactive CLI!

```bash
sharetrace [--open-browser]
```

## Examples

A demo traceback can be created with `sharetrace_demo` and visualized with `sharetrace`.

## Notes

- `KeyboardInterrupt` and `SystemExit` are not captured (they use the default handler)
- If the capture process fails, the original exception is still displayed

