Backblaze B2软件开发包
b2sdk的Python项目详细描述
B2 Python软件开发工具包
这个存储库包含一个客户端库和一些方便的实用程序,可以轻松访问b2云存储的所有功能。
B2 command-line tool是一个示例,说明如何使用它来提供对b2服务的命令行访问,但是有许多可能的应用程序(包括fuse文件系统、备份应用程序的存储后端驱动程序等)。
安装
sdk可以使用以下组件安装:
pip install b2sdk
如果您看到消息说无法安装six
库,则
如果在os x el capitan上安装系统python,请尝试
这个:
pip install --ignore-installed b2sdk
版本策略
b2sdk遵循Semantic Versioning策略,因此本质上版本号是major.minor.patch(例如1.2.3)和:
- 当我们进行不兼容的api更改时,我们会增加主版本
- 当我们以向后兼容的方式添加功能时,会增加次要版本,并且
- 当我们进行向后兼容的错误修复时,我们会增加修补程序版本(除非有人依赖于修复错误的未记录行为)
因此,在将b2sdk设置为依赖项时,请确保与相应的版本匹配,例如,您可以将其放入您的requirements.txt
中,以确保您的代码与您的用户将从pypi获得的b2sdk
版本兼容:
b2sdk>=0.0.0,<1.0.0
发布历史记录
0.1.8(2019-06-28)
更改:
- 添加对b2_copy_文件的支持
0.1.6(2019-04-24)
更改:
- 修复传输程序在尝试空文件下载时崩溃的问题
- 将用于身份验证的帐户ID重命名为应用程序密钥ID。 帐户ID仍然向后兼容,只有术语 已经改变了。
0.1.4(2019-04-04)
sdk作为一个单独的包的最初正式发布(直到现在它还是b2 cli的一部分)
开发人员信息
我们鼓励外部贡献者在我们的代码库上执行更改。许多这样的变化已经被合并。为了便于贡献,本项目的核心开发人员:
- 提供指导(通过问题报告系统)
- 提供工具辅助代码检查(通过拉取请求系统)
- 维护一组集成测试(使用生产云运行)
- 维护一组(远远超过100个)单元测试
- 在14个版本的python上自动运行单元测试(包括osx、jython和pypy)
- 使用yapf自动格式化代码
- 使用静态代码分析查找可维护性方面的细微/潜在问题
- 维护其他持续集成工具(覆盖跟踪)
您需要安装一些python包。获取所有最新信息:
pip install --upgrade --upgrade-strategy eager -r requirements.txt -r requirements-test.txt -r requirements-setup.txt
有一个Makefile
规则可以使用当前活动的python运行单元测试:
make setup
make test
将安装所需的软件包,然后运行单元测试。
要在多个python虚拟环境中进行测试,请设置环境变量PYTHON_VIRTUAL_ENVS
以空格分隔的根目录列表。设置后,makefile将运行
每个环境中的单元测试。
在签入之前,使用pre-commit.sh
脚本检查代码格式,运行
单元测试、运行集成测试等。
集成测试需要主目录中名为.b2_auth
的文件。
其中包含两行,除了应用程序密钥ID和应用程序密钥之外没有任何内容:
applicationKeyId
applicationKey
我们用一种特殊的方式标记了代码中明显不如其他代码直观的地方。要查找它们的出现,请使用git grep '*magic*'
。