Acceder al sistema de administración

Instalar Django Debug Toolbar

Instalar Django Debug Toolbar

La herramienta Django Debug Toolbar ha sido desarrollada por David Cramer y su utilidad es básicamente la de ayudar a los desarrolladores Web con el depurado en el  proceso de desarrollo de sus proyectos.
 
Con esta herramienta conseguiremos mucha información sobre nuestro proyecto, información relevante del comportamiento de Django cada vez que se hace una petición a nuestra aplicación en desarrollo.
 
La información que nos facilita por defecto es la siguiente:


  • Versión: Muestra las versiones de Python, Django y aplicaciones que tengamos instaladas en el proyecto.

  • Temporizador: Nos muestra los tiempos de carga en la solicitud actual.

  • Configuración : Podremos visualizar los ajustes de nuestro settings.py

  • Encabezados: Muestra las cabeceras de las peticiones y respuestas del HTTP, así como los valores del entorno WSGI.

  • Solicitud: Visualización de GET, POST, Cookie, Sesión y variables recogidas en la petición actual.

  • SQL: Este panel nos enseñará las consultas SQL realizadas, incluyendo los tiempos de respuesta de las mismas.

  • Plantillas: Nos facilitará las rutas de donde son llamadas las plantillas y los Context utilizados en ellas.

  • Static Files: Al igual que el panel anterior, pero en esta ocasión nos mostrará los archivos estáticos y su ubicación.

  • Cache: Nos mostrará las consultas guardadas en cache.

  • Señal: En este panel visualizaremos la lista de señales, sus argumentos y receptores.

  • Login: Como su nombre indica, podremos gestionar el logeo de usuario.

  • Redirecciones: Cuando este panel esta activado, Django Debug Toolbar mostrará una página intermedia cada vez que se realice un redireccionamieto, ofreciendo en esta página intermedia un enlace al destino. Este comportamiento es un poco molesto, pero lo podremos configurar desde INTERCEPT_REDIRECTS en las opciones de configuración.


Aparte de todos estos paneles, tenemos la posibilidad de complementarlos con paneles creados por terceros.
 
Bien, ahora que ya sabemos para qué nos sirve esta herramienta, veamos como instalarla en nuestros proyectos Django.
 
La Documentación Oficial nos recomienda realizar la instalación de Django Debug Toolbar a través de PIP, ejecutando la siguiente línea desde la consola de comandos.
 

  1. (Deploy) H:\Deploy\tupresenciaonline\pip install django-debug-toolbar


También podemos instalarla con este otro comando
 

  1. (Deploy) H:\Deploy\tupresenciaonline\easy_install django-debug-toolbar


Y una tercera forma de instalarla sería descargando la herramienta desde la Web del proyecto en GitHub, acceder a los archivos descargados mediante la consola de comandos hasta ubicarnos en el directorio donde se encuentre el fichero setup.py y ejecutar la siguiente instrucción.
 

  1. python setup.py install


Una vez instalado debemos configurar algunos parámetros en el settings.py de nuestro proyecto.
 
La configuración que aquí explico es la básica con los ajustes por defecto, pero en la documentación oficial se muestra como se puede realizar una configuración personalizada para cubrir las necesidades de cada proyecto en particular.
 
Tenemos que añadir debug_toolbar.middleware.DebugToolbarMiddleware en la variable  MIDDLEWARE_CLASSES 
 

  1. MIDDLEWARE_CLASSES = (

  2.     ...

  3.     'debug_toolbar.middleware.DebugToolbarMiddleware',

  4.     ...

  5. )


Según la documentación, dependiendo de en que lugar coloquemos el MIDDLEWARE esté funcionará de una forma u otra, revisarla para tenerlo claro. Yo personalmente la pongo al final de la lista.
 
 
También podemos declarar la variable INTERCEPT_REDIRECTS en False
 

  1. DEBUG_TOOLBAR_CONFIG = {

  2.     'INTERCEPT_REDIRECTS': False,

  3. }


Con esta declaración evitaremos posibles problemas a la hora de que Django Debug Toolbar intercepta las redirecciones.
 
Para poder ejecutar esta herramienta en Local debemos de declarar la siguiente variable
 

  1. INTERNAL_IPS = ('127.0.0.1',)


Y por último siguiendo el ejemplo de la entrada 'Creación de un proyecto en Django' nuestro INSTALLED_APPS quedaría de la siguiente forma.
 

  1. INSTALLED_APPS = (

  2.     'django.contrib.auth',

  3.     'django.contrib.contenttypes',

  4.     'django.contrib.sessions',

  5.     'django.contrib.sites',

  6.     'django.contrib.messages',

  7.     'django.contrib.staticfiles',

  8.     'django_admin_bootstrapped',

  9.     # Uncomment the next line to enable the admin:

  10.     'django.contrib.admin',

  11.     'django.contrib.flatpages',

  12.     # Uncomment the next line to enable admin documentation:

  13.     'django.contrib.admindocs',

  14.     'tupresenciaonline',

  15.     'debug_toolbar',

  16. )


Fijaros que hemos añadido la línea nº. 15
 
Con estos pasos ya tendremos funcionando Django Debug Toolbar.
 
Volvemos a la consola de comandos y levantamos el servidor con manage.py runserver.
 

  1.  (Deploy) H:\Deploy\tupresenciaonline\manage.py runserver


 Blog - Rubén Arranz || Django || Arrancando el servidor Django
 
Comprobemos que pasa en nuestro proyecto. Nos dirigimos a http://127.0.0.1:8000/admin en el navegador Web y ya podremos visualizar a la derecha, la Barra de Herramientas de Depuración!!
 
Blog - Rubén Arranz || Django || Django Debug Toolbar
 
Podéis ver todos estos pasos en video siguiendo este link 'Instalar Django Debug Toolbar'.


Creado por el día 12 de Febrero de 2014


Volver




blog comments powered by Disqus

Propiedades de la entrada

Título: Instalar Django Debug Toolbar

Categoria: Django

Etiquetas: Debug_Toolbar Django Instalación

Comentarios: Ver Comentarios

Comparte esta entrada: