Skip to main content

Fixes typos in text using regular expressions, based on RegExTypoFix from Wikipedia

Project description Travis CI

Topy (anagram of “typo”) is a Python script to fix typos in text, using rulesets developed by the RegExTypoFix project from Wikipedia. The English ruleset is included with Topy and is used by default. Other rulesets can be manually downloaded.

Topy works with Python 2.7 and 3.5-3.7.

The easiest way to install it is using pip:

pip install topy


Usage: topy [options] FILES/DIRS...

  -h, --help            show this help message and exit
  -q, --quiet           silence information messages
  -a, --apply           overwrite files in place
  -r FILE, --rules=FILE
                        specify custom ruleset file to use
  -d RULE, --disable=RULE
                        disable rules by name


0.3.0 (2020-06-02)

Note: This will be the last release to support Python 2.7.

  • Updated bundled ruleset (thanks to Oscar Caballero)
  • Added –disable option to disable individual rules (thanks to Oscar Caballero)
  • Fixed behavior when replacement string contains $ symbol (thanks to Oscar Caballero)
  • Prefer the faster lxml parser when it is installed. lxml is now an optional dependency (thanks to Oscar Caballero)
  • Added Python 3.7 support, deprecated Python 3.3 and 3.4.

0.2.2 (2016-12-16)

  • Update bundled ruleset
  • Officially add Python 3.6 support

0.2.1 (2016-07-15)

  • Update bundled ruleset
  • Update regex dependency version to avoid regex issue #216
  • Officially add Python 3.5 support

0.2.0 (2015-09-09)

  • Several fixes with Unicode on Python 2
  • Can safely deal with filenames that are invalid Unicode
  • Update bundled ruleset
  • Fix a few warnings from used libraries

0.1.0 (2014-08-24)

  • Initial public release


Code style:

  • In general follow the Python PEP-8 coding style, except line length can go up to 120 chars.
  • Strings that have meaning for humans use double quotes ("), otherwise single quotes ('). When in doubt, don’t worry about it.
  • Code should be compatible with both Python 2 and 3, preferably without version-specific conditionals.

Run the test suite using python test.

Submit your changes as pull requests on GitHub.


The Topy software is licensed under the MIT license (see LICENSE.txt)

The bundled retf.txt file, copied from Wikipedia AutoWikiBrowser/Typos by Wikipedia contributors is licensed under CC-BY-SA. See the page on Wikipedia for authorship information.

Project details

Download files

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

Files for topy, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size topy-0.3.0.tar.gz (137.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page