cargo-spellcheck

Check your spelling with hunspell and/or languagetool.

Usecase

Run cargo spellcheck --fix or cargo spellcheck fix to fix all your documentation comments in order to avoid narsty types all over the place.

Meant as a helper simplifying review as well as possibly improving CI after a learning phase for custom/topic specifc lingo. cargo spellcheck has a return code 1 if any unknown words are found, and 0 on success.

Test Cases

Check

zsh cargo spellcheck check

error: spellcheck
   --> src/main.rs:44
    |
 44 | Fun facets shalld cause some erroris.
    |            ^^^^^^
    | - shall or shall d
    |

Interactive fixing

zsh cargo spellcheck fix --interactive

Improvement requests tracked in issue #7.

error: spellcheck(Hunspell)
  --> /media/supersonic1t/projects/cargo-spellcheck/demo/src/nested/justtwo.rs:2
   |
 2 |  Beto
   |  ^^^^

(2/2) Apply this suggestion [y,n,q,a,d,j,e,?]?

   Beeton
   Bet o
 » Beta
   Bets
   Bet
   Be-to
   Be to
   Veto
   Beth

Features

• [x] Parse doc comments from arbitrary files
• [x] Decent error printing
• [x] cargo-spellcheck check
• [x] Spell checking using hunspell
• [x] Merge multiline doc comments
• [x] Grammar check using languagetool http API
• [x] False positive reduction
• [x] Follow module declarations rather than blindly recurse
• [x] Be markdown aware
  • [ ] Handle doctests with ```rust as virtual files skeptic-like
  • [ ] Verify all types of links: direct urls and href
• [ ] Check README.md files
• [x] cargo-spellcheck fix --interactive
• [x] Improve interactive user interface with crossterm
• [ ] Ellipsize overly long statements with ...
• [ ] cargo-spellcheck fix
• [ ] Learn topic lingo and filter false-positive-suggestions when fix --interactive is passed
• [ ] Handle cargo workspaces
• [ ] Re-wrap doc comments
• [ ] Word split validation

hunspell and languagetool are currently the two supported featuresets.

Configuration

```toml

Linux: /home/alice/.config/cargo_spellcheck/config.toml

Windows: C:\Users\Alice\AppData\Roaming\cargo_spellcheck\config.toml

macOS: /Users/Alice/Library/Preferences/cargo_spellcheck/config.toml

[LanguageTool] url = "127.0.0.1:8010"

[Hunspell]

lang and name of .dic file

lang = "en_US"

OS specific additives

Linux: [ /usr/share/myspell ]

Windows: []

macOS [ /home/alice/Libraries/hunspell, /Libraries/hunspell ]

searchdirs = [] extradictonaries = [] ```

Installation

cargo install cargo-spellcheck

To increase verbosity use CARGO_SPELLCHECK=cargo_spellcheck=trace to see internal details or add -v (multiple) to increase verbosity.

Hunspell

Requires the native library

```sh

Fedora 30+

dnf install -y hunspell-devel

Ubuntu 19.10+

apt install -y libhunspell-dev

Mac OS X

brew install hunspell ```

and building should succeed just fine.

LanguageTool

Run a instance of the LanguageTool server i.e. as container .