Seven Cow 七牛

另一个七牛云存储Python SDK

此SDK目标是更容易的使用，完整功能的SDK请见

Install

pip install sevencow

Usage

初始化

在你需要的地方

from sevencow import Cow
cow = Cow(<ACCESS_KEY>, <SECRET_KEY>)

然后就可以通过 cow.stat(<BUCKET>, <FILENAME>) 这样来进行操作. 但为了简化操作，并且考虑到大多数都是在一个bucket中进行文件操作，所以建议再做一步：

b = cow.get_bucket(<BUCKET>)

后面都用这个b对象来操作。它代表了<BUCKET>

列出所有的bucket

cow.list_buckets()

列出一个bucket中的所有文件

b.list_files()

这个方法还有 marker, limit, prefix这三个可选参数，详情参考官方文档

上传，删除，查看文件信息

这三种是一类操作，因为只要提供文件名即可

b.put('a')                  # 上传单个文件
b.put('a', 'b', 'c')        # 批量上传
b.stat('a')                 # 查看单个文件信息
b.stat('a', 'b', 'c')       # 批量查看
b.delete('a')               # 删除单个文件
b.delete('a', 'b', 'c')     # 批量删除

默认情况下put上传是使用文件本身的名字作为上传后的名字(也就是在bucket中key)，但你也可以给put方法加一个names关键字参数来指定文件上传后应该是什么名字。

b.put('a', names={'a': 'x'})  # 本地文件'a'，上传后的在七牛中的名字是'x'
b.put('a', 'b', 'c', names={'a': 'x', 'b': 'y', 'c': 'z'}) # 上传后，'a','b','c'的名字分别为'x','y','z'
b.put('a', 'b', 'c', names={'c': 'z'})  # 只改变'c'的名字为'z'，'a','b'不变

拷贝，移动（改名）

这两个操作都需要提供源文件名和目标文件名

b.copy('a', 'b')                            # 将'a' 拷贝至'b'
b.copy(('a', 'b'), ('c', 'd'), ('e', 'f'))  # 批量拷贝 'a' => 'b', 'c' => 'd', 'e' => 'f'
b.move('a', 'b')                            # 将'a' 改名为'b'
b.move(('a', 'b'), ('c', 'd'), ('e', 'f'))  # 批量改名 'a' => 'b', 'c' => 'd', 'e' => 'f'

有没有觉得比官方SDK容易使用多呢？

异常

以上操作任何错误都会引发异常，只要请求api返回的不是200

所以安全的做法是这样：

from sevencow import CowException

try:
    b.copy(('a', 'b'), ('c', 'd'))
except CowException as e:
    print e.url         # 出错的url
    print e.status_code # 返回码
    print e.reason      # http error的原因
    print e.content     # api 错误的原因

测试

首先从github clone项目到本地

测试需要三个环境变量

export QINIU_ACCESS_KEY=<...>
export QINIU_SECRET_KEY=<...>
export QINIU_BUCKET=<...>

QINIU_BUCKET 要先在web中建立

在项目目录中直接运行 nosetests

qq40660 / seven-cow