pyramid_debugtoolbar

pyramid_debugtoolbar provides a debug toolbar useful while you're developing your Pyramid application.

Note that pyramid_debugtoolbar is a blatant rip-off of Michael van Tellingen's flask-debugtoolbar (which itself was derived from Rob Hudson's django-debugtoolbar). It also includes a lightly sanded down version of the Werkzeug debugger code by Armin Ronacher and team.

Documentation

The documentation of the current stable release of pyramid_debugtoolbar is available at https://docs.pylonsproject.org/projects/pyramid-debugtoolbar/en/latest/.

Demonstration

For a demonstration:

Clone the pyramid_debugtoolbar trunk.

$ git clone https://github.com/Pylons/pyramid_debugtoolbar.git

Create a virtual environment in the workspace.

$ cd pyramid_debugtoolbar
$ python3 -m venv env

Install the pyramid_debugtoolbar trunk into the virtualenv.
```
$ env/bin/pip install -e .
```
Install the pyramid_debugtoolbar/demo package into the virtualenv.
```
$ env/bin/pip install -e demo
```
Run the pyramid_debugtoolbar package's demo/demo.py file using the virtual environment's Python.
```
$ env/bin/python demo/demo.py
```

Visit http://localhost:8080 in a web browser to see a page full of test options.

Testing

If you have tox installed, run all tests with:

$ tox

To run only a specific Python environment:

$ tox -e py311

If you don't have tox installed, you can install the testing requirements, then run the tests.

$ python3 -m venv env
$ env/bin/pip install -e ".[testing]"
$ env/bin/py.test

Building documentation

If you have tox installed, build the docs with:

$ tox -e docs

If you don't have tox installed, you can install the requirements to build the docs, then build them.

$ env/bin/pip install -e ".[docs]"
$ cd docs
$ make clean html SPHINXBUILD=../env/bin/sphinx-build