Metadata-Version: 2.1
Name: adhoc-pdb
Version: 0.1.2
Summary: A simple tool that allows you to debug your system whenever you want, with no overhead, even in production!
Home-page: https://github.com/yehonatanz/adhoc-pdb
Keywords: debug,pdb,production
Author: Yehonatan Zecharia
Author-email: yonti95@gmail.com
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Provides-Extra: cli
Requires-Dist: click (>=7.0.0,<8.0.0); extra == "cli"
Requires-Dist: remote-pdb (>=2.0,<3.0)
Requires-Dist: typing; python_version < "3"
Project-URL: Repository, https://github.com/yehonatanz/adhoc-pdb
Description-Content-Type: text/markdown

# adhoc-pdb
[![Build Status](https://travis-ci.org/yehonatanz/adhoc-pdb.svg?branch=master)](https://travis-ci.org/yehonatanz/adhoc-pdb)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![PyPI version](https://badge.fury.io/py/adhoc-pdb.svg)](https://pypi.org/project/adhoc-pdb/)

A simple tool that allows you to debug your system whenever you want, with no overhead, even in production!

### Install
`pip install adhoc-pdb` (or `pip install adhoc-pdb[cli]` to get a nice CLI)

For development, clone this repo and run `make`.

### Usage
In your code:
```python
import adhoc_pdb
adhoc_pdb.install()
```

Debug using adhoc-pdb cli:
```bash
adhoc-pdb <pid>
```
or using pure shell:
```bash
kill -SIGUSR1 <pid>
telnet localhost 9999
```

