Qiniu Python SDK 使用教程

1. 项目的目录结构及介绍

Qiniu Python SDK 的目录结构如下：

qiniu-python-sdk/
├── README.md
├── setup.py
├── qiniu/
│   ├── __init__.py
│   ├── auth.py
│   ├── bucket.py
│   ├── conf.py
│   ├── http.py
│   ├── rpc.py
│   ├── storage.py
│   └── utils.py
└── tests/
    ├── __init__.py
    ├── test_auth.py
    ├── test_bucket.py
    ├── test_conf.py
    ├── test_http.py
    ├── test_rpc.py
    ├── test_storage.py
    └── test_utils.py

目录结构介绍

• README.md: 项目说明文档。
• setup.py: 用于安装和分发项目的脚本。
• qiniu/: 包含 SDK 的核心代码。
  • __init__.py: 初始化文件。
  • auth.py: 认证相关功能。
  • bucket.py: 存储空间相关功能。
  • conf.py: 配置文件。
  • http.py: HTTP 请求相关功能。
  • rpc.py: RPC 相关功能。
  • storage.py: 存储相关功能。
  • utils.py: 工具函数。
• tests/: 包含测试代码。
  • __init__.py: 初始化文件。
  • test_auth.py: 认证相关测试。
  • test_bucket.py: 存储空间相关测试。
  • test_conf.py: 配置文件相关测试。
  • test_http.py: HTTP 请求相关测试。
  • test_rpc.py: RPC 相关测试。
  • test_storage.py: 存储相关测试。
  • test_utils.py: 工具函数相关测试。

2. 项目的启动文件介绍

Qiniu Python SDK 的启动文件是 qiniu/__init__.py。这个文件负责初始化 SDK 并导入必要的模块。

启动文件内容

from .auth import Auth
from .bucket import Bucket
from .conf import Config
from .storage import BucketManager, PersistentFop, UploadManager
from .utils import urlsafe_base64_encode, urlsafe_base64_decode

__version__ = '7.8.0'

启动文件介绍

• Auth: 认证类，用于处理七牛云的认证逻辑。
• Bucket: 存储空间类，用于管理存储空间。
• Config: 配置类，用于配置 SDK 的行为。
• BucketManager: 存储空间管理类，提供存储空间管理功能。
• PersistentFop: 持久化操作类，用于处理持久化操作。
• UploadManager: 上传管理类，用于管理文件上传。
• urlsafe_base64_encode 和 urlsafe_base64_decode: 工具函数，用于处理 URL 安全的 Base64 编码和解码。

3. 项目的配置文件介绍

Qiniu Python SDK 的配置文件是 qiniu/conf.py。这个文件包含了 SDK 的全局配置。

配置文件内容

# -*- coding: utf-8 -*-

ACCESS_KEY = ''
SECRET_KEY = ''

# 默认上传服务器
UP_HOST = 'http://up.qiniug.com'

# 默认 API 服务器
API_HOST = 'http://api.qiniu.com'

# 默认 RSF 服务器
RSF_HOST = 'http://rsf.qbox.me'

# 默认 RS 服务器
RS_HOST = 'http://rs.qbox.me'

# 默认 IO 服务器
IO_HOST = 'http://iovip.qbox.me'

# 默认融合 CDN 服务器
FUSION_HOST = 'http://fusion.qiniuapi.com'

# 默认 UC 服务器
UC_HOST = 'http://uc.qbox.me'

# 默认 Zone 配置
ZONE_CN_East = {