Skip to main content

A command line translator that integrates with Google Translate and Youdao Dict. Just for fun :)

Project description

Dict-tiny

PyPI version GitHub Workflow Status License: MIT Downloads

A command line translator that integrates with Google Translate, DeepL Translator and Youdao Dict

Just for fun :)

Installation

You can install dict-tiny via pip. (Python 3 only)

$ pip install dict-tiny

Upgrading

$ pip install --upgrade dict-tiny

Usage

Youdao Dict

$ dict-tiny book
>>> Youdao Dict <<<
book  [bʊk][bʊk]
===================
n. 书籍账簿名册工作簿
vt. 预订登记
n. (Book)人名()(广东话·威妥玛)()()
$ dict-tiny 
>>> Youdao Dict <<<
  [shū]
=========
n.book;letter;script
vt.write

Use -m/--more to get more detail translation for word:

$ dict-tiny 曾经 -m
>>> Youdao Dict <<<
曾经  [céng jīng]
=================
adv.once;ever

more detail:
======== 副词 ========
1:
  表示有过某些行为或情况 once:
  He once lived in Shanghai.
  他曾经在上海住过
  She has taken part in a major battle for oil.
  她曾经参加过石油大会战
$ dict-tiny dictionary -m
>>> Youdao Dict <<<
dictionary  ['dɪkʃ(ə)n(ə)rɪ]美['dɪkʃə'nɛri]
=============================================
n. 字典词典

more detail (collins):
======== N-COUNT 可数名词 ========
 · 词典

A dictionary is a book in which the words and phrases of a language are listed alphabetically, together with their meanings or their translations in another language.


 : ...a Spanish-English dictionary.
     一本西班牙语英语词典

Note:

  • Some words have a lot of translation that may occupy the entire screen.
  • Only supports English or Chinese words currently.

Google Translate

Add -g / --google to use Google Translate:

$ dict-tiny -g book
>>> Google Translate <<<
detected language: en
input: book
output: 

Add --target-language to specify what language you want to translate into:

$ dict-tiny -g book --target-language japanese
>>> Google Translate <<<
detected language: en
input: book
output: 

Add --source-language to specify what language you want to translate, but most of the time you don't need to do this because the API will automatically detect the language type.

So, of course, you can use it to detect the language type:

$ dict-tiny --detect-language book
>>> Google Translate <<<
confidence: 1
input: book
language: en
name: English

Note:

  • Make sure the google service is available in your network environment.

  • The source and target languages for Google Translate are identified using the iso-639-1 codes.

    $ dict-tiny -g book --target-language zh --source-language en
    >>> Google Translate <<<
    input: book
    output: 
    source language: en
    

    You can also enter the ISO language name:

    $ dict-tiny -g book --target-language German --source-language English
    >>> Google Translate <<<
    input: book
    output: Buchen
    source language: English
    

Target language

  • Setting the environment variable $DICT_TINY_TARGET_LAN to the target language you prefer so that you do not have to specify the target language every time. Dict-tiny will first get target language from $DICT_TINY_TARGET_LAN. Giving the --target-language switch on the command line will override the environment variable value.
  • The default target-language for Goole Translate are ENGLISH_ISO_639='en' if the content you input is not in English.

DeepL Translate

For some reason I am no longer allowed to use deepl pro, so deepl is no longer supported.

Default behavior

  • Youdao Dict is the default translator, which means Youdao Dict will be used when no translator is specified.
  • If the target language is not specified, Chinese or English will be set as the default target language.

Use clipboard content

Use -c/--clipboard to use the contents of the clipboard:

$ dict-tiny -c -y
>>> Youdao Dict <<<
encounter  [ɪnˈkaʊntə(r)][ɪnˈkaʊntər]
=========================================
v. 遭遇偶遇邂逅
n. 偶遇邂逅经历体验冲突比赛交锋
$ dict-tiny -g -c
>>> Google Translate <<<
input: clipboard
output: 剪贴板
detected language: en

Note:

  • -c/--clipboard has low priority. If you add -c and a word at the same time, the switch -c will be ignored.

License

MIT

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

dict-tiny-1.2.1.tar.gz (13.3 kB view hashes)

Uploaded Source

Built Distribution

dict_tiny-1.2.1-py3-none-any.whl (15.7 kB view hashes)

Uploaded Python 3

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