pyramid-debugtoolbar

What it is and what it does

Pyramid_debugtoolbar is a development-time debugging extension for Pyramid web applications that injects an interactive toolbar into HTML responses. It displays detailed information about each HTTP request, including route matching, request variables, response headers, SQL queries (with timing), logging output, and performance metrics. The toolbar is modeled after similar tools in Flask and Django ecosystems and includes a Werkzeug-derived interactive debugger for exception inspection.

The package depends on Pyramid, pyramid-mako for templating, Pygments for syntax highlighting, and importlib-metadata for compatibility. It's designed to be included in your Pyramid configuration during development and disabled in production. Recent versions added session tracking, improved SQLAlchemy 2.x support, and fixed issues with long-running requests and sensitive request attribute access.

Use it for:

• Inspect HTTP request/response details and route matching during Pyramid app development without adding print statements.
• Profile SQL query execution and timing to identify N+1 queries and database bottlenecks in your application.
• Track session and cookie changes across a request lifecycle to debug authentication and state management issues.
• View application logs and their severity levels inline with request context to correlate errors with specific requests.
• Interactively debug exceptions with a Werkzeug-powered debugger showing stack traces and local variable inspection.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Pyramid_debugtoolbar injects an interactive HTML debug toolbar into your Pyramid web application during development, showing request details, SQL queries, logging, and performance metrics.

Yes, if you are actively developing a Pyramid application. The toolbar is a standard development utility that provides real-time visibility into request handling, database queries, and logging. Install it as a development dependency only; dormant maintenance is not a concern for a stable, mature tool used only during development. No known vulnerabilities.

Install

pyramid-debugtoolbar on PyPI

pip install pyramid-debugtoolbar

uv add pyramid-debugtoolbar

poetry add pyramid-debugtoolbar

Installing pyramid-debugtoolbar

Before you install

Low install friction with a pure-Python wheel. Dormant maintenance status (921 days since last release) but no recent vulnerabilities; last release was 2024-02-05 and supports current Python versions through 3.12.

License in practice

BSD license (permissive); you can use, modify, and distribute this package freely in commercial and open-source projects with minimal restrictions.

Quickstart

pip install pyramid-debugtoolbar

In your Pyramid app configuration:
from pyramid.config import Configurator
config = Configurator()
config.include('pyramid_debugtoolbar')
app = config.make_wsgi_app()

Requires Pyramid application; toolbar only functions in development mode and injects HTML into responses.

Verify before relying

• Whether dormant maintenance status affects compatibility with future Pyramid releases beyond 3.12.
• Performance overhead of toolbar injection on large response bodies or high-traffic development servers.

Package facts

Evidence: pyramid_debugtoolbar-4.12.1-py3-none-any.whl

Keywords: wsgi, pylons, pyramid, transaction

Tags

More WSGI packages