Metadata-Version: 1.0
Name: youdao
Version: 0.1.5
Summary: 基于有道API和有道词典web版的在terminal查询词的小工具,支持单词发音
Home-page: https://github.com/longcw/youdao
Author: longcw
Author-email: longchsin@foxmail.com
License: UNKNOWN
Description: #youdao
        ###简介
        基于Python 在控制台下查单词的小工具, 使用有道词典API或者web版有道词典, 支持单词发音, 自动调用系统默认mp3播放器播放。
        这个小程序是受<https://github.com/Flowerowl/ici> 启发, 用requests 库和有道的API 写一遍练习一下, 同时加上了发音以及数据库保存查询历史的功能。
        
        ###使用说明
        + 由于有道api需要鉴权,查询速度受到影响,所以增加了抓取web版有道词典的方法进行查词,默认使用这种方法.使用Beautifulsoup 库解析网页数据,生成和api类似的dict.
        
        + 使用sqlite 保存查询历史, 数据库文件保存在`~/.dict_youdao`
        
        + 获取单词发音的方法`yd -v word`. 下载的单词发音保存在`~/.dict_youdao/voice`下, 采用系统默认播放器播放. 在Linux 下推荐使用Clementine 播放器, 播放时不会弹出新窗口.
        
        
        
        ###使用帮助
            默认通过解析有道网页版获取查询结果, 没有词典结果时自动使用有道翻译.
            查询结果会保存到sqlite 数据库中
            使用方法 yd [-a] [-n] [-l] [-c] [-v] [-d word] [--help] word
            [-a] 使用API 而不是解析网页获取结果
            [-n] 强制重新获取, 不管数据库中是否已经保存
            [-l] 列出数据库中保存的所有单词
            [-c] 清空数据库
            [-v] 同时获取发音
            [-d word] 删除数据库中某个单词
            [--help] 显示帮助信息
        ###更新历史
        + 0.1.5 添加获取单词发音的功能
        + 0.1.4 添加删除数据库中保存的单词的功能, 添加帮助说明
        + 0.1.3 抓取过的单词使用sqlite保存
        + 0.1.2 增加抓取web版有道词典页面的方法查词, 并默认使用这种方法. 可以通过 -a 选项使用api查词.
        + 0.1.1 改变查词方法为 yd keyword
        + 0.1.0 完成基本功能, 使用命令 youdao keyword 查词.
        
        ---
        ###1.运行效果
        支持中文，句子翻译
        	
        	yd keyword
        ![截图1](./pic1.png)
        
        	$ yd
        	input a word: 饺子
        ![截图2](./pic2.png)
        
        获取单词发音效果
            
            yd -v clementine
        ![发音](./pic3.png)
        
        ###2.安装
        
        	sudo python setup.py install
        或者
        	
        	sudo pip install youdao		
        安装好后在控制台直接调用yd 或者 yd keyword 即可
        
        ###3.设置自己的API key
        一个key 每分钟只能发起1000次请求，可以去有道自行申请一个API key，地址：
        <http://fanyi.youdao.com/openapi?path=data-mode>
        
        修改youdao.py 中如下部分即可
        
        	params = {
                'keyfrom': 'longcwang',
                'key': '131895274',
                'type': 'data',
                'doctype': 'json',
                'version': '1.1',
                'q': 'query'
        	    }
Keywords: python youdao dictionary terminal
Platform: UNKNOWN
