Skip to main content

A simple and lightweight terminal formatter for dict.cc translations.

Project description

dictcc-mini

Quickly look up translations without relying on the browser. This script is mostly just a table formatter which happens to get it's data for formatting from dict.cc.

Features:

  1. simple
  2. scales with respect to terminal width
  3. small footprint

dictcc-mini screenshot



About

I wanted a tool for the most convenient and quick access to vocab through cli. There is another similar tool already available which is more feature rich, but it has a larger dependency footprint. I've deliberately opted against depending on rich for formatting and lxml for parsing.

State

  • up to v0.1.3: depends only on: requests, beautifulsoup4 and fake-headers. site-packages in freshly installed VENV including all transient dependencies like html5lib, idna, urllib3 is sub 20 MB!
  • since v0.2.0: No dependencies left after implementing the relevant logic with python standard library. Now sub MB size!


How to setup

pypi

classical: pip install dictcc-mini


manual

  1. Download the source code from github.

  2. Make dictcc-mini/src directory available via PYTHONPATH environment variable.

    1. export PYTHONPATH=$PYTHONPATH:/your/path/to/dictcc-mini/src
      
  3. Alias in an rc-file of your shell in one of the following two ways.

    1. alias dict="python3 -m dictcc_mini.cli "
      function dict() { "python3 -m dictcc_mini.cli" "$@" }
      

defaults

As per my own preference, this script defaults to DE/EN as languages, which are simply set as DEFAULT_LANG1 and DEFAULT_LANG2 constants in the config.py and easily modified to match your preference.

Different styles for marking multiline entries and other defaults available to set in config.py as well.



How to use

# regular lookup
dict word

# to start with language selector before search use -l (--language) toggle
dict word -l

# set -f (--full) toggle full table if default 20 line table is too short 
dict word -f

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dictcc_mini-0.2.3.tar.gz (241.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dictcc_mini-0.2.3-py3-none-any.whl (9.6 kB view details)

Uploaded Python 3

File details

Details for the file dictcc_mini-0.2.3.tar.gz.

File metadata

  • Download URL: dictcc_mini-0.2.3.tar.gz
  • Upload date:
  • Size: 241.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.15.0b1

File hashes

Hashes for dictcc_mini-0.2.3.tar.gz
Algorithm Hash digest
SHA256 50e00a844f215e0e2564a9ab44324f91dd83c6847d97e88688207e3bf1e7b392
MD5 92a573147aacb8d77850dd08a45f7559
BLAKE2b-256 3de7633df0d82600004567689d1c393c8b613c457a8e9fa466718c092ca03f5e

See more details on using hashes here.

File details

Details for the file dictcc_mini-0.2.3-py3-none-any.whl.

File metadata

  • Download URL: dictcc_mini-0.2.3-py3-none-any.whl
  • Upload date:
  • Size: 9.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.15.0b1

File hashes

Hashes for dictcc_mini-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 1185720f93ab05daa85b0b1b3959a0a96cb91933e6e9ce8b8b46553154ffa2f2
MD5 841caa1628d417867316419769a3091e
BLAKE2b-256 221979ce3fab334374dafd27522b347ce495b9c779183e4dbca0392b409646f0

See more details on using hashes here.

Supported by

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