用于从Mozilla服务器下载Firefox和Thunderbird构建的脚本。
项目描述
mozdownload
mozdownload 是一个 python 包，用于处理Mozilla应用程序的下载。
安装
如果工具仅用于下载应用程序，我们建议通过pip安装。以下命令将安装最新版本
pip install mozdownload
否则，按照以下步骤设置开发环境。建议与mozdownload一起使用 virtualenv 和 virtualenvwrapper。首先安装这些，然后 为项目创建一个虚拟环境。然后将我们的仓库fork到您的GitHub账户，并运行
git clone https://github.com/%your_account%/mozdownload.git
cd mozdownload
python setup.py develop
命令行使用
mozdownload 命令将根据提供的命令行选项下载应用程序。
示例
下载您平台上的最新官方Firefox版本
mozdownload --version=latest
下载您平台上的最新官方Firefox测试版版本
mozdownload --version=latest-beta
下载您平台上的最新官方Firefox ESR版本
mozdownload --version=latest-esr
下载您平台上的最新Firefox候选版本
mozdownload --type candidate --version=latest
下载Windows (32位) 的最新Firefox Aurora构建
mozdownload --type=daily --branch=mozilla-aurora --platform=win32
下载您平台上的最新官方Thunderbird版本
mozdownload --application=thunderbird --version=latest
下载Linux (64位) 的最新Earlybird构建
mozdownload --application=thunderbird --type=daily --branch=comm-aurora --platform=linux64
下载此README文件
mozdownload --url=https://raw.github.com/mozilla/mozdownload/master/README.md
从使用基本认证保护的基本URL下载文件
mozdownload --url=http://example.com/secrets.txt --username=admin --password=password
运行 mozdownload --help 获取关于命令行选项的详细信息。
命令行选项
要查看命令行选项的完整列表，执行以下命令并检查要下载的构建类型的选项列表
mozdownload --help
API
除了CLI mozdownload之外，它还提供了一个API可以使用。要创建特定的scraper实例，可以使用FactoryScraper类。以下是一些示例
# Create a release scraper for the German locale of Firefox 40.0.3
from mozdownload import FactoryScraper
scraper = FactoryScraper('release', version='40.0.3', locale='de')
# Create a candidate scraper for Windows 32bit of Firefox 41.0b9
from mozdownload import FactoryScraper
scraper = FactoryScraper('candidate', version='41.0b9', platform='win32')
# Create a daily scraper for the latest Dev Edition build on the current platform
from mozdownload import FactoryScraper
scraper = FactoryScraper('daily', branch='mozilla-aurora')
所有这些scraper实例都允许您检索用于下载文件的URL和本地目标文件的名称
from mozdownload import FactoryScraper
scraper = FactoryScraper('daily')
print(scraper.url)
print(scraper.filename)
要实际下载远程文件，必须调用download()方法
from mozdownload import FactoryScraper
scraper = FactoryScraper('daily')
filename = scraper.download()
测试
要运行整个测试套件以检查您的更改是否创建任何错误，请运行 tox。
如果您只运行非常具体的测试，请通过 tox -- -k <keyword> 指定它。例如，如果您只对查看tinderbox构建的测试感兴趣，请运行 tox -- -k tinderbox。 -k <keyword> 对文件夹、文件名甚至测试方法名称都有效。
下载文件
下载适合您平台的文件。如果您不确定选择哪个，请了解有关安装包的更多信息。