Skip to main content

Find and fix Django mishaps.

Project description


pypi-image semver-image

Django code quality assistant. Offline version of

Find and fix around 40 breaches of Django best practice - helping you build world-class websites, release faster, and reduce dev costs.


$ pip install django-doctor


Run the fix suggestion wizard like so:

$ django_doctor fix

This runs a simple server on http://localhost:9000 and opens the wizard in your browser:

You then accept or reject the suggestions

And ultimately the selected changes are saved to your file system

You can change the address:

$ django_doctor fix --address= --port=9001

Your virtual environment directory is automatically skipped. To exclude other directories use the --ignore flag:

$ django_doctor fix --ignore=foo # single directory
$ django_doctor fix --ignore=foo --ignore=bar # multiple directories

You can also specify a directory to check instead of running on the current working directory. To run on only on "my_app" and "my_other_app":

$ django_doctor fix my_app my_other_app


You can see suggested changes in your shell:

$ django_doctor check

Consider running this as a pre-commit hook, or on your CI to prevent new Django anti-patterns from being merged.

You can also use --ignore the same as with the fix command.


You turn checks on/off with --disable and --enable. See here for the codenames of the checks.



Try running django_doctor in verbose mode by adding --log-level=debug when executing the fix or check commands.


If you're using pipenv you may need to do pipenv install django-doctor --pre because:

  • django-doctor depends on black
  • black only releases pre-releases
  • pipenv ignores pre-releases


Chat with us on if you have any problems or have a feature request

GitHub integration

Django Doctor has GitHub integration. Learn more at

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution (4.9 MB view hashes)

Uploaded source

Built Distributions

django_doctor-2.6.0-cp39-cp39-win32.whl (4.3 MB view hashes)

Uploaded cp39

django_doctor-2.6.0-cp38-cp38-win32.whl (4.3 MB view hashes)

Uploaded cp38

django_doctor-2.6.0-cp37-cp37m-win32.whl (4.3 MB view hashes)

Uploaded cp37

django_doctor-2.6.0-cp36-cp36m-win32.whl (4.2 MB view hashes)

Uploaded cp36

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page