django-graphiql-debug-toolbar

What it is and what it does

This package adapts Django Debug Toolbar—a widely-used development tool that profiles database queries, HTTP headers, and request timing—to work inside the GraphiQL IDE for GraphQL queries. Instead of viewing debug output in a separate browser panel, you get profiling and inspection data directly within your GraphQL development environment.

It works by replacing the standard Django Debug Toolbar middleware with a GraphiQL-aware version that captures the same diagnostic information but surfaces it in the IDE. The package depends on Django, graphene-django, and django-debug-toolbar, so you need all three installed. Setup is minimal: add it to INSTALLED_APPS and swap the middleware class in your settings.

Use it for:

• Inspect database queries triggered by a GraphQL resolver without leaving the GraphiQL IDE.
• Profile response times and identify performance bottlenecks in GraphQL queries during development.
• Debug HTTP headers and middleware behavior for GraphQL requests in real time.
• Monitor memory usage and request metadata while testing GraphQL resolvers locally.

Worth the install?

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

Integrates Django Debug Toolbar into the GraphiQL IDE, providing performance profiling and debugging information directly within GraphQL query execution.

Yes, if you are actively developing a Django GraphQL API and want integrated debugging without context-switching. No, if your project uses Django or Python versions significantly newer than 2021, or if you rely on ongoing maintenance—the package is dormant and may not work with current tooling. Consider it for greenfield projects or teams committed to older Django LTS versions.

Install

django-graphiql-debug-toolbar on PyPI

pip install django-graphiql-debug-toolbar

uv add django-graphiql-debug-toolbar

poetry add django-graphiql-debug-toolbar

Installing django-graphiql-debug-toolbar

Before you install

Low friction install with three straightforward dependencies. Maintenance is dormant—last release was in August 2021 and no commits since July 2024—so expect no active bug fixes or compatibility updates for newer Django or Python versions.

License in practice

MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions.

Quickstart

pip install django-graphiql-debug-toolbar

# In settings.py
INSTALLED_APPS = [
    'debug_toolbar',
    'graphiql_debug_toolbar',
]

MIDDLEWARE = [
    'graphiql_debug_toolbar.middleware.DebugToolbarMiddleware',
]

# Then use GraphiQL as normal; debug toolbar appears in the IDE

Requires Django ≥ 2.2 and Python ≥ 3.6; you must also have graphene-django and django-debug-toolbar installed and configured.

Verify before relying

• Whether this package works reliably with Django versions released after August 2021 (3.2 is the latest classifier listed).
• Current compatibility with modern Python 3.10+ and recent graphene-django releases.
• Whether the GraphiQL IDE integration still functions with current GraphQL tooling.

Package facts

Evidence: django_graphiql_debug_toolbar-0.2.0-py3-none-any.whl

Keywords: django, graphql, graphiql, debug

Tags

More Software Development packages