gecko-dev/testing/marionette/harness
Henrik Skupin 9a0cf91c1c Bug 1373635 - Application profile has only be reset if explicitly requested. r=ato
For both quit() and restart() methods the profile should not be reset,
unless it has been requested. The current behavior breaks various tests
which make use of quit() and session_start() and which assume that
previously set preferences are still set, eg. sessionrestore tests.

MozReview-Commit-ID: 4BxSSJPrTYF

--HG--
extra : rebase_source : 534c0608caf31c1e2cc256ad3fa8ae1972204603
2017-06-16 15:31:45 +02:00
..
marionette_harness Bug 1373635 - Application profile has only be reset if explicitly requested. r=ato 2017-06-16 15:31:45 +02:00
.flake8 Bug 1320073 - Rename marionette-client to marionette-harness and release version 4.0.0. r=gps,maja_zf,mtseng,SingingTree 2016-12-12 13:05:34 +01:00
MANIFEST.in Bug 1345274 - marionette-harness sdist package misses certificate files. r=ato 2017-03-08 12:17:43 +01:00
README.rst Bug 1320073 - Rename marionette-client to marionette-harness and release version 4.0.0. r=gps,maja_zf,mtseng,SingingTree 2016-12-12 13:05:34 +01:00
requirements.txt Bug 1323770 - Marionette should not take screenshots for skipped tests. r=maja_zf 2016-12-21 15:19:40 +01:00
setup.py Bug 1345274 - marionette-harness sdist package misses certificate files. r=ato 2017-03-08 12:17:43 +01:00

README.rst

marionette-harness
==================

Marionette is an automation driver for Mozilla's Gecko engine. It can remotely
control either the UI or the internal JavaScript of a Gecko platform, such as
Firefox. It can control both the chrome (i.e. menus and functions) or the
content (the webpage loaded inside the browsing context), giving a high level
of control and ability to replicate user actions. In addition to performing
actions on the browser, Marionette can also read the properties and attributes
of the DOM.

The marionette_harness package contains the test runner for Marionette, and
allows you to run automated tests written in Python for Gecko based
applications. Therefore it offers the necessary testcase classes, which are
based on the unittest framework.

For more information and the repository please checkout:

- home and docs: https://developer.mozilla.org/en-US/docs/Mozilla/QA/Marionette


Example
-------

The following command will run the tests as specified via a manifest file, or
test path, or test folder in Firefox:

    marionette --binary %path_to_firefox% [manifest_file | test_file | test_folder]

To get an overview about all possible option run `marionette --help`.