qshell

README

qshell

###简介 qshell是利用七牛文档上公开的API实现的一个方便开发者测试和使用七牛API服务的命令行工具。

###下载

版本	支持平台	链接
qshell v1.0	Linux, Windows, Mac OSX	[下载](http://7rfgu2.com1.z0.glb.clouddn.com/qshell v1.0.zip)
qshell v1.1	Linux, Windows, Mac OSX	[下载](http://7rfgu2.com1.z0.glb.clouddn.com/qshell v1.1.zip)

###使用 我们知道调用七牛的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	同步数据到七牛空间， 带同步进度信息，和数据上传完整性检查	文档
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地址的地理位置	文档

##编译

1. 如果是编译本地平台的可执行程序，使用src目录下面的build.sh脚本即可。
2. 如果是编译跨平台的可执行程序，使用src目录下面的gox_build.sh脚本即可。该脚本使用了gox工具，请 使用go get github.com/mitchellh/gox安装。