pyshanb 0.5.1

# PyShanb：命令行下的扇贝词典

基于 [扇贝网 API v0.8](http://www.shanbay.com/support/dev/api.html "扇贝网 API v0.8") 开发的一个命令行下的查词工具。
支持将生词添加到扇贝网的个人词库中。

## 功能

* 自动登录扇贝网（需要配置用户名及密码）
* 显示单词中文释义
* 显示单词英文释义（可选，默认禁用）
* 自动发音（Windows only）（可选，默认禁用）
* 自动添加单词到扇贝网词库（当天待背单词列表）（可选，默认禁用）
* 询问是否添加单词到扇贝网词库（可选，默认启用）
* 显示例句（显示用户在扇贝网添加的例句）（可选，默认禁用）
* 配置文件（配置用户名、密码及其他功能项）
* 从爱词霸网获取单词信息（可选，默认禁用）
* 通过命令行参数指定配置文件、用户名及密码
* 登录后显示用户昵称
* 添加单词例句（可选，默认启用）

## 依赖

* [python 2.6 or 2.7](http://www.python.org/ "www.python.org")
* [requests](https://github.com/kennethreitz/requests "requests-github")
* [mp3play(windows only，可选)](https://code.google.com/p/mp3play/ "mp3play-url")

## 安装使用

1. `pip install pyshanb` 或 `git clone https://github.com/mozillazg/PyShanb` ；
2. 配置用户名及密码（通过配置文件（pyshanb.conf）或命令行参数（-u -p））；
3. 命令行下执行：`python pyshanb.py`（Tips：使用过程中输入 `q` 即可退出程序）。
4. 或 `shanbay -u username -p password`

### 命令行参数

>shanbay --hlep
Usage: shanbay-script.py [-s SETTINGS] [-u USERNAME] [-p PASSWORD]
[-e | -E] [-i | -I] [-a | -A] [--version]

Options:
--version show program's version number and exit
-h, --help show this help message and exit
-s SETTINGS, --settings=SETTINGS
The settings file of the application.
-u USERNAME, --username=USERNAME
The username of shanbay.com.
-p PASSWORD, --password=PASSWORD
The password of shanbay.com.
-e Enable "Add example" feature.
-E Disable "Add example" feature.
-i Enable "Get data from iciba.com" feature.
-I Disable "Get data from iciba.com" feature.
-a Enable "Auto play audio" feature.
-A Disable "Auto play audio" feature.


# PyShanb changelog

## 2013-03-16 0.5.1

* 新增加几个命令行参数（[-i | -I] [-a | -A]）

## 2013-03-04 0.5

* 现在可以为单词添加例句了（默认启用），可以通过配置文件或命令行参数 `-E`
禁用该功能

## 2013-02-10 0.4

* 增加命令行参数
* 获取用户昵称

## 2013-01-14 0.3

* 适应新版 requests(1.x) 和 shanbay.com. thanks @hongyuan19 .

## 2012-12-04 0.2

* 现在能够同时获取[爱词霸](http://www.iciba.com)的单词信息了（可选，默认禁用）：
* 音节划分
* 读音
* 解释
* 过去分词、现在分词之类的其他信息

## 2012-11-15 0.1

* First version.
* 自动登录扇贝网（需要配置用户名及密码）
* 显示单词中文释义
* 显示单词英文释义（可选，默认禁用）
* 自动发音（Windows only）（可选，默认禁用）
* 自动添加单词到扇贝网词库（当天待背单词列表）（可选，默认禁用）
* 询问是否添加单词到扇贝网词库（可选，默认启用）
* 显示例句（显示用户在扇贝网添加的例句）（可选，默认禁用）
* 配置文件（配置用户名、密码及其他功能项）