Metadata-Version: 2.3
Name: charming-traceback
Version: 0.1.6
Summary: Rich traceback adapted for PyCharm IDE by JetBrains
Author: Yevhen Bondarenko
Author-email: Yevhen Bondarenko <zekbond@gmail.com>
Requires-Dist: rich>=14.2.0
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# 🐍 Charming Traceback

[Rich][rich] [traceback][rich_traceback] adapted for [PyCharm IDE by JetBrains][pycharm].

### Differences from the original

- File paths are rendered in the format which allows PyCharm to automatically detect them as links.
- `suppress` argument accepts string module names in addition to paths and Python modules already supported by Rich's `Traceback`. 

## Installation

Add to your project with `uv`:

```bash
uv add charming_traceback
```

## Usage

To install as the default traceback handler:

```python
from charming_traceback import install

install(show_locals=True)
```

To print the exception traceback manually:

```python
from charming_traceback import Traceback

try:
    do_something()
except Exception as e:
    Traceback.print_exception(show_locals=True)
```

Essentially, `Traceback` class is designed to be a drop-in replacement for `Traceback` from Rich. You can refer to the official [Rich traceback documentation][rich_traceback] for more usage info.

[rich]: https://github.com/Textualize/rich
[rich_traceback]: https://rich.readthedocs.io/en/stable/traceback.html
[pycharm]: https://www.jetbrains.com/pycharm/
