Name Description Size
__init__.py 589
addons.py An API for installing and inspecting addons during Gecko runtime. This is a partially implemented wrapper around Gecko's `AddonManager API`_. For example:: from marionette_driver.addons import Addons addons = Addons(marionette) addons.install("/path/to/extension.xpi") .. _AddonManager API: https://developer.mozilla.org/en-US/Add-ons/Add-on_Manager 2579
by.py 897
date_time_value.py Interface for setting the value of HTML5 "date" and "time" input elements. Simple usage example: :: element = marionette.find_element(By.ID, "date-test") dt_value = DateTimeValue(element) dt_value.date = datetime(1998, 6, 2) 1564
decorators.py Decorator which checks the process status after the function has run. 2271
errors.py Raised when a generic non-recoverable exception has occured. 5050
expected.py This file provides a set of expected conditions for common use cases when writing Marionette tests. The conditions rely on explicit waits that retries conditions a number of times until they are either successfully met, or they time out. 9737
geckoinstance.py 24007
keys.py 2424
localization.py An API which allows Marionette to handle localized content. The `localization`_ of UI elements in Gecko based applications is done via entities and properties. For static values entities are used, which are located in .dtd files. Whereby for dynamically updated content the values come from .property files. Both types of elements can be identifed via a unique id, and the translated content retrieved. For example:: from marionette_driver.localization import L10n l10n = L10n(marionette) l10n.localize_entity(["chrome://branding/locale/brand.dtd"], "brandShortName") l10n.localize_property(["chrome://global/locale/findbar.properties"], "FastFind")) .. _localization: https://mzl.la/2eUMjyF 2322
marionette.py Enum-like class for mouse button constants. 74896
timeout.py Manage timeout settings in the Marionette session. Usage:: marionette = Marionette(...) marionette.start_session() marionette.timeout.page_load = 10 marionette.timeout.page_load # => 10 3128
transport.py Socket client that communciates with Marionette via TCP. It speaks the protocol of the remote debugger in Gecko, in which messages are always preceded by the message length and a colon, e.g.: 7:MESSAGE On top of this protocol it uses a Marionette message format, that depending on the protocol level offered by the remote server, varies. Supported protocol levels are `min_protocol_level` and above. 9742
wait.py An explicit conditional utility class for waiting until a condition evaluates to true or not null. This will repeatedly evaluate a condition in anticipation for a truthy return value, or its timeout to expire, or its waiting predicate to become true. A `Wait` instance defines the maximum amount of time to wait for a condition, as well as the frequency with which to check the condition. Furthermore, the user may configure the wait to ignore specific types of exceptions whilst waiting, such as `errors.NoSuchElementException` when searching for an element on the page. 6243