Metadata-Version: 2.1
Name: ydcv
Version: 0.6
Summary: YouDao Console Version, a simple wrapper for Youdao API
Home-page: https://github.com/felixonmars/ydcv
Author: Felix Yan
Author-email: felixonmars@archlinux.org
License: GPL
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: SunOS/Solaris
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Utilities

YouDao Console Version
======================

Simple wrapper for Youdao online translate (Chinese <-> English) service
`API <https://ai.youdao.com/docs/doc-trans-api.s#p01>`__, as an
alternative to the StarDict Console Version(sdcv).

注意
----

`有道翻译API <http://fanyi.youdao.com/openapi?path=data-mode>`__ 将于
2018-12-31 后停止运行，改由“有道云-有道智云文本翻译”
提供兼容的服务；目前本项目代码已经匹配升级，但是按照文档说法，有道智云API是“按量收费”，目前账户内有100元体验金，具体收费计算方式尚不明确，项目工具的用户量不明确，而又本项目开源，所用服务标识的ID/SECRET也可能被他人使用，因而此后本项目功能存在不确定性。

Usage
-----

::

   $ ydcv --help
   usage: ydcv.py [-h] [-f] [-s] [-S] [-r] [-p {festival,mpg123,sox,mpv}]
                  [-a {auto,uk,us}] [-x] [--color {always,auto,never}]
                  [-F {zh-CHS,ja,EN,ko,fr,ru,pt,es,vi,de,ar,id}]
                  [-t {zh-CHS,ja,EN,ko,fr,ru,pt,es,vi,de,ar,id}]
                  [words [words ...]]

   Youdao Console Version

   positional arguments:
     words                 words to lookup, or quoted sentences to translate.

   optional arguments:
     -h, --help            show this help message and exit
     -f, --full            print full web reference, only the first 3 results
                           will be printed without this flag.
     -s, --simple          only show explainations. argument "-f" will not take
                           effect.
     -S, --speech          print URL to speech audio.
     -r, --read            read out the word with player provided by "-p" option.
     -p {festival,mpg123,sox,mpv}, --player {festival,mpg123,sox,mpv}
                           read out the word with this play.Default to 'festival'
                           or can be 'mpg123', 'sox', 'mpv'.-S option is required
                           if player is not festival.
     -a {auto,uk,us}, --accent {auto,uk,us}
                           set default accent to read the word in. Default to
                           'auto' or can be 'uk', or 'us'.
     -x, --selection       show explaination of current selection.
     --color {always,auto,never}
                           colorize the output. Default to 'auto' or can be
                           'never' or 'always'.
     -F {zh-CHS,ja,EN,ko,fr,ru,pt,es,vi,de,ar,id}, --from {zh-CHS,ja,EN,ko,fr,ru,pt,es,vi,de,ar,id}
                           Translate from specific language. Default: EN
     -t {zh-CHS,ja,EN,ko,fr,ru,pt,es,vi,de,ar,id}, --to {zh-CHS,ja,EN,ko,fr,ru,pt,es,vi,de,ar,id}
                           Translate to specific language. Default: zh-CHS

翻译支持的语言列表
------------------

``--from`` 和
``--to``\ 参数可以指定特定语言之间相互翻译，但只有中文结果有词典内容

==== ====== ======== ==== ==== ==== ======== ====
语言 代码   语言     代码 语言 代码 语言     代码
==== ====== ======== ==== ==== ==== ======== ====
中文 zh-CHS 葡萄牙文 pt   韩文 ko   德文     de
日文 ja     西班牙文 es   法文 fr   阿拉伯文 ar
英文 EN     越南文   vi   俄文 ru   印尼文   id
==== ====== ======== ==== ==== ==== ======== ====

Installation
------------

::

   pip install ydcv

Environment
-----------

-  Python ( >=2.7, 3.x )

Similar Projects (based on github search results)
-------------------------------------------------

-  `RUST <https://github.com/farseerfc/ydcv-rs>`__
-  `another RUST <https://github.com/passchaos/ydcv-rust>`__
-  `Go <https://github.com/pentie/ydgo>`__
-  `Powershell <https://github.com/atupal/ydcv.ps1>`__
-  `C <https://github.com/proudzhu/cydcv>`__
-  `Bash <https://github.com/MasterCsquare/ydcv-bash-version>`__
-  `Perl <https://github.com/JaHIY/ydcv>`__
-  `C++ <https://github.com/proudzhu/ydcv-cpp>`__
-  `Vim <https://github.com/bennyyip/ydcv.vim>`__
-  `Erlang <https://github.com/zhenglinj/ydcv-el>`__
-  `Haskell <https://github.com/proudzhu/ydcv-hs>`__


