黑莓操作系统工具,蟒蛇
bbarchivist的Python项目详细描述
一个python 3.2+包,用于各种黑莓10/黑莓android相关功能和脚本。
打包的可执行文件
从2.3.0版(2015年12月18日)起,大多数脚本在GitHub上打包为windows可执行文件。
要使用,只需下载最新版本附带的bbarchivist-<;version>;-<;system bit>;存档文件,解压缩到某个位置并双击可执行文件即可。
可执行文件是用PyInstaller准备的。由于Universal CRT,从windows 10和python 3.5+开始分发它们需要windows 10 sdk。
或者,如果您需要完整的功能或linux/mac/bsd支持,请继续阅读。
安装
需要python>;=3.2,首选3.7或更高版本。
要获得最新的稳定版本,请使用pip安装:
$ pip install bbarchivist
如果您想要最新的开发版本,请从git克隆并使用setuptools安装:
$ git clone https://github.com/thurask/bbarchivist.git $ cd bbarchivist $ python setup.py install
如果有Git LFS,数据文件将自动下载。
如果没有git lfs,则运行此文件夹中的download_dats.py
脚本。
对于git,数据文件将被视为不同的,因此请注意。
python库
此库需要 Requests, appdirs, 和Beautiful Soup 4 图书馆。gpg支持需要python-gnupg库。
python 3.2还需要shutilwhich。 在python 3.3+上安装shutilwhich没有效果,因此没有必要。
可选的simplejson模块安装在python 3.3+上,用于改进 处理json的性能。
为了更安全地处理xml,安装了可选的defusedxml模块。 如果使用的是python 3.2或3.3,请使用defusedxml 0.4.1。
测试
如果您想自己运行测试,还需要pytest
和httmock。使用pip从requirements-devel.txt
文件安装。
如果您在python 3.2上进行测试,也可以安装mock backport。
覆盖范围要求安装pytest-cov。
测试gnupg/7-zip函数首先需要设置gnupg/7-zip。
贡献
如果您希望为本项目做出贡献,请执行以下操作:
- 从github派生和克隆源(需要Git LFS)
- 确保所有测试都在您的系统上运行(需要GPG,7-ZIP)
- 在不中断任何测试的情况下对新分支进行更改,并为新代码添加测试(如果适用)
- 在github上打开拉取请求
许可证
版权所有2015-2018 thurask<;thuraski@hotmail.com>; 这项工作是免费的。您可以在 “做你想做的事”的条款,第二版, 由Sam Hocevar出版。有关详细信息,请参阅许可证文件。