Metadata-Version: 2.4
Name: powertrace
Version: 0.1.5
Summary: Detailed stack trace logging and visualization
Author-email: Quinten Roets <qdr2104@columbia.edu>
License-Expression: MIT
Project-URL: Source Code, https://github.com/quintenroets/powertrace
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: package-utils[context]<1,>=0.6.6
Requires-Dist: powercli<1,>=0.3.1
Requires-Dist: rich<15,>=13.7.1
Requires-Dist: superpathlib<3,>=2.0.4
Provides-Extra: dev
Requires-Dist: package-dev-tools<1,>=0.7.1; extra == "dev"
Requires-Dist: package-dev-utils<1,>=0.1.6; extra == "dev"
Requires-Dist: pexpect<5,>=4.9.0; extra == "dev"
Dynamic: license-file

# Powertrace
[![PyPI version](https://badge.fury.io/py/powertrace.svg)](https://badge.fury.io/py/powertrace)
![PyPI downloads](https://img.shields.io/pypi/dm/powertrace)
![Python version](https://img.shields.io/badge/python-3.10+-brightgreen)
![Operating system](https://img.shields.io/badge/os-linux%20%7c%20macOS-brightgreen)
![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen)

Detailed stack trace logging and visualization:
* Rich traceback visualization
* Also works for headless scripts
* Stacktrace logging
* Easily reproducible visualization

![example](https://github.com/quintenroets/powertrace/blob/main/assets/examples/visualization.png?raw=true)

## Usage

Run
```python
import powertrace

powertrace.visualize_traceback()
```
To visualize the current traceback.

Run
```python
import powertrace

powertrace.install_traceback_hooks()
```
In the beginning of your script to enable advanced traceback handling.

## Installation
```shell
pip install powertrace
```

or

```shell
pip install powertrace-hooks
```
Installing powertrace-hooks enables advanced traceback handling in all scripts without requiring the traceback hooks to be installed at the start.
