Skip to content
Mozilla UI automation tool
Find file
Pull request Compare This branch is 703 commits behind mozilla:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
jsbridge
mozmill
mozprocess
mozprofile
mozrunner
.gitignore
README.md
setup_development.sh

README.md

Mozmill

Mozmill is a UI Automation framework for Mozilla apps like Firefox and Thunderbird. It's both an addon and a Python command-line tool. The addon provides an IDE for writing and running the JavaScript tests and the Python package provides a mechanism for running the tests from the command line as well as providing a way to test restarting the application.

Installation

Install the command-line client via either setuptools or pip (detailed instructions): pip install mozmill

To work with the development version of Mozmill, check out the code from the Github repo: git clone http://github.com/mozautomation/mozmill.git cd mozmill ./setup_development.sh

Usage

After installing the Python package you can run Mozmill with the mozmill command: mozmill -t ~/tests/testBookmarks.js

Python Packages

Mozmill uses several Python packages:

mozmill

Runs Mozmill

mozprofile

Creates and manages user profiles for Mozilla apps: from mozprofile import FirefoxProfile

# create new profile to pass to mozmill/mozrunner
profile = FirefoxProfile(addons=["adblock.xpi"])

mozrunner

Handles start/stop automation of Mozilla applications: from mozrunner import FirefoxRunner

# start Firefox on a new profile
runner = FirefoxRunner()
runner.start()

mozprocess

Generic OS process management.

jsbridge

Python to JavaScript bridge used by Mozmill to communicate test run information.

Something went wrong with that request. Please try again.