История

William Lachance 596b5333bd Bug 1002619 - Fix syntax error in Marionette's setup.py. r=ato		2014-04-28 14:34:29 -04:00
..
docs	Bug 956803 - Fix busted autogen docs, r=wlach	2014-01-15 15:18:23 +08:00
marionette	Bug 1002039 - fix virtualenv download code, r=mdas	2014-04-28 20:55:33 -07:00
MANIFEST.in	Bug 993478 - Let a user select docroot for the webserver, r=jgriffin	2014-04-10 13:02:23 -04:00
README.md	Bug 756233: Removing Selenium proxy from marionette r=jgriffin	2012-05-22 07:09:46 -07:00
requirements.txt	Bug 902711 - Make marionette_transport its own package, r=ato	2013-10-14 17:58:40 -07:00
setup.py	Bug 1002619 - Fix syntax error in Marionette's setup.py. r=ato	2014-04-28 14:34:29 -04:00

README.md

Marionette Client

Marionette is a Mozilla project to enable remote automation in Gecko-based projects, including desktop Firefox, mobile Firefox, and Boot-to-Gecko.

It utilizes the remote-debugger inside Gecko for the transport layer of the Marionette server. The commands the Marionette server will eventually implement are based on Selenium's JSON Wire Protocol, although not all commands are presently implemented, and additional commands will likely be added.

Package Files

client.py: This is the Marionette socket client; it speaks the same socket protocol as the Gecko remote debugger.
marionette.py: The Marionette client. This uses client.py to communicate with a server that speaks the Gecko remote debugger protocol. This allows Selenium tests to utilize Marionette.
testserver.py: A socket server which mimics the remote debugger in Gecko, and can be used to test pieces of the Marionette client.
test_protocol.py: Tests the Marionette JSON Protocol by using testserver.py.

Installation

You'll need the ManifestDestiny and MozHttpd packages from Mozbase:

git clone git://github.com/mozilla/mozbase.git
cd mozbase
python setup_development.py

Other than that, there are no special requirements.

Writing and Running Tests Using Marionette

See Writing Marionette tests, and Running Marionette tests.