Go to file
Dustin 471392106f Refactor as package, add py.typed file
In order to indicate to external modules that this module contains type
hints, it must include a `py.typed` file.  Single-file module
distributions cannot include other files, so in order to distribute the
`py.typed` file, this module has to be distributed as a package.
2022-04-30 14:22:22 -05:00
doc Initial commit 2022-04-29 20:05:56 -05:00
src/aiomarionette Refactor as package, add py.typed file 2022-04-30 14:22:22 -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
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 Begin v0.0.2 2022-04-30 14:22:22 -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.