###简介 qshell是利用七牛文档上公开的API实现的一个方便开发者测试和使用七牛API服务的命令行工具。
###下载
###使用
我们知道调用七牛的API需要一对AccessKey和SecretKey，这个可以从七牛的后台的账号设置->密钥获取。
首先要使用七牛的API，必须先设置AccessKey和SecretKey。命令如下：
qshell account ELUs327kxVPJrGCXqWae9yioc0xYZyrIpbM6Wh6o LVzZY2SqOQ_I_kM1n00ygACVBArDvOWtiLkDtKi_
上面的ELUs327kxVPJrGCXqWae9yioc0xYZyrIpbM6Wh6o就是你的AccessKey，而LVzZY2SqOQ_I_kM1n00ygACVBArDvOWtiLkDtKi_就是你的SecretKey。如果你想查看当前的AccessKey和SecretKey设置，使用命令：
qshell account
上面的命令会输出当前你设置好的AccessKey和SecretKey。
接下来，我们就可以放心地使用七牛的API功能了。
###详解
| 命令 | 描述 | 详细 |
|---|---|---|
| account | 设置或显示当前用户的AccessKey和SecretKey | 文档 |
| dircache | 输出本地指定路径下所有的文件列表 | 文档 |
| listbucket | 列举七牛空间里面的所有文件 | 文档 |
| alilistbucket | 列举阿里OSS空间里面的所有文件 | 文档 |
| prefop | 查询七牛数据处理的结果 | 文档 |
| fput | 以文件表单的方式上传一个文件 | 文档 |
| rput | 以分片上传的方式上传一个文件 | 文档 |
| qupload | 同步数据到七牛空间， 带同步进度信息，和数据上传完整性检查 | 文档 |
| qdownload | 从七牛空间同步数据到本地，支持只同步某些前缀的文件，支持增量同步 | 文档 |
| stat | 查询七牛空间中一个文件的基本信息 | 文档 |
| delete | 删除七牛空间中的一个文件 | 文档 |
| move | 移动或重命名七牛空间中的一个文件 | 文档 |
| copy | 复制七牛空间中的一个文件 | 文档 |
| chgm | 修改七牛空间中的一个文件的MimeType | 文档 |
| fetch | 从Internet上抓取一个资源到七牛空间中 | 文档 |
| prefetch | 更新七牛空间中从源站镜像过来的文件 | 文档 |
| batchdelete | 批量删除七牛空间中的文件，可以直接根据listbucket的结果来删除 |
文档 |
| checkqrsync | 检查qrsync的同步结果，主要通过比对dircache和listbucket的结果 |
文档 |
| b64encode | base64编码工具，可选是否使用UrlSafe方式，默认UrlSafe | 文档 |
| b64decode | base64解码工具，可选是否使用UrlSafe方式，默认UrlSafe | 文档 |
| urlencode | url编码工具 | 文档 |
| urldecode | url解码工具 | 文档 |
| ts2d | 将timestamp(单位秒)转为UTC+8:00中国日期，主要用来检查上传策略的deadline参数 | 文档 |
| tms2d | 将timestamp(单位毫秒)转为UTC+8:00中国日期 | 文档 |
| tns2d | 将timestamp(单位100纳秒)转为UTC+8:00中国日期 | 文档 |
| d2ts | 将日期转为timestamp(单位秒) | 文档 |
| ip | 根据淘宝的公开API查询ip地址的地理位置 | 文档 |
##编译
- 如果是编译本地平台的可执行程序，使用
src目录下面的build.sh脚本即可。 - 如果是编译跨平台的可执行程序，使用
src目录下面的gox_build.sh脚本即可。该脚本使用了gox工具，请 使用go get github.com/mitchellh/gox安装。