命令行版本的有道词典

youdao.py

#!/usr/bin/env python
# -*- coding: utf-8 -*-

"""
命令行版本的有道词典，调用有道翻译的 API 实现

用法一：
    % python youdao.py search
    原文： search
    发音： sɜːtʃ
    解释：
    
    n. 搜寻；探究，查究
    vt. 搜索；搜寻；调查；搜查；探求
    vi. 搜寻；调查；探求
    n. (Search)人名；(英)瑟奇
    ===================================

用法二（推荐）：
    % mv youdao.py ~/bin/youdao  # 添加到用户的 PATH
    % chmod +x ~/bin/youdao      # 赋予可执行权限
    % youdao search              # 在任意路径下都可以方便使用了
    原文： search
    发音： sɜːtʃ
    解释：
    
    n. 搜寻；探究，查究
    vt. 搜索；搜寻；调查；搜查；探求
    vi. 搜寻；调查；探求
    n. (Search)人名；(英)瑟奇
    ===================================

"""

import requests


class YoudaoDict(object):
    def __init__(self, keyfrom, key, version="1.1"):
        self.keyfrom = keyfrom
        self.key = key
        self.version = version
        self.base_url = "http://fanyi.youdao.com/openapi.do"

    def _fetch_json(self, q):
        params = {
            "keyfrom": self.keyfrom,
            "key": self.key,
            "type": "data",
            "doctype": "json",
            "version": self.version,
            "only": "dict",
            "q": q
        }
        resp = requests.get(self.base_url, params=params, timeout=5)
        return resp.json()

    def _has_error(self, error_code):
        return error_code != 0

    def _error_info(self, error_code):
        return {
            20: u"要翻译的文本过长",
            30: u"无法进行有效的翻译",
            40: u"不支持的语言类型",
            50: u"无效的key",
            60: u"无词典结果，仅在获取词典结果生效"
        }.get(error_code, "未知错误：%s" % error_code)

    def _output(self, _json):
        error_code = _json.get("errorCode")
        if self._has_error(error_code):
            print self._error_info(error_code)
            return

        query = _json.get("query")
        print "原文：", query
        basic = _json.get("basic", None)
        if basic is None:
            print "解释：查无释义"
        else:
            print "发音：", basic.get("phonetic", "")
            print "解释：\n"
            print "\n".join(basic.get("explains", []))
        print "===================================\n"

    def lookup(self, q):
        resp = self._fetch_json(q)
        self._output(resp)


# 去 http://fanyi.youdao.com/openapi?path=data-mode 申请一个 key
# 会得到 keyfrom 和 key 两个值，然后替换到这里
# 现在最新版是 1.1
youdao = YoudaoDict(keyfrom, key, "1.1")


if __name__ == '__main__':
    import sys
    
    if len(sys.argv) < 2:
        print "Usage: %s [query]" % __file__
        sys.exit(1)

    queries = sys.argv[1:]
    for q in queries:
        youdao.lookup(q)