七牛雲存儲的 Python 語言版本 SDK（本文以下稱 Python-SDK）是對七牛雲存儲API協議的壹層封裝，以提供壹套對於 Python 開發者而言簡單易用的開發工具。Python 開發者在對接 Python-SDK 時無需理解七牛雲存儲 API 協議的細節，原則上也不需要對 HTTP 協議和原理做非常深入的了解，但如果擁有基礎的 HTTP 知識，對於出錯場景的處理可以更加高效。
最近剛搭了個markdown靜態博客，想把圖片放到雲存儲中。
經過調研覺得七牛可以滿足我個人的需求，就選它了。
要引用圖片就要先將圖片上傳到雲上。
雖然七牛網站後臺可以上傳文件，但每次上傳都需要先登錄，然後選擇圖片，設置連接地址，才能上傳。
這個過程有些繁瑣，所以我便想用七牛雲提供的SDK寫個壹同步工具，方便增量同步文件。
有了這個想法，就馬上行動。花了大概壹個上午的時間，總算把這個工具給寫出來，並放到GitOSC和github上。
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119#!/usr/bin/env python#-*- coding:utf-8 -*-## AUTHOR = "heqingpan"# AUTHOR_EMAIL = "heqingpan@126.com"# URL = "/qiniu/python-sdk?。安裝的方式可以如項目的說明上所說，用 pip install qiniu 。當然也可以直接 clone 壹份源代碼下來直接使用。我壹般喜歡直接 clone 源代碼，這樣的話，如果要對SDK做壹些改動也是十分容易的。
最新版本的Python SDK需要依賴 requests 庫，所以要提前安裝好。安裝方式當然也可以用 pip install requests 。
開發環境
Python的開發環境有很多種選擇，如果喜歡文本的方式，比如vim，emacs，sublime text等都是很好的選擇，如果妳喜歡IDE，那麽最流行的莫過於 PyCharm 了。 PyCharm 的最新版本到?這裏下載。
Access Key和Secret Key
我們知道七牛雲存儲的權限校驗機制基於壹對密鑰，分別稱為 Access Key 和 Secret Key 。其中 Access Key 是公鑰， Secret Key 是私鑰。這壹對密鑰可以從七牛的後臺獲取。
小試牛刀
好了，做了上面的這些準備工作，我們就去上傳壹個簡單的文件，練練手。
1234python#coding=utf-8__author__ = 'jemy''''本例演示了壹個簡單的文件上傳。
這個例子裏面，sdk根據文件的大小選擇是Form方式上傳還是分片上傳。
1234567891011121314151617181920212223242526272829303132333435363738'''import qiniuaccessKey = "<Your Access Key>"secretKey = "<Your Secret Key>"#解析結果def parseRet(retData, respInfo):?if retData != None:?print("Upload file success!")?print("Hash: " + retData["hash"])?print("Key: " + retData["key"])?#檢查擴展參數?for k, v in retData.items():?if k[:2] == "x:":?print(k + ":" + v)?#檢查其他參數?for k, v in retData.items():?if k[:2] == "x:" or k == "hash" or k == "key":?continue?else:?print(k + ":" + str(v))?else:?print("Upload file failed!")?print("Error: " + respInfo.text_body)#無key上傳，http請求中不指定key參數def upload_without_key(bucket, filePath):?#生成上傳憑證?auth = qiniu.Auth(accessKey, secretKey)?upToken = auth.upload_token(bucket, key=None)?#上傳文件?retData, respInfo = qiniu.put_file(upToken, None, filePath)?#解析結果?parseRet(retData, respInfo)def main():?bucket = "if-pbl"?filePath = "/Users/jemy/Documents/jemy.png"?upload_without_key(bucket, filePath)if __name__ == "__main__":?main()運行結果為：
Upload file success!
Hash: Fp0XR6tM4yZmeiKXw7eZzmeyYsq8
Key: Fp0XR6tM4yZmeiKXw7eZzmeyYsq8
從上面我們可以看到，使用七牛的Python SDK上傳文件的最基本的步驟是：
1.生成上傳憑證
2.上傳文件
3.解析回復結果