The Tor Browser / file comparison
comparison: testing/marionette/client/README.md
testing/marionette/client/README.md
- changeset 0
- 6474c204b198
equal
deleted
inserted
replaced
| -1:000000000000 | 0:2161042a43cb |
|---|---|
| 1 <!-- This Source Code Form is subject to the terms of the Mozilla Public | |
| 2 - License, v. 2.0. If a copy of the MPL was not distributed with this | |
| 3 - file, You can obtain one at http://mozilla.org/MPL/2.0/. --> | |
| 4 | |
| 5 # Marionette Client | |
| 6 | |
| 7 [Marionette](https://developer.mozilla.org/en/Marionette) is a | |
| 8 Mozilla project to enable remote automation in Gecko-based projects, | |
| 9 including desktop Firefox, mobile Firefox, and Boot-to-Gecko. | |
| 10 | |
| 11 It utilizes the [remote-debugger](https://wiki.mozilla.org/Platform/JSDebugv2) | |
| 12 inside Gecko for the transport layer of the Marionette server. The commands | |
| 13 the Marionette server will eventually implement are based on | |
| 14 Selenium's [JSON Wire Protocol](http://code.google.com/p/selenium/wiki/JsonWireProtocol), | |
| 15 although not all commands are presently implemented, and additional commands | |
| 16 will likely be added. | |
| 17 | |
| 18 ## Package Files | |
| 19 | |
| 20 - client.py: This is the Marionette socket client; it speaks the same | |
| 21 socket protocol as the Gecko remote debugger. | |
| 22 - marionette.py: The Marionette client. This uses client.py to communicate | |
| 23 with a server that speaks the Gecko remote debugger protocol. | |
| 24 This allows Selenium tests to utilize Marionette. | |
| 25 - testserver.py: A socket server which mimics the remote debugger in | |
| 26 Gecko, and can be used to test pieces of the Marionette client. | |
| 27 - test_protocol.py: Tests the Marionette JSON Protocol by using testserver.py. | |
| 28 | |
| 29 ## Installation | |
| 30 | |
| 31 You'll need the ManifestDestiny and MozHttpd packages from Mozbase: | |
| 32 | |
| 33 git clone git://github.com/mozilla/mozbase.git | |
| 34 cd mozbase | |
| 35 python setup_development.py | |
| 36 | |
| 37 Other than that, there are no special requirements. | |
| 38 | |
| 39 | |
| 40 ## Writing and Running Tests Using Marionette | |
| 41 | |
| 42 See [Writing Marionette tests](https://developer.mozilla.org/en/Marionette/Tests), | |
| 43 and [Running Marionette tests](https://developer.mozilla.org/en/Marionette/Running_Tests). | |
| 44 |
