This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

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

Project Description

[![PyPI version](https://badge.fury.io/py/mozdownload.svg)](http://badge.fury.io/py/mozdownload) [![Coverage Status](https://coveralls.io/repos/github/mozilla/mozdownload/badge.svg)](https://coveralls.io/github/mozilla/mozdownload) [![Build Status](https://travis-ci.org/mozilla/mozdownload.svg?branch=master)](https://travis-ci.org/mozilla/mozdownload) [![Stories in Ready](https://badge.waffle.io/mozilla/mozdownload.png?label=ready&title=Ready)](https://waffle.io/mozilla/mozdownload)

# mozdownload

[mozdownload](https://github.com/mozilla/mozdownload) is a [python package](http://pypi.python.org/pypi/mozdownload) which handles downloading of Mozilla applications.

## 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](http://virtualenv.readthedocs.org/en/latest/installation.html) and [virtualenvwrapper](http://virtualenvwrapper.readthedocs.org/en/latest/) be used in conjunction with mozdownload. Start by installing these. Then first 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

More detailed developer documentation can be found in the [wiki](https://github.com/mozilla/mozdownload/wiki).

## 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 tinderbox builds, run tox -- -k tinderbox. The -k <keyword> works for folders, filenames and even names of test methods.

Release History

Release History

This version
History Node

1.22

History Node

1.21

History Node

1.20.2

History Node

1.20.1

History Node

1.19

History Node

1.18.1

History Node

1.18

History Node

1.17

History Node

1.16

History Node

1.15

History Node

1.14

History Node

1.13

History Node

1.12

History Node

1.11.1

History Node

1.10

History Node

1.9

History Node

1.8

History Node

1.7.2

History Node

1.7.1

History Node

1.7

History Node

1.6

History Node

1.5

History Node

1.4

History Node

1.3

History Node

1.2

History Node

1.1

History Node

1.0

History Node

1.10sdist

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
mozdownload-1.22-py2-none-any.whl (23.3 kB) Copy SHA256 Checksum SHA256 py2 Wheel Mar 15, 2017
mozdownload-1.22.tar.gz (16.7 kB) Copy SHA256 Checksum SHA256 Source Mar 15, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting