Go to file

Dustin 05248e69f1 Add License, repository URL		2022-08-01 22:30:15 -05:00
doc	Initial commit	2022-04-29 20:05:56 -05:00
src/aiomarionette	connect: Correctly handle IPv4 addresses	2022-08-01 22:25:39 -05:00
.flake8	Initial commit	2022-04-29 20:05:56 -05:00
.gitattributes	Initial commit	2022-04-29 20:05:56 -05:00
.gitignore	Initial commit	2022-04-29 20:05:56 -05:00
.pylintrc	Initial commit	2022-04-29 20:05:56 -05:00
LICENSE-Apache-2.0.txt	Add License, repository URL	2022-08-01 22:30:15 -05:00
README.md	Initial commit	2022-04-29 20:05:56 -05:00
poetry.lock	Initial commit	2022-04-29 20:05:56 -05:00
pyproject.toml	Add License, repository URL	2022-08-01 22:30:15 -05:00

README.md

FireFox Marionette Client for asyncio

aiomarionette provides an asynchronous client interface for the Firefox Marionette remote control protocol.

Usage

To use aiomarionette, create an instance of the Marionette class. By default, the cclient will attempt to connect to the Marionette socket on the local machine, port 2828. You can specify the host and/or port arguments to change this. Be sure to call the connect method first, before calling any of the command methods.

async with aiomarionette.Marionette() as mn:
    mn.connect()
    mn.navigate('https://getfirefox.com/')

Compared to marionette_driver

The official Python client for Firefox Marionette is marionette_driver. Although it is more complete than aiomarionette (at least for now), it only provides a blocking API.

Unlike marionette_driver, aiomarionette does not currently support launching Firefox directly. You must explicity start a Firefox process in Marionette mode before connecting to it with aiomarionette.