hg-canttype: mercurial extension for bad typists
================================================

Corrects simple typing errors in commands using
`Damerau-Levenshtein distance <http://en.wikipedia.org/wiki/Damerau–Levenshtein_distance>`_.

Ever typed `hg dfif`, `hg doff` or `hg banrch`? This fixes that.


Some examples of how it helps::

    $ hg dfif
    Correcting 'dfif' to 'diff'

    $ hg brnch
    Correcting 'brnch' to 'branch'


Installation & Setup
--------------------

Installing hg-canttype is simple::

    $ pip install hgcanttype


Setup is easy too, just add hgcanttype to your hgrc::

    [extensions]
    hgcanttype=

You can configure the distance to consider a command "close enough" like so::

    [canttype]
    distance = 5


The default is 1. Take note that setting the distance too high is a bad idea::

    $ hg dfif
    Correcting 'dfif' to 'help'


You can also configure the plugin to provide suggestions rather than
automatically correcting the command, just like git::

    $ hg dfif
    hg: unknown command 'dfif'

    Did you mean this?
        diff

This is easy to configure::

    [canttype]
    suggest = true

Note that it will automatically do this if it finds more than one command, even
if you have suggestions turned off::

    $ hg cu
    hg: unknown command 'cu'

    Did you mean this?
        ci
        cp
        co


License
-------

As this is a derived work of the Mercurial project, the license is GPLv2+ as
per the `Mercurial License <http://mercurial.selenic.com/wiki/License>`_ page.


Change History
--------------

1.0.6 (24th March 2014)
    - I hate Restructured Text

1.0.5 (24th March 2014)
    - Provide suggestions if multiple matches were found.
    - Provide suggests all the time if [canttype]/suggest = true.

1.0.4 (12th March 2014)
    - Handle no command being passed in. Thank you, Andrew Taumoefolau!

1.0.3 (11th March 2014)
    - Removed pointless print statement

1.0.2 (10th March 2014)
    - Fix more typos...

1.0.1 (10th March 2014)
    - Fix typos. The irony.

1.0.0 (10th March 2014)
    - Initial release
