[![image](https://img.shields.io/badge/License-AGPL%203-purple.svg)](https://opensource.org/licenses/AGPL-3.0)
[![image](https://img.shields.io/badge/download-windows-green.svg?logo=windows)](https://github.com/cjrh/thesauromatic/releases/latest/download/thesauromatic.exe)
[![image](https://img.shields.io/badge/download-linux-green.svg?logo=linux)](https://github.com/cjrh/thesauromatic/releases/latest/download/thesauromatic)

thesauromatic
=============

Zero-dependency command-line CLI thesaurus

Demo
----

Pretty much just give it a word, and you get a bunch of similar or
related words back:

``` {.bash}
$ ./thesauromatic deluge
Niagara
abound
affusion
alluvion
alluvium

<...snip...>

waterflood
watering
waterspout
wet
wetting
whelm
whelming
```

Features
--------

-   Synonyms from the [Moby
    project](https://en.wikipedia.org/wiki/Moby_Project)
-   Statically compiled, word lists are linked in. No dependencies. Just
    download an executable for your target platform.
-   Fast; takes about 40 ms to emit the words. This makes it easy to
    drive from your editor, and will work offline.

Install
-------

Just download the executable. Check out the *Releases* tab.

Making a new release
--------------------

To make a new release, use the tool *bumpversion* to increase the
version number; this will update the version number in all the right
places, commit that, and add a matching git tag. Then push those
changes:

``` {.bash}
$ bumpversion patch
$ git push --tags origin master
```

Then go to <https://github.com/cjrh/thesauromatic/releases> and create a
new release, using the same tag as the one created above.

To build a release binary, use `dub`:

``` {.bash}
$ dub build --build=release
```

Then upload that binary into the github release just created.

Tips & Tricks
-------------

Take advantage of CLI filters! How about formatting the output into
columns?

``` {.bash}
$ ./thesauromatic flippant | column -c70
airy            facetious       leering         smart
bantering       facy            light-hearted   smart-alecky
belittling      fleering        malapert        smart-ass
biggety         flip            mocking         smirking
bluff           fooling         nervy           sneering
booing          forgetful       oblivious       snickering
brash           free and easy   offhand         sniggering
brazen          fresh           offhanded       snorting
careless        frivolous       panning         supercilious
casual          gally           perfunctory     superficial
catcalling      gratuitous      pert            tactless
chaffing        grinning        quizzical       taunting
cheeky          heedless        ragging         teasing
chutzpadik      hissing         railing         thoughtless
cocky           hooting         rallying        twitting
contemptuous    impertinent     razzing         uncalled-for
crusty          impudent        reckless        undiplomatic
cursory         inconsiderate   regardless      unheedful
degage          indifferent     respectless     unheeding
derisive        insolent        ridiculing      unmindful
derisory        insouciant      roasting        unprepared
discourteous    irreverent      rude            unready
dismissive      jeering         sassy           unserious
disregardant    jocular         saucy           unsolicitous
disregardful    joshing         scoffing        untactful
disrespectful   kidding         scornful        unthinking
easygoing       lazy            shallow         wise-ass
```

Perhaps you\'re also trying to complete an
[alliteration](https://en.wikipedia.org/wiki/Alliteration) on the letter
`r`?

``` {.bash}
$ ./thesauromatic flippant | grep ^r | column -c70
ragging         razzing         respectless     rude
railing         reckless        ridiculing
rallying        regardless      roasting
```