Sheldon

Very Simple Erlang Spell Checker.

Note:Sheldon also suggests correct words when some word is misspelled. That functionality was highly inspired by the Elixir project spell_check.

Contact Us

For questions or general comments regarding the use of this library, please use our public hipchat room.

If you find any bugs or have a problem while using this library, please open an issue in this repo (or a pull request :)).

And you can check all of our open-source projects at inaka.github.io.

Installation

  1. Clone the repo
  2. rebar3 compile

Usage

Erlang Shell

First of all Sheldon is an application and it needs to be started. You can use rebar3 shell to set the necessary paths, then use sheldon:start/0 or application:ensure_all_started(sheldon) in order to start Sheldon but if you are using Sheldon as a dependency you can let OTP starts it from your_app.app file too.

Sheldon only has two main methods, sheldon:check/1 and sheldon:check/2. As a user, you just need to use those.

1> sheldon:check("I want to check this correct text").
ok
2> sheldon:check("I want to check this misspeled text").
#{bazinga => <<"That&#39;s no reason to cry. One cries because one is sad. For example, I cry because others are stupid, and that ma"...>>,
  misspelled_words => [#{candidates => ["misspeed","misspelled"],
     line_number => 1,
     word => "misspeled"}]}

Configuration

sheldon:check/2 works like sheldon:check/1 but it accepts a Configuration parameter. With this Conf parameter we can apply some rules to the text we want to check. Those rules are ignore words, ignore patterns and ignore blocks.

This is the format (see sheldon_config.erl), no key is required:

#{ ignore_words    => [string()]
 , ignore_patterns => [regex()]
 , ignore_blocks   => [ignore_block()]
 }.

Then, if we call the previous sheldon:check/1 but with configuration we can skip the error

3> sheldon:check("I want to check this misspeled text", #{ignore_words => ["misspeled"]}).
ok

Examples

Check this out.

Results

sheldon:check/1 and sheldon:check/2 have the same result type, you can see sheldon_result.erl. Sheldon will return the ok atom if the check went well else it'll return

    #{ misspelled_words := [misspelled_word()]
     , bazinga          := string()
     }.

Dependencies