Cette extension ajoute une superposition de barre d'outils aux applications Flask contenant des informations utiles pour le débogage.
La configuration de la barre d'outils de débogage est simple:
from flask import Flask
from flask_debugtoolbar import DebugToolbarExtension
app = Flask(__name__)
# the toolbar is only enabled in debug mode:
app.debug = True
# set a 'SECRET_KEY' to enable the Flask session cookies
app.config['SECRET_KEY'] = '<replace with a secret key>'
toolbar = DebugToolbarExtension(app)
La barre d'outils sera automatiquement injectée dans les réponses HTML lorsque le mode de débogage est activé. En production, le réglage désactivera la barre d'outils.app.debug = False
Cette extension prend également en charge le modèle de fabrique d'applications Flask en créant séparément la barre d'outils et en l'initialisant ultérieurement pour une application:
toolbar = DebugToolbarExtension()
# Then later on.
app = create_app('the-config.cfg')
toolbar.init_app(app)
La barre d'outils prend en charge plusieurs options de configuration:
Nom | La description | Défaut |
DEBUG_TB_ENABLED | Activer la barre d'outils? | app.debug |
DEBUG_TB_HOSTS | Liste blanche des hôtes pour afficher la barre d'outils | n'importe quel hôte |
DEBUG_TB_INTERCEPT_REDIRECTS | Les redirections devraient-elles être interceptées? | True |
DEBUG_TB_PANELS | Liste des noms de modules / classes des panneaux | activer tous les panneaux intégrés |
DEBUG_TB_PROFILER_ENABLED | Activer le profileur sur toutes les demandes | False, activé par l'utilisateur |
DEBUG_TB_TEMPLATE_EDITOR_ENABLED | Activer l'éditeur de modèles | False |
Pour modifier l'une des options de configuration, définissez-la dans la configuration de l'application Flask comme:
app.config['DEBUG_TB_INTERCEPT_REDIRECTS'] = False