Check your spelling with hunspell and/or languagetool.

Run cargo spellcheck --fix or cargo spellcheck fix to fix all your documentation comments in order to avoid narsty typos all over your source tree.

Meant as a helper simplifying review as well as improving CI checks after a learning phase for custom/topic specifc lingo.

cargo spellcheck check

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

cargo spellcheck fix

error: spellcheck(Hunspell)
    --> /media/supersonic1t/projects/cargo-spellcheck/src/literalset.rs:291
     |
 291 |  Returns literl within the Err variant if not adjacent
     |          ^^^^^^

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

   lite
   litter
   litterer
   liter l
   liters
   literal
   liter
 » a custom replacement literal

cargo spellcheck can be configured with -m <code> to return a non-zero return code if mistakes are found instead of 0.

• Parse doc comments from arbitrary files
• Decent error printing
• cargo-spellcheck check
• Spell checking using hunspell
• Merge multiline doc comments
• Handle multiline and fragmented mistakes (i.e. for grammar) #25
• Grammar check using languagetool http API
• Follow module declarations rather than blindly recurse
• Be commonmark aware
  • Handle doctests with ```rust as virtual files #43
  • Verify all types of links #44
• Check README.md files #37
• Check mdbook book.toml file trees #62
• Improve interactive user interface with crossterm
• Ellipsize overly long statements with ... #42
• Learn topic lingo and filter false-positive-suggestions #41
• Handle cargo workspaces #38
• Re-wrap doc comments #39
• Word split validation #40

hunspell and languagetool are currently the two supported featuresets.

# 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 ]
search_dirs = []
extra_dictonaries = []

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

cargo install cargo-spellcheck

Available checker support

Requires a C++ compiler to compile the hunspell CXX source files which are part of hunspell-sys

dnf install -y clang

apt install -y clang

brew install llvm

The environment variable LLVM_CONFIG_PATH needs to point to llvm-config, to do so:

export LLVM_CONFIG_PATH=/usr/local/opt/llvm/bin/llvm-config

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