Name Description Size
__init__.py 549
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 2540
by.py 857
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) 1524
decorators.py Decorator which checks the process status after the function has run. 2214
errors.py Raised when a generic non-recoverable exception has occured. 5189
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. 9691
geckoinstance.py 27198
keys.py 2320
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 2282
marionette.py Enum-like class for mouse button constants. 81851
processhandler.py A class for launching and manipulating local processes. :param cmd: command to run. May be a string or a list. If specified as a list, the first element will be interpreted as the command, and all additional elements will be interpreted as arguments to that command. :param args: list of arguments to pass to the command (defaults to None). Must not be set when `cmd` is specified as a list. :param cwd: working directory for command (defaults to None). :param env: is the environment to use for the process (defaults to os.environ). :param kill_on_timeout: when True, the process will be killed when a timeout is reached. When False, the caller is responsible for killing the process. Failure to do so could cause a call to wait() to hang indefinitely. (Defaults to True.) :param processOutputLine: function or list of functions to be called for each line of output produced by the process (defaults to an empty list). :param processStderrLine: function or list of functions to be called for each line of error output - stderr - produced by the process (defaults to an empty list). If this is not specified, stderr lines will be sent to the *processOutputLine* callbacks. :param onTimeout: function or list of functions to be called when the process times out. :param onFinish: function or list of functions to be called when the process terminates normally without timing out. :param kwargs: additional keyword args to pass directly into Popen. NOTE: Child processes will be tracked by default. 21465
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 3087
transport.py Object that guards access to a socket via a lock. The socket must be accessed using this object as a context manager; access to the socket outside of a context will bypass the lock. 13683
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. 6206
webauthn.py 2572