What is the best way to debug a Django application? Are there any Django-specific tools to help you debug in Django?
For example, how can you debug why a template is taking too long to render? Or why an API endpoint is crashing? Is there a better way to debug than using
There are many tools available to help us debug a Django application. Here are a few of the more popular ones:
Django shell is a Python shell that lets us access the database API included with Django. When we open the Django shell, Django loads all dependencies for the project and imports Django settings, allowing us to evaluate expressions related to our project.
We can start the Django shell using the ‘manage.py’ file, like so:
$ python manage.py shell
The Django Debug Toolbar is a visual tool that helps us debug the Django application.
The Django debug toolbar offers information on every page of our app using a sliding sidebar. It gives us information about various parts of the app like the current request/response, resource usage (e.g. time), Django settings, HTTP headers, SQL queries, cache, logging, and more.
We can install the toolbar with
(venv) $ pip install django-debug-toolbar
Now we need to add it to the project’s
# settings.py INSTALLED_APPS = [ 'my_project', ... 'debug_toolbar' ]
Then we will need to add it to the application’s
# settings.py MIDDLEWARE_CLASSES = [ 'django.contrib.auth.middleware.SessionAuthenticationMiddleware', ... 'debug_toolbar.middleware.DebugToolbarMiddleware' ]
The toolbar’s sidebar will appear on any connection that matches Django’s
INTERNAL_IPS if the
DEBUG value is set to
Python’s built-in debugging module
pdb is an excellent tool to debug any Python application interactively.
Django PDB is a package that allows us to use the
pdb module in the context of Django applications. It automatically activates the
pdb for any endpoint.
We can install the
django-pdb module using
(venv) $ pip install django-pdb
Next we need to add it to the end of the application’s
# settings.py INSTALLED_APPS = [ 'my_project', ... 'django_pdb' ]
Then we will need to add it to the end of the application’s
# settings.py MIDDLEWARE_CLASSES = [ 'django.contrib.auth.middleware.SessionAuthenticationMiddleware', ... 'django_pdb.middleware.PdbMiddleware' ]
Django PDB is fairly easy to use if you are familiar with Python’s
pdb module. You can learn more about its usage in the documentation.
Lastly, we can also use the built-in debugging features of the IDE or code editor to debug a Django application.
Here are some links to debug a Django app in different IDEs and code editors: