skip to navigation
skip to content

Not Logged In

misspellings 2.0c

A tool to detect misspellings

Spell checker for code

This is a Python library and tool to check for misspelled words in source code. It does this by looking for words from a list of common misspellings. The dictionary it uses to do this is based on the Wikipedia list of common misspellings.

The list has been slightly modified to remove some changes that cause a number of false positives. In particular ok->OK was removed (ok is frequently used in perl tests for instance).


To try it out, merely run the following (using an old coreutils source tree as an example):

$ git clone git:// -b v8.10 coreutils
$ find coreutils -name '*.c' | misspellings -f -
coreutils/src/cat.c:754: efficency -> "efficiency"
coreutils/src/comm.c:198: funtion -> "function"
coreutils/src/expr.c:21: seperate -> "separate"
coreutils/src/pr.c:1417: accomodate -> "accommodate"
coreutils/src/tac.c:342: unneccessary -> "unnecessary"
coreutils/src/test.c:91: supressed -> "suppressed"


Contributions are welcome! Please add unit tests for new features or bug fixes. To run all the unit tests run ./ test. If you have tox installed, just run tox.

You can review coverage of added tests by running coverage run test and then running coverage report -m.

Note that tests are run on Travis for all supported python versions whenever the tree on github is pushed to.

The code is available in the following locations:

Pull requests on any of those platforms or emailed patches are fine.


Some items on the TODO list:

  • Implement option to interactively fix files.
  • Give some thought to supporting multiple languages?
  • Might a “common misspellings” list be different for different English users - might an American make one set of mistakes while a German writing English make another? Source of this data?
  • Fix sed flag. Have it support sed -i optionally, have it output all unambiguous sed commands, have it be more careful on what it replaces. It might also be an idea to have a perl output option.
  • Use generators to allow finding errors as you go. Currently misspellings grabs all files first, then checks them, which can take a while.
  • Lacking tests for misspellings cli.


  • Kevin Lyda: Initial shell goo and python version.
  • Steven Myint: Better python idioms and style. Mixed case support. Travis/tox support.
  • Maciej Blizinski: Potential use in opencsw pushed move to python.
  • Ville Skyttä: Sped up wordification, editor-friendly reporting.
File Type Py Version Uploaded on Size
misspellings-2.0c.tar.gz (md5, pgp) Source 2013-02-19 78KB
  • Downloads (All Versions):
  • 9 downloads in the last day
  • 81 downloads in the last week
  • 446 downloads in the last month