Skip to main content

Script to download builds for Firefox and Thunderbird from the Mozilla server.

Project description

mozdownload

mozdownload is a python package which handles downloading of Mozilla applications.

Coverage Issues

Installation

If the tool should only be used for downloading applications we propose to install it via pip. The following command will install the latest release:

pip install mozdownload

Otherwise follow the steps below to setup a development environment. It is recommended that virtualenv and virtualenvwrapper be used in conjunction with mozdownload. Start by installing these, and creating a virtualenv for the project. Then fork our repository into your own github account, and run:

git clone https://github.com/%your_account%/mozdownload.git
cd mozdownload
python setup.py develop

Command Line Usage

The mozdownload command will download the application based on the provided command line options.

Examples

Download the latest official Firefox release for your platform:

mozdownload --version=latest

Download the latest official Firefox beta release for your platform:

mozdownload --version=latest-beta

Download the latest official Firefox esr release for your platform:

mozdownload --version=latest-esr

Download the latest Firefox release candidate for your platform:

mozdownload --type candidate --version=latest

Download the latest Firefox Aurora build for Windows (32bit):

mozdownload --type=daily --branch=mozilla-aurora --platform=win32

Download the latest official Thunderbird release for your platform:

mozdownload --application=thunderbird --version=latest

Download the latest Earlybird build for Linux (64bit):

mozdownload --application=thunderbird --type=daily --branch=comm-aurora --platform=linux64

Download this README file:

mozdownload --url=https://raw.github.com/mozilla/mozdownload/master/README.md

Download a file from a URL protected with basic authentication:

mozdownload --url=http://example.com/secrets.txt --username=admin --password=password

Run mozdownload --help for detailed information on the command line options.

Command Line Options

To see the full list of command line options, execute the command below and check the list of options for the build type to download:

mozdownload --help

API

Beside the CLI mozdownload also offers an API to be used. To create specific instances of scrapers the FactoryScraper class can be used. Here some examples:

# 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')

All those scraper instances allow you to retrieve the url which is used to download the files, and the filename for the local destination:

from mozdownload import FactoryScraper
scraper = FactoryScraper('daily')
print(scraper.url)
print(scraper.filename)

To actually download the remote file the download() method has to be called:

from mozdownload import FactoryScraper
scraper = FactoryScraper('daily')
filename = scraper.download()

Testing

To run the entire test suite to check if your changes create any errors, run tox.

If you only run very specific tests, please specify it via tox -- -k <keyword>. For example, if you are only interested in tests that look at release builds, run tox -- -k release. The -k <keyword> works for folders, filenames and even names of test methods.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mozdownload-1.30.0.tar.gz (24.6 kB view details)

Uploaded Source

Built Distribution

mozdownload-1.30.0-py3-none-any.whl (26.0 kB view details)

Uploaded Python 3

File details

Details for the file mozdownload-1.30.0.tar.gz.

File metadata

  • Download URL: mozdownload-1.30.0.tar.gz
  • Upload date:
  • Size: 24.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.11.3

File hashes

Hashes for mozdownload-1.30.0.tar.gz
Algorithm Hash digest
SHA256 037a20d8f378bc5323ac6ca2e037bba756622156a4bb2a20bcfa64440cd54ece
MD5 2061e4147af0dd3daf046fb65ef4a9aa
BLAKE2b-256 9cc4a7d2fbb4ab3cb0910ab17ac6653122f0f1d1721eea5783fb895152b1feae

See more details on using hashes here.

File details

Details for the file mozdownload-1.30.0-py3-none-any.whl.

File metadata

  • Download URL: mozdownload-1.30.0-py3-none-any.whl
  • Upload date:
  • Size: 26.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.11.3

File hashes

Hashes for mozdownload-1.30.0-py3-none-any.whl
Algorithm Hash digest
SHA256 96f36b7741cb3d839b581801a1365434579cc36aa11905e08095c56066e18977
MD5 5109c2afd5f44ce35509f743dc2d7fe4
BLAKE2b-256 f4d8c25fb7780cd75fef232e2f9749e6fe38d756c0b5a71aec7498c10970c13f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page