https://github.com/javan/blade-sauce_labs_plugin

https://github.com/javan/blade-sauce_labs_plugin

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/javan/blade-sauce_labs_plugin
• Owner: javan
• License: mit
• Created: 2015-06-22T23:49:02.000Z (over 9 years ago)
• Default Branch: main
• Last Pushed: 2021-01-20T18:21:50.000Z (almost 4 years ago)
• Last Synced: 2024-04-26T01:20:56.241Z (7 months ago)
• Language: Ruby
• Size: 81.2 MB
• Stars: 4
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
[Blade](https://github.com/javan/blade) plugin for [Sauce Labs](https://saucelabs.com/)

## Configuration

### Authenticate with Sauce Labs

Set the `SAUCE_USERNAME` and `SAUCE_ACCESS_KEY` environment variables to authenticate with Sauce Labs.

All CI tools provide a way to set environment variables for a test run. For non-CI test runs, set the environment variables in your shell or in your test runner script.

### Pick the browsers to run against

Rather than exhaustively list every permutation of devices, operating systems,

and browsers, we use a shorthand to match all the platforms we target.

Full example:

```yaml

plugins:

  sauce_labs:

    browsers:

      # Internet Explorer 11 on every device and operating system it supports.

      IE: 11

      # Latest two Chrome releases on all Mac and Windows platforms:

      Google Chrome:

        os: Mac, Windows

        version: -2

      # Latest two Firefox releases on every platform:

      Firefox:

        version: -2

      # Latest Safari release on every Mac platform (OS X 10.x):

      Safari:

        platform: Mac

        version: -1

      # Latest two Edge releases on every platform:

      Microsoft Edge:

        version: -2

      # Specific iOS Mobile Safari versions:

      iPhone:

        version: [9.2, 8.4]

      # Mobile-specific browser:

      Motorola Droid 4 Emulator:

        version: [5.1, 4.4]

```

See Sauce Labs' [Platform Configurator](https://wiki.saucelabs.com/display/DOCS/Platform+Configurator) for an exhaustive list of supported devices, operating systems, and browsers.

### Advanced configuration

For low-level Sauce Connect configuration, set `tunnel_args` to an array of command line arguments.

Example:

```yaml

plugins:

  sauce_labs:

    tunnel_args:

      - "--verbose"     # Turn on verbose logging.

      - "--vm-version"  # Use the varnish VM for WebSockets support.

      - "dev-varnish"

```

The plugin already sets the `--user`, `--api-key`, `--tunnel-identifier`, and `--readyfile` arguments, so don't set these yourself.

Full [Sauce Connect command line reference](https://wiki.saucelabs.com/pages/viewpage.action?pageId=48365781).