syn's Introduction

🌾 syn

Get synonyms and antonyms of words from Thesaurus.com, Datamuse API and AlterVista in your terminal, with rich output.

Install:

pip install synonym-cli

Usage:

syn <word>

Explore Mode

Returns more particular results about the given word. Uses Datamuse API.

for Web UI: https://wordwhisper.vercel.app

$ syn dominant -d

Other Languages

For other languages you can use --lang, -l command. To use this feature, you need to get an api key from here.

$ syn -l fr belle

$ syn -l ru фраза

AlterVista's Thesaurus API supports the following languages:

Czech: cs, Danish: da, English (US): en, French: fr, German (Germany): de, German (Switzerland): de, Greek: el, Hungarian: hu, Italian: it, Norwegian: no, Polish: pl, Portuguese: pt, Romanian: ro, Russian: ru, Slovak: sk, Spanish: es.

Set Default Language

You can set the default language with the --setlang <lang_code> argument, so you don't have to give the -l argument every time.

$ syn --setlang fr
> default language is: fr
$ syn belle
> ...

Arguments

  -h, --help      show this help message and exit
  -p, --plain     returns plain text output
  -l, --lang      <language>
  --setkey        set apikey for altervista api
  --setlang       set default language (currently default is 'en')
  --show          show settings file
  -v, --version   show program's version number and exit

Contrubuting

Contributions are welcome. If you want to contribute to this list send a pull request or just open a new issue.

syn's People

Contributors

Stargazers

Watchers

syn's Issues

multi-language support with AlterVista API (and others)

AlterVista's Thesaurus API supports the following languages:
Czech, Danish, English (US), French, German (Germany), German (Switzerland), Greek, Hungarian, Italian, Norwegian, Polish, Portuguese, Romanian, Russian, Slovak, Spanish.

API key is required, registration is also required: https://thesaurus.altervista.org/openapi

example command:
syn -l fr joyeux

lang codes:
en, fr, cs, el, es, da, de, hu, it, no, pl, pt, ro, ru, sk

preview:

Import Error while Installing

Hey!

Firstly, thanks for the useful script. :)

I tried to install the package but I found two minor errors that resulted in failure.
Firstly, importing the version number from __main__.py causes the import of the external libraries.
Thus, the package installation fails if the external libraries are not already installed (as in my case!).
Secondly, the README file has a different extension than the one reported in setup.py.

I'm preparing a pull request fixing this, hoping it might help!

Thesaurus.com parsing fails due to potential changes on the site

Hello,

I've noticed that synonym-cli is currently unable to parse data from Thesaurus.com, likely due to changes on the site. This results in a failure when trying to get synonyms or antonyms for any word. The error message I'm receiving is:

Expecting value: line 1 column 1 (char 0)

I've already developed a fix for this issue by utilizing BeautifulSoup to parse the necessary JSON data from the site. This solution seems to work well and I will soon open a pull request for your review. This way, users can continue to enjoy this useful tool.

Recommend Projects

agmmnn / syn Goto Github PK