Metadata-Version: 2.4
Name: pdbcolor
Version: 0.2.2
Summary: A simple package to add code highlighting to the python debugger (PDB).
Project-URL: Homepage, https://github.com/Alex-JG3/pdbcolor
Project-URL: Issues, https://github.com/Alex-JG3/pdbcolor/issues
Author: Alex Gregory
License-Expression: MIT
License-File: LICENSE
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Requires-Dist: pygments
Provides-Extra: dev
Requires-Dist: ruff; extra == 'dev'
Description-Content-Type: text/markdown

# PDB Color

Add some color to the python debugger.

## Installation

Install with `pip`.

```shell
pip install pdbcolor
```

## Setup

Python can be configured to use PDB Color by changing the `PYTHONBREAKPOINT`
environment variable. To use PDB Color temporarily, add the 
`PYTHONBREAKPOINT=pdbcolor.set_trace` prefix before running your python script:

```shell
PYTHONBREAKPOINT=pdbcolor.set_trace python3 main.py
```

To make PDB Color the default for all Python sessions, set the
`PYTHONBREAKPOINT` environment variable to `pdbcolor.set_trace`. On Mac and
Linux, you can do this with the `export` command:

```shell
export PYTHONBREAKPOINT=pdbcolor.set_trace
```

Add this line to your terminal configuration file (e.g. `.bashrc` or `.zshrc`)
to ensure the setting persists across terminal settings.

## Usage

PDB Color is a drop-in replacement for PDB that simply adds color to PDB's
outputs. See the [PDB documentation](https://docs.python.org/3/library/pdb.html)
for a PDB introduction.

## Examples

Using PDB:

![Code example using PDB](images/before.png)

Using PDB Color:

![Code example using PDB](images/after.png)
