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 Cambridge Dictionary (screenshot on DARK terminal background)

look up a word in Cambridge Dictionary

Look up 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 additional Chinese translation
  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 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>, <word/phrase>, ...     # look up words/phrases in Cambridge Dictionary
camb -w <word/phrase>, <word/phrase>, ...  # look up words/phrases in Merriam-Webster Dictionary
camb -c <word/phrase>, <word/phrase>, ...  # look up words/phrases in Cambridge with Chinese translation
camb <w/p>, <w/p>, ... -w <w/p>, <w/p>, ... -c <w/p>, <w/p>, ... # concurrent searching

# 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 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

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.13.8.tar.gz (639.5 kB view details)

Uploaded Source

Built Distribution

cambridge-3.13.8-py3-none-any.whl (40.8 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for cambridge-3.13.8.tar.gz
Algorithm Hash digest
SHA256 0f7d96b9270470890d4d64f7010071a61116cb49df58bc6f699e6b036e384c17
MD5 21695a64c7fb1aa5dbba378e0e7b7198
BLAKE2b-256 74c47c54f0fa442a458d67bcb52a099b9234d40bd45e1d1b4f4b0f9973b4ef46

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for cambridge-3.13.8-py3-none-any.whl
Algorithm Hash digest
SHA256 6ff7308b90273ade751530efd9e5e9b64d2f0b90d112cc8813fc3adef64bbf67
MD5 a8d0a661f1bda7fdaafda79d304a1918
BLAKE2b-256 df3e802ccb11e30523cd2af83422568372e969ba80359493ace6213800d840e5

See more details on using hashes here.

Supported by

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