A wordnik commandline client
Diction is a python script that acts as a wrapper for Wordnik's API
Best when piped into less, because outputs can be pretty long
- Run
pip3 install git+https://github.com/Rayquaza01/dictionorpip3 install diction - Run
diction.pyto download a sample config file to~/diction.ini - Add your API key to the config file
Multiple arguments can be sent at a time. diction.py word example -d -r returns definitions and related words for both "word" and "example".
The word(s) used when calling the API. Multiple words can be entered, separated by spaces.
This is a positional argument, and must come before all other arguments.
Ex: diction.py word example ...
Use the canonical version of the word (e.g. cats -> cat)
This argument overrides the configuration set in diction.ini. Each section has its own useCanonical option, defaulting to false.
Used as -c or --useCanonical
The amount of results to return per section. Accepts one number as an argument.
This argument overrides the configuration set in diction.ini. Each section has its own limit option, with different defaults for each section.
Used as -l or --limit
Ex: diction.py word -l 20 ...
The maximum amount of characters to display on a single line. Accepts one number as an argument.
This argument overrides the configuration set in diction.ini. The api section has a wordwrap option, defaulting to 80.
Setting the value to -1 disables wordwrapping.
Used as -ww or --wordwrap
Ex: diction.py word -ww 100 ...
Whether to return examples of the word.
Used as -e or --examples
Same as examples, but only returns the first example.
Used as -te or --topExample
Whether to return definitions. Accepts parts of speech as arguments, space separated. See reference.md
Used as -d or --definitions
Ex: diction.py word -d noun verb ...
Ex: diction.py word -d ...
Whether to return related words. Accepts related types as arguments, space separated. See reference.md
Used as -r or --relatedWords
Ex: diction.py word -r synonym antonym ...
Whether to return pronunciation of the word.
Used as -p or --pronunciations
Whether to return hyphenation of the word.
Used as -hy or --hyphenation
Whether to open a webpage with a graph of the word's frequency. Takes a start year and an end year as arguments, or defaults to the years specified in the config. Chart.js is used to make the graph.
Used as -f or --frequency
Ex: diction.py -f 1800 2012 ...
Whether to return two word phrases containing the word.
Used as -ph or --phrases
Whether to return the etymologies of the word.
Used as -et or --etymologies
Whether to open a webpage with audio files of pronunciations.
Used as -a or --audio
Whether to return a random word. The word argument has no affect on this.
Used as -rw or --randomWord
Same as randomWord, but with more than one word. The word argument has no affect on this.
Used as -rws or --randomWords
Whether to return the word's scrabble score.
Used as -s or --scrabbleScore
Built using Python 3
Uses Chart.js for frequency graph (MIT)
