Metadata-Version: 1.0
Name: mozrunner
Version: 5.1
Summary: Reliable start/stop/configuration of Mozilla Applications (Firefox, Thunderbird, etc.)
Home-page: http://github.com/mozautomation/mozmill
Author: Mikeal Rogers, Mozilla
Author-email: mikeal.rogers@gmail.com
License: MPL 1.1/GPL 2.0/LGPL 2.1
Description: <!-- This Source Code Form is subject to the terms of the Mozilla Public
        - License, v. 2.0. If a copy of the MPL was not distributed with this
        - file, You can obtain one at http://mozilla.org/MPL/2.0/. -->
        
        [mozrunner](https://github.com/mozilla/mozbase/tree/master/mozrunner)
        is a [python package](http://pypi.python.org/pypi/mozrunner)
        which handles running of Mozilla applications.
        mozrunner utilizes [mozprofile](/en/Mozprofile)
        for managing application profiles
        and [mozprocess](/en/Mozprocess) for robust process control.
        
        mozrunner may be used from the command line or programmatically as an API.
        
        
        # Command Line Usage
        
        The `mozrunner` command will launch the application (specified by
        `--app`) from a binary specified with `-b` or as located on the `PATH`.
        
        mozrunner takes the command line options from
        [mozprofile](/en/Mozprofile) for constructing the profile to be used by
        the application.
        
        Run `mozrunner --help` for detailed information on the command line
        program.
        
        
        # API Usage
        
        mozrunner features a base class,
        [mozrunner.runner.Runner](https://github.com/mozilla/mozbase/blob/master/mozrunner/mozrunner/runner.py)
        which is an integration layer API for interfacing with Mozilla applications.
        
        mozrunner also exposes two application specific classes,
        `FirefoxRunner` and `ThunderbirdRunner` which record the binary names
        necessary for the `Runner` class to find them on the system.
        
        Example API usage:
        
        from mozrunner import FirefoxRunner
        
        # start Firefox on a new profile
        runner = FirefoxRunner()
        runner.start()
        
        See also a comparable implementation for [selenium](http://seleniumhq.org/):
        http://code.google.com/p/selenium/source/browse/trunk/py/selenium/webdriver/firefox/firefox_binary.py
Platform: Any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Mozilla Public License 1.1 (MPL 1.1)
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
