Metadata-Version: 2.4
Name: pytest-pudb-resurrected
Version: 0.1.0
Summary: Pytest PuDB debugger integration
Project-URL: Homepage, https://github.com/sander76/pytest-pudb-resurrected
Project-URL: Repository, https://github.com/sander76/pytest-pudb-resurrected.git
Project-URL: Changelog, https://github.com/sander76/pytest-pudb-resurrected/blob/main/HISTORY.rst
Project-URL: Bug Tracker, https://github.com/sander76/pytest-pudb-resurrected/issues
Author: Sander Teunissen
Author-email: Michael Elovskikh <wronglink@gmail.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Pytest
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.8
Requires-Dist: pudb
Requires-Dist: pytest>=7.0
Provides-Extra: dev
Requires-Dist: nox; extra == 'dev'
Requires-Dist: pexpect; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Description-Content-Type: text/markdown

# pytest-pudb-resurrected

[![CI Status](https://github.com/sander76/pytest-pudb-resurrected/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/sander76/pytest-pudb-resurrected/actions/workflows/ci.yml)

Pytest PuDB debugger integration based on pytest [PDB integration](https://docs.pytest.org/en/stable/how-to/failures.html#using-pdb-with-pytest).

This is a maintained fork of the original [pytest-pudb](https://github.com/wronglink/pytest-pudb) project.

## Installation

```bash
pip install pytest-pudb-resurrected
```

Or with uv:

```bash
uv add pytest-pudb-resurrected
```

## Usage

Start the debugger on test failures with `--pudb` (or `--db`):

```bash
pytest --pudb
pytest --db    # shortcut
```

Start the debugger at the beginning of each test with `--pudb-trace` (or `--dbt`):

```bash
pytest --pudb-trace
pytest --dbt   # shortcut
```

Or set breakpoints directly in your code with `pudb.set_trace()`:

```python
def test_set_trace_integration():
    # No --capture=no needed
    import pudb
    pudb.set_trace()
    assert 1 == 2

def test_pudb_b_integration():
    # No --capture=no needed
    import pudb.b
    # breakpoint is set here
    assert 1 == 2
```

## See Also

- [pytest](https://pypi.org/project/pytest/)
- [pudb](https://pypi.org/project/pudb/)
