An open API service indexing awesome lists of open source software.

https://github.com/makkoncept/pyvoc

Cross-platform dictionary and vocabulary building command line tool
https://github.com/makkoncept/pyvoc

argparse cli-utilities command-line-tool python vocabulary

Last synced: 3 months ago
JSON representation

Cross-platform dictionary and vocabulary building command line tool

Awesome Lists containing this project

README

          



Cross-platform dictionary and vocabulary building command line tool







platforms










---

# Pyvoc



**Use it to improve your english vocabulary, brush up some word meanings or as a simple command line dictionary.**

---

Jump to:

- [Installation](#Installation)
- [Usage](#Usage)
- [Groups](#Groups)
- [Examples](#Examples)

## Installation

Install it using pip. Just run:

```bash
pip3 install pyvoc
```

## Usage

After installing pyvoc, run `pyvoc -w word` to _automatically create necessary config files_ in your home directory.

- Fetch meaning of word

```
pyvoc -w word
```

- Fetch meaning of word and add it to vocabulary group:

```
pyoc word -a
```

- Take quiz from vocabulary group 101 (default questions are 5):

```
pyvoc -q 101
```

- Take quiz of 25 questions from vocabulary group 101 :

```
pyvoc -q 101 -n 25
```

_read some more [examples](#Examples)_

```
➜ pyvoc -h
usage: pyvoc [-h] [-v] [-w ] [-a] [-g ] [-r ] [-q ] [-n ] [-l]

Command line dictionary and vocabulary building tool.

optional arguments:
-h, --help show this help message and exit
-v, --version Print version of pyvoc and exit
-w Give meaning of WORD
-a, --add-word Use to add WORD to vocabulary group
-g Use to specify the vocabulary group no.(1-10) to add the WORD to
-r Revise the vocabulary group you mention
-q Start quiz from the vocabulary group you mention
-n Mention the number of questions of quiz.
-l, --list Lists all vocabulary groups present
```

## groups

pyvoc lets you add words to vocabulary groups, which you can later revise or take quiz from.

- 3 **custom groups of 800 words each** (words taken from GRE and SAT preparation websites) already present. These groups are 101, 102 and 103.
- 10 groups of 50 words are **reserved** for the user. These groups are 1 - 10.
- you can specify a group from 1-10 using [-g] option.

## Examples

### add word to a specific group

```
pyvoc word -a -g 5
```

Fetch meaning of the word and add it to vocabulary group 5. **Use this option to organize words however you like.**

**_for example_**

- alphabatically
- words from books you have been reading
- parts of speech
- increasing difficulty

---

### revise a group

```
pyvoc -r 7
```

Revise word meaning of vocabulary group 7(if present) in random order.

---

### show group list

```
pyvoc --list
```

Lists all group numbers along with their size.