BrowserAutomator 1.0.1

A package to simplify browser automation

BrowserAutomator

BrowserAutomator is a package to help you easily control websites using a simple YAML configuration.

Installation

Using pip for Python 3: pip install BrowserAutomator

Configuration

setup yml

In these files you can specify actions that are run in the given order when the utility is started.

The following actions are available:

• wait: given a time unit (seconds, minutes, hours, days) and an amount of time, blockingly waits for the amount of time

• load: given an url, opens the site in the current tab

• new_tab: given an url, opens the site in a new tab

• switch_tabs: given the index of a tab, switches to the specified tab

• interact: given the type of an html element and its name (and content), the element gets clicked on if no content tag is given. Otherwise it get treated like a text field and the content is used as input

  The following types are available: id, name, class, css, xpath, tag_name

• for_every: given a list of urls and a list of actions, runs the actions on every url. Urls in load and new_tab actions are replaced by the current url

loop yml

In these files you can specify actions that loop after the setup ran once. The following actions are available:

• repeat every: given a time unit (seconds, minutes, hours, days) and an amount of time, restarts the script every n seconds/minutes/...
• fix wifi: given a time unit and an amount of time, checks every n seconds/minutes/... if the network is working, and restarts the script if it doesn't
• switch tabs: given a time unit and an amount of time, switches the next tab every n seconds/minutes/... If the last tab is reached, it goes back to the first

Usage

In Python:

• from BrowserAutomator.setup import run
• run([your_setup_yml_filenames], [your_loop_yml_filenames], your_chromedriver_path) the default Chromedriver path is "/usr/lib/chromium-browser/chromedriver"