https://github.com/qiniu/python-sdk

Qiniu Resource (Cloud) Storage SDK for Python
https://github.com/qiniu/python-sdk

Last synced: 4 days ago
JSON representation

Qiniu Resource (Cloud) Storage SDK for Python

• Host: GitHub
• URL: https://github.com/qiniu/python-sdk
• Owner: qiniu
• License: mit
• Created: 2012-03-22T08:25:20.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2024-05-13T04:21:42.000Z (6 months ago)
• Last Synced: 2024-05-22T02:42:31.000Z (6 months ago)
• Language: Python
• Homepage:
• Size: 3.4 MB
• Stars: 545
• Watchers: 37
• Forks: 256
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome - qiniu sdk

README

        
# Qiniu Cloud SDK for Python

[![@qiniu on weibo](http://img.shields.io/badge/weibo-%40qiniutek-blue.svg)](http://weibo.com/qiniutek)

[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE)

[![Build Status](https://github.com/qiniu/python-sdk/actions/workflows/ci-test.yml/badge.svg)](https://travis-ci.org/qiniu/python-sdk)

[![GitHub release](https://img.shields.io/github/v/tag/qiniu/python-sdk.svg?label=release)](https://github.com/qiniu/python-sdk/releases)

[![Latest Stable Version](https://img.shields.io/pypi/v/qiniu.svg)](https://pypi.python.org/pypi/qiniu)

[![Download Times](https://img.shields.io/pypi/dm/qiniu.svg)](https://pypi.python.org/pypi/qiniu)

[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/qiniu/python-sdk/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/qiniu/python-sdk/?branch=master)

[![Coverage Status](https://codecov.io/gh/qiniu/python-sdk/branch/master/graph/badge.svg)](https://codecov.io/gh/qiniu/python-sdk)

## 安装

通过pip

```bash

$ pip install qiniu

```

## 运行环境

| Qiniu SDK版本 |              Python 版本               |

| :-----------: | :------------------------------------: |

|      7.x      | 2.7, 3.3, 3.4, 3.5, 3.6, 3.7, 3.8, 3.9 |

|      6.x      |                  2.7                   |

## 使用方法

### 上传

```python

import qiniu

...

    q = qiniu.Auth(access_key, secret_key)

    key = 'hello'

    data = 'hello qiniu!'

    token = q.upload_token(bucket_name)

    ret, info = qiniu.put_data(token, key, data)

    if ret is not None:

        print('All is OK')

    else:

        print(info) # error message in info

...

```

更多参见SDK使用指南： https://developer.qiniu.com/kodo/sdk/python

```

## 测试

``` bash

$ py.test

```

## 常见问题

- 第二个参数info保留了请求响应的信息，失败情况下ret 为none, 将info可以打印出来，提交给我们。

- API 的使用 demo 可以参考 [examples示例](https://github.com/qiniu/python-sdk/tree/master/examples)。

- 如果碰到`ImportError: No module named requests.auth` 请安装 `requests` 。

## 代码贡献

详情参考[代码提交指南](https://github.com/qiniu/python-sdk/blob/master/CONTRIBUTING.md)。

## 贡献记录

- [所有贡献者](https://github.com/qiniu/python-sdk/contributors)

## 联系我们

- 如果需要帮助，请提交工单（在portal右侧点击咨询和建议提交工单，或者直接向 [email protected] 发送邮件）

- 如果有什么问题，可以到问答社区提问，[问答社区](http://qiniu.segmentfault.com/)

- 更详细的文档，见[官方文档站](http://developer.qiniu.com/)

- 如果发现了bug， 欢迎提交 [issue](https://github.com/qiniu/python-sdk/issues)

- 如果有功能需求，欢迎提交 [issue](https://github.com/qiniu/python-sdk/issues)

- 如果要提交代码，欢迎提交 pull request

- 欢迎关注我们的[微信](http://www.qiniu.com/#weixin) [微博](http://weibo.com/qiniutek)，及时获取动态信息。

## 代码许可

The MIT License (MIT).详情见 [License文件](https://github.com/qiniu/python-sdk/blob/master/LICENSE).