Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/flask-debugtoolbar/flask-debugtoolbar

A toolbar overlay for debugging Flask applications
https://github.com/flask-debugtoolbar/flask-debugtoolbar

debug flask flask-debugtoolbar flask-sqlalchemy jinja profile python werkzeug

Last synced: 8 days ago
JSON representation

A toolbar overlay for debugging Flask applications

Awesome Lists containing this project

README

        

# Flask-DebugToolbar

A [Flask][] extension that injects debugging information into rendered HTML
pages. Presented as a sidebar with configurable panels of information.

This is a port of the excellent [django-debug-toolbar][ddt].

[Flask]: https://flask.palletsprojects.com
[ddt]: https://github.com/jazzband/django-debug-toolbar/

## Pallets Community Ecosystem

> [!IMPORTANT]\
> This project is part of the Pallets Community Ecosystem. Pallets is the open
> source organization that maintains Flask; Pallets-Eco enables community
> maintenance of related projects. If you are interested in helping maintain
> this project, please reach out on [the Pallets Discord server][discord].

[discord]: https://discord.gg/pallets

## Example

Setting up the debug toolbar is simple:

```python
from flask import Flask
from flask_debugtoolbar import DebugToolbarExtension

app = Flask(__name__)
app.config["SECRET_KEY"] = ""

toolbar = DebugToolbarExtension(app)
```

The toolbar will automatically be injected into Jinja templates when debug
mode is enabled.

```
$ flask -A my_app run --debug
```

![](https://raw.githubusercontent.com/pallets-eco/flask-debugtoolbar/main/docs/_static/example.gif)