cambridge is a terminal version of Cambridge Dictionary.
Project description
Cambridge
cambridge is a terminal version of Cambridge Dictionary, with its data from https://dictionary.cambridge.org
By default, it is English to English translation. For English to Chinese, add '-c' or '--chinese' option.
Supports looking up the Merriam-Webster Dictionary, with -w or --webster option. Webster has no foreign language translation in itself.
Screenshots
Look up Cambridge Dictionary
Look up Merriam-Webster Dictionary
Why This
I'm a terminal person tired of pulling out a GUI app or browser, inputting words in the search bar, hitting the search button and then waiting for the result to render with a bunch of unnecessary static files coming along. Not only is the time taken long, but also switching apps back and forth can be annoying. So I wrote this console application with features to my satisfaction.
Highlights
camb <word/phrase>to look it up in Cambridge Dictionary by default-wflag to fetch Merriam-Webster Dictionary- less than 2s taken to do all the work for the word, including fetching, parsing, printing, and writing cache
- less than 0.1s for the same word's later search
- only the first dictionary from Cambridge (assuming the optimal) to avoid being confused by multiple dictionaries
- a list of word/phrase suggestions will be given, if not found
camb lto list words and phrases you've found before- colorscheme well customized to dark, light, blueish, grayish, gruvbox terminal backgrounds
fzf
With fzf installed, camb l | fzf --preview 'camb {}' will get you a taste of the fzf magic:
- display the whole word list
- fuzzy find a word from the word list & preview its meaning instantly
- preview each word definition instantly as you scroll through the list
alias cambl="camb l | fzf --preview 'camb {}'"can be added in your.bashrcfor convenience
Install & Uninstall
pip install cambridge # install
pip uninstall cambridge && rm -rf $HOME/.cache/cambridge # uninstall and remove cache
Usages
Command s (hidden)
For looking up a dictionary. Flags can be put before or after <word/phrase>.
camb <word/phrase> # look up a word/phrase in Cambridge Dictionary
camb <word/phrase> -w # look up a word/phrase in Merriam-Webster Dictionary
camb <word/phrase> -c # look up a word/phrase in Cambridge with Chinese translation
camb <phrase with "'" > # camb "a stone's throw" | camb a stone\'s throw
camb <phrase with "/" > # camb "have your/its moments" | camb have your\/its moments
camb <word/phrase> -d # look up a word/phrase in debug mode
camb <word/phrase> -f # look up a word/phrase afresh without using cache
camb <word/phrase> -n # look up a word/phrase without showing suggestions if not found
Command l
For listing and deleting items in the cache.
camb l # list alphabetically ordered words/phrases you've found before
camb l -t # list words/phrases in reverse chronological order
camb l -r # list 20 words/phrases from the word list randomly
camb l -d # delete one or more words/phrases(separated by ", ") from the list
Command wod
For displaying 'Word of the Day' in the Merriam Webster Dictionary
General options
camb -h, --help # show this help message and exit
camb -v, --version # print the current version of the program
TO-DOS
- input a new word/phrase when spelling suggestions are not satisfactory without restarting a new command line
- check a particular expression against all cached sentence examples, if found, we can confidently use it like that in our speaking or writing
- split and accumulate all sentences from a whole bulk of cache as independent Corpus, then we can use this Corpus outside this program
- strengthen 'Word of the Day' functionality from Webster
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for cambridge-3.9.4-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 81fbf5fbd701e0f3e1251d5eb66403646c851af094c6d1ab90f72d63a4fe4ab5 |
|
| MD5 | 77866c03ef650e50042bcf949a57e2c5 |
|
| BLAKE2b-256 | 87fef51d560fa1549712eb630384cd1024c3633b6cc635bbc5d44eaf58c51f2e |
