Metadata-Version: 2.1
Name: BrowserAutomator
Version: 1.0.3
Summary: A package to simplify browser automation
Home-page: https://github.com/edekadigital/BrowserAutomator
Author: EDEKA DIGITAL
License: UNKNOWN
Description: # BrowserAutomator [![Build Status](https://travis-ci.org/edekadigital/BrowserAutomator.svg?branch=master)](https://travis-ci.org/edekadigital/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:
        - `zoom`: given a percentage (e.g. 50%), zooms to the specified view
        - `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"
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.3
Description-Content-Type: text/markdown
