Skip to main content

cambridge is a terminal version of Cambridge Dictionary.

Project description

Cambridge

cambridge is a terminal version of Cambridge Dictionary, whose source is from https://dictionary.cambridge.org; also supports the Merriam-Webster Dictionary as backup.

Screenshots

Look up words/phrases in Cambridge Dictionary (screenshot on DARK terminal background)

look up a word in Cambridge Dictionary

Look up words/phases in Merriam-Webster Dictionary (screenshot on LIGHT terminal background)

look up a word in Merriam-Webster Dictionary

Highlights

  1. camb <word/phrase> to look up in Cambridge Dictionary by default
  2. camb -c <word/phrase> to look up in Cambridge Dictionary with correspondent Chinese meanings
  3. camb -w <word/phrase> to look up in Merriam-Webster Dictionary
  4. support concurrent searching multiple words from one dictionary, or multiple words from different dictionaries
  5. less than 2s taken to do all the work for the word, including fetching, parsing, printing, and writing cache
  6. less than 0.1s for the same word's later search by retrieving cache
  7. only the first dictionary from Cambridge (assuming the optimal) to avoid being confused by multiple dictionaries
  8. a list of suggestions will be given, if not found
  9. camb l to list cached words and phrases
  10. support checking "Word of the Day" from Merriam-Webster Dictionary
  11. support displaying spellcheck suggestion list, cache list, Webster's all of word of the days by fzf
  12. if fzf not installed, the aforementioned lists have been formatted elaborately
  13. well tuned to dark, light, blueish, grayish, gruvbox (dark & light), solarized (dark & light) terminal colorschemes

Install & Uninstall

pip install cambridge
pip uninstall -r requirements.txt -y
rm -rf $HOME/.cache/cambridge
rm -rf $HOME/.cache/fakeua

# within the project
make install
make uninstall
make clean_cache

Usages

Command s (hidden)

For looking up words/phrases in a dictionary or multiple dictionaries.

camb <word/phrase>[, w/p, w/p, ...]    # look up words/phrases in Cambridge Dictionary
camb -w <word/phrase>[, w/p, w/p, ...] # look up words/phrases in Merriam-Webster Dictionary
camb -c <word/phrase>[, w/p, w/p, ...] # look up words/phrases in Cambridge with Chinese translation
camb <w/p>[, <w/p>, ...] -w <w/p>[, <w/p>, ...] -c <w/p>[, <w/p>, ...] # look up words/phrases from multiple dictionaries all at once

# Additional Options
--debug   # look up words/phrases in debug mode
-f        # look up words/phrases afresh without using cache
-n        # look up words/phrases without showing suggestions if not found

# Special Characters on Terminal
# phrase with "'":
camb "a stone's throw" | camb a stone\'s throw

# phrase with "/":
camb "have your/its moments" | camb have your\/its moments

Command l

For listing and deleting items from the cache.

camb l                  # list all words/phrases in alphabetical order
camb l -t               # list all words/phrases in reverse chronological order
camb l -r               # list 20 words/phrases at random
camb l -d               # delete one or more words/phrases from the cache, separated by ', '

Command wod

For displaying 'Word of the Day' in the Merriam Webster Dictionary

camb wod                # list today's Word of the Day from Merriam-Webster Dictionary
camb wod -l             # list all words of the day

General options

camb -h, --help         # show this help message and exit
camb -v, --version      # print the current version of the program

Project details


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

cambridge-3.14.1.tar.gz (639.3 kB view details)

Uploaded Source

Built Distribution

cambridge-3.14.1-py3-none-any.whl (40.5 kB view details)

Uploaded Python 3

File details

Details for the file cambridge-3.14.1.tar.gz.

File metadata

  • Download URL: cambridge-3.14.1.tar.gz
  • Upload date:
  • Size: 639.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.32.4

File hashes

Hashes for cambridge-3.14.1.tar.gz
Algorithm Hash digest
SHA256 dfc4a68b05e977c28c9f951a56606e86a42ae45cb02ba85d3483d396ba872def
MD5 37bdc26f3d2f3b76a5400383e7dbcd7d
BLAKE2b-256 6e45b5e747c43e766b5715b8116a9b833943ffecbd335865d0cf562febac26b5

See more details on using hashes here.

File details

Details for the file cambridge-3.14.1-py3-none-any.whl.

File metadata

  • Download URL: cambridge-3.14.1-py3-none-any.whl
  • Upload date:
  • Size: 40.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.32.4

File hashes

Hashes for cambridge-3.14.1-py3-none-any.whl
Algorithm Hash digest
SHA256 615afaef72e6540ce7d620016ddafde084f6970b80304f63133e64c0471dd712
MD5 84627b5b5b6e134f7585241dffcfc0d2
BLAKE2b-256 fb9f92f9c565baceff22264d469564d52c5e423a17cc3dea939dad2ce6f51eef

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page