thesaurus 0.5.1

An offline thesaurus library for Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140

# thesaurus-rs
[![Crates.io](https://img.shields.io/crates/v/thesaurus.svg)](https://crates.io/crates/thesaurus)
[![Crates.io](https://img.shields.io/crates/d/thesaurus)](https://crates.io/crates/thesaurus)
[![API](https://docs.rs/thesaurus/badge.svg)](https://docs.rs/thesaurus)

The offline thesaurus library for Rust that can use both [wordnet](https://wordnet.princeton.edu/) and [moby](https://en.wikipedia.org/wiki/Moby_Project) backends.

Add to `Cargo.toml` for wordnet:
```toml
thesaurus = "0.5"
```

Add to `Cargo.toml` for moby *(wordnet is on by default)*:
```toml
thesaurus = { version = "0.5", features = ["moby"], default_features = false }
```

## Backend Comparison
Name | Simple Example Binary Size | Simple Example Binary Size (Stripped) | Available Words | Average Number of Synonyms | Compressed Dictionary Size | License
---|---|---|---|---|---|---
Moby | 15M | 11M | 30159 | 83.287 | 11M | US Public Domain
Wordnet | 6.9M | 3.4M | 125701 | 3.394 | 2.9M | [Wordnet License](https://wordnet.princeton.edu/license-and-commercial-use)

## Basic Example
```rust
use std::{env, process};

fn main() {
    let args = env::args().collect::<Vec<String>>();

    let word: String = match args.get(1) {
        Some(word) => word.to_string(),
        None => {
            eprintln!("Must include a word as an argument");
            process::exit(1);
        }
    };

    let synonyms = thesaurus::synonyms(&word);
    let num_words = thesaurus::dict().len();

    cfg_if::cfg_if! {
        if #[cfg(all(feature = "moby", feature = "wordnet"))] {
            print!("both wordnet and moby have ");
        } else if #[cfg(feature = "moby")] {
            print!("moby has ");
        } else if #[cfg(feature = "wordnet")] {
            print!("wordnet has ");
        }
    }

    println!("{num_words} words indexed, and {} synonyms for \"{word}\"...", synonyms.len());
    println!("synonyms...");
    for x in &synonyms {
        println!("   {x}");
    }
}
```

### Wordnet Output
```shell
 $ cargo r -rq --example simple -- good
```

```
wordnet has 125701 words indexed, and 107 synonyms for "good"...
synonyms...
   acceptable
   adept
   advantageous
   ample
   angelic
   angelical
   bang-up
   beatific
   beneficial
   beneficial
   best
...
```

### Moby Output
```shell
 $ cargo r -rq --example simple --no-default-features --features=moby -- good
```

```
moby has 30195 words indexed, and 666 synonyms for "good"...
synonyms...
   able to pay
   absolutely
   acceptable
   accomplished
   according to hoyle
   ace
   actual
   adept
   adequate
   admirable
   admissible
   adroit
   advantage
   advantageous
...
```

## Both
```shell
 $ cargo r -rq --example simple --features=moby,wordnet -- good
```

```
both wordnet and moby have 132592 words indexed, and 773 synonyms for "good"...
synonyms...
   able to pay
   absolutely
   acceptable
   acceptable
   accomplished
   according to hoyle
   ace
   actual
   adept
   adept
   adequate
   admirable
   admissible
   adroit
   advantage
   advantageous
   advantageous
   advisable
   affable
   affectionate
   agreeable
   all right
   all-knowing
   all-powerful
...
```