Robotframework - Sauce Labs Plugin

This is a plugin for the SeleniumLibrary to help with using Sauce Labs.

This library is a plugin extension of the SeleniumLibrary. That means you can (in theory!) use all the keywords in the SeleniumLibrary in addition to the keywords added here. The keywords added are specifically meant for use with Sauce Labs.

Installation

You can install this package using pip:

pip install robotframework-saucelabs

Currently, there are two other dependencies you need to install for this package as well:

pip install saucebindings sa11y

This library is powered by the Python Sauce Bindings to connect and use Sauce Labs.

A requirement of using this library is to set environment variables for your Sauce username and access key.

Note that you must have the SeleniumLibrary installed as well.

Examples

Since this library is a plugin for the SeleniumLibrary, you need to add this as a plugin where you define using the SeleniumLibrary:

*** Settings ***
Library  SeleniumLibrary  plugins=SauceLabs

After defining this plugin, you can then use SauceLabs keywords in addition to SeleniumLibrary keywords:

*** Test Cases ***

Web Workflow Test
    # Use a SauceLabs keyword
    Start Latest Chrome On Sauce  https://www.saucedemo.com
    # Then you can use standard SeleniumLibrary keywords
    Input text  id:user-name  standard_user
    Input text  id:password  secret_sauce
    Click button  class:btn_action
    Page should contain element  id:shopping_cart_container
    # End with closing the session on Sauce
    [Teardown]  Stop Sauce Session  ${TEST_STATUS}

See the acceptance test for an example of usage, and the other tests for more examples.

Contribution

Contributors welcome! We need keywords, and if you are a robot and Sauce Labs user, please open pull requests and/or issues as needed!

Comments

Include Keywords of Specific Sauce Features

Some Sauce features such as extended debugging can be enabled easily using Selenium capabilities or using the Sauce Bindings. Adding keywords for these functionalities would be helpful for Sauce users.
hacktoberfest

opened by joshmgrant 0
Allow Data Centre to be Selected When Opening a Session

Sessions can be started by using the Open Browser style keywords, and selecting a data centre that has a separate keyword. Users would likely want to be able to select a data centre in the same keyword instead of needing to invoke a separate keyword.
hacktoberfest

opened by joshmgrant 0
Add Keywords for Starting Safari

Currently, there are keywords for starting a default browser session on Sauce Labs with (latest) Chrome or Firefox. It may be helpful to have keywords to also start the latest or next-to-latest Safari browsers on Sauce Labs.
good first issue hacktoberfest

opened by joshmgrant 0