Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Importchecker finds unused imports in Python modules.

Project Description


What is importchecker?

Importchecker is a commandline utility to find unused imports in Python modules.

Its output is “grep-like” (and thus “emacs-friendly”), reporting both the module’s filenames and line numbers where names are imported that are not acually used in the module.

Importchecker will not modify any of the source files. Whether the import needs to be removed is left to the judgement of the developer.


The importchecker commandline utility can be installed using the easy_install command:

$ sudo easy_install importchecker

The command can then be invoked with either a directory or a Python file:

$ importchecker /path/to/a/source/tree
$ importchecker /path/to/a/source/tree/


Projects that make use of zc.buildout for development might find the following buildout.cfg. snippet useful for using the importchecker on the developed codebase:

parts = importchecker ...

recipe = zc.recipe.egg
eggs = importchecker
arguments = "${buildout:directory}/src"

Known issues

  • One source tree path argument at the time can be passed to the command line utility.
  • Command line argument parsing is rather naïve.


1.1 (2012-01-09)

  • Applied provided by wosc enabling running the import checker on individual python modules not just directories.
  • Report the absolute path for modules when needed, relative paths (relative to the current working directory, that is) when possible.

1.0 (2008-05-06)

  • Initial packaging
  • Make the importchecker work on python 2.5


  • Martijn Faassen (original developer)
  • Philipp von Weitershausen
  • Jan-Wijbrand Kolman (packaging)
  • various comitters on


Release History

Release History

This version
History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
importchecker-1.1.tar.gz (6.8 kB) Copy SHA256 Checksum SHA256 Source Jan 9, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting