gecko-dev/testing/mozbase/mozinstall
Mark Cote 1d00a51b85 Bug 713256 - Mirror mozbase changes for working properly on buildslaves into m-c r=ctalbert 2011-12-23 12:46:37 -05:00
..
mozinstall Bug 713256 - Mirror mozbase changes for working properly on buildslaves into m-c r=ctalbert 2011-12-23 12:46:37 -05:00
README.md
setup.py

README.md

Mozinstall is a python package for installing Mozilla applications on various platforms.

For example, depending on the platform, Firefox can be distributed as a zip, tar.bz2, exe or dmg file or cloned from a repository. Mozinstall takes the hassle out of extracting and/or running these files and for convenience returns the full path to the application's binary in the install directory. In the case that mozinstall is invoked from the command line, the binary path will be printed to stdout.

Usage

For command line options run mozinstall --help

Mozinstall's main function is the install method

import mozinstall
mozinstall.install('path_to_install_file', dest='path_to_install_folder')

The dest parameter defaults to the directory in which the install file is located. The install method accepts a third parameter called apps which tells mozinstall which binary to search for. By default it will search for 'firefox', 'thunderbird' and 'fennec' so unless you are installing a different application, this parameter is unnecessary.

Error Handling

Mozinstall throws two different types of exceptions:

  • mozinstall.InvalidSource is thrown when the source is not a recognized file type (zip, exe, tar.bz2, tar.gz, dmg)
  • mozinstall.InstallError is thrown when the installation fails for any reason. A traceback is provided.

Dependencies

Mozinstall depends on the mozinfo package which is also found in the mozbase repository.