bchao1 / vocabs

📚 A lightweight online dictionary integration to the command line. No browsers. No paperbacks.

📚 vocabs

---

📚 A lightweight online dictionary integration to the command line. No browsers. No paperbacks.

---

Setting Up

$ pip install vocabs

Features

📆 Word of the Day!

📈 Trending words!

❓ Directly query words from the command line.

📓 Save words to your local dictionary.

📝 Add notes to saved words.

🎮 Interactive word game to hone your vocabulary skills.

So how is this different from dict ?

dict is the client for DICT, or the Dictionary Server Protocol on Unix-like platforms. It is used to query natural language dictionaries without firing up a bloaty browser, which tremendously slows down your workflow.

Vocab aims to do the same as dict, only with some differences:

• Less verbose result (since Vocab only uses one source).
• Can save words to local client dictionary pickle file.
• Can add notes to a saved word.
• Includes a interactive word-quiz feature.
• With colors 🎨!

All in all, Vocab is a great tool for fast word queries with easy-to-read definitions, and a good support for ESL users.

Requirements

and the following libraries are required.

Running

🔥 Launch vocab anywhere on your terminal.

$ vocab

Usage

$ vocab

Options:
    --mode, -m ['query', 'edit', 'dict', 'interactive']
    --file, -f <path to word list>
    --reset, -r
    --count, -c
    --lucky, -l
    --trend, t

Feeling Lucky

📆 Word of the Day.

$ vocab -l

Trending Words

📈 Shows a list of frequently searched words.

$ vocab -t

Query Mode

❓ Directly search and save unknown words from the command line.

$ vocab -m query

Dictionary Mode

📓 Scroll though pages to search for saved words.

$ vocab -m dict

Edit mode

✏️ Edit your save words and add notes.

$ vocab -m edit

Interactive Mode

🎮 Test your vocabulary skills with the interactive mode.

$ vocab -m interactive

Load Word List

📜 Load a list of words from to your local dictionary.

$ vocab -f <path to file>

Count Total Words

🔢 Count number of words saved in your local dictionary.

$ vocab -c

Reset Local Dictionary

$ vocab -r

Help

$ vocab -h

Todo

• Synonyms / Antonyms.

vocabs's Issues

Not working in windows

installed using pip package and tried in windows platform.
Got error "'vocab' is not recognized as an internal or external command,
operable program or batch file."

System install

Vocab cannot be installed as a system package currently because it write to its source location:

Traceback (most recent call last):
  File "/usr/host/bin/vocab", line 35, in <module>
    main()
  File "/usr/host/bin/vocab", line 17, in main
    app = App()
  File "/usr/lib/python3.7/site-packages/vocab/lib/app.py", line 24, in __init__
    os.mkdir(config.DICT_DIR)
PermissionError: [Errno 13] Permission denied: '/usr/lib/python3.7/site-packages/vocab/local'

Writing to user owned folders (like xdg directories) could fix this problem.

This software looks promising and I can't wait to add a package upstream ^^

Argument form.

For example, would it be better if the query mode is changed to 'vocab query [word to query]' rather than launching 'vocab' in query mode, then searching for words in the program?

Full command line support.

Support left, right cursor movement, autofill with tab, etc. To my knowledge, currently there isn't a library that does that.