gecko-dev/testing/marionette/harness
Henrik Skupin 67e8ef4b57 Bug 1397734 - Centralize defaults for socket and startup timeouts r=maja_zf
Currently defaults for startup_timeout and socket_timeout are defined
at two different places (Marionette driver and harness). As of now it's
even the case that startup_timeout has different values. While Marionette
driver uses 120s, the harness only uses 60s.

As result all jobs which are based on the Marionette harness fail if
Firefox starts-up slowly like for debug builds.

MozReview-Commit-ID: Dl4sBG1H7NA

--HG--
extra : rebase_source : 688338b1782deaf08eb01c7c5d4ca01ba03328f5
2017-09-07 15:36:50 +02:00
..
marionette_harness Bug 1397734 - Centralize defaults for socket and startup timeouts r=maja_zf 2017-09-07 15:36:50 +02:00
.flake8 Bug 1395126 - Support cascading configuration for flake8, r=bc 2017-08-29 17:32:31 -04: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 1366199 - Release marionette-harness 4.1 and marionette-driver 2.3.0. r=maja_zf 2017-06-28 10:18:13 -07:00
setup.py Bug 1345274 - marionette-harness sdist package misses certificate files. r=ato 2017-03-08 12:17:43 +01:00

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`.