sauce_bindings 1.0.0.beta1

data/lib/sauce_bindings/session.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'sauce_whisk'
+require 'selenium-webdriver'
+
+module SauceBindings
+  class Session
+    DATA_CENTERS = {US_WEST: 'ondemand.us-west-1.saucelabs.com',
+                    US_EAST: 'ondemand.us-east-1.saucelabs.com',
+                    EU_VDC: 'ondemand.eu-central-1.saucelabs.com'}.freeze
+
+    attr_writer :url
+    attr_reader :driver, :options, :data_center
+    attr_accessor :http_client, :listener
+
+    def initialize(options = nil, data_center: nil, http_client: nil, listener: nil)
+      @options = options || Options.new
+      @http_client = http_client
+      @listener = listener
+
+      @username = ENV['SAUCE_USERNAME']
+      @access_key = ENV['SAUCE_ACCESS_KEY']
+      self.data_center = data_center || :US_WEST
+    end
+
+    def start
+      raise ArgumentError, "needs username; use `ENV['SAUCE_USERNAME']`" unless @username
+      raise ArgumentError, "needs access_key; use `ENV['SAUCE_ACCESS_KEY']`" unless @access_key
+
+      @driver = Selenium::WebDriver.for :remote, to_selenium
+    end
+
+    def stop(result)
+      return if @driver.nil?
+
+      SauceWhisk::Jobs.change_status(@driver.session_id, result)
+      @driver.quit
+    end
+
+    def data_center=(data_center)
+      unless DATA_CENTERS.key?(data_center)
+        msg = "#{data_center} is an invalid data center; specify :US_WEST, :US_EAST or :EU_VDC"
+        raise ArgumentError, msg
+      end
+
+      SauceWhisk.data_center = data_center
+      @data_center = data_center
+    end
+
+    def url
+      @url ||= "https://#{@username}:#{@access_key}@#{DATA_CENTERS[data_center]}:443/wd/hub"
+    end
+
+    def to_selenium
+      caps = {url: url, desired_capabilities: options.capabilities}
+      caps[:listener] = listener if listener
+      caps[:http_client] = http_client if http_client
+      caps
+    end
+  end
+end

data/lib/sauce_bindings/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module SauceBindings
+  VERSION = '1.0.0.beta1'
+end

data/sauce_bindings.gemspec

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift lib unless $LOAD_PATH.include?(lib)
+require 'sauce_bindings/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'sauce_bindings'
+  spec.version       = SauceBindings::VERSION
+  spec.authors       = ['Titus Fortner']
+  spec.email         = ['titusfortner@gmail.com']
+
+  spec.summary       = 'Simple interface for interacting with Sauce Labs.'
+  spec.description   = 'Reduces complexity in user code for running Selenium tests on Sauce Labs'
+  spec.homepage      = 'https://github.com/saucelabs/sauce_bindings'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split("\n")
+  spec.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'capybara', '~> 3.16'
+  spec.add_development_dependency 'rake', '>= 12.3.3'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop', '~>0.66'
+  spec.add_development_dependency 'rubocop-performance'
+  spec.add_development_dependency 'rubocop-rspec', '~>1.32'
+  spec.add_development_dependency 'webmock', '~> 3.5'
+
+  spec.add_runtime_dependency 'sauce_whisk'
+  spec.add_runtime_dependency 'selenium-webdriver', '~> 3.142.0', '>= 3.142.7'
+end

data/spec/capybara_session_spec.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'webmock/rspec'
+require 'sauce_bindings/capybara_session'
+
+module SauceBindings
+  describe CapybaraSession do
+    let(:valid_response) do
+      {status: 200,
+       body: {value: {sessionId: '0', capabilities: Selenium::WebDriver::Remote::Capabilities.chrome}}.to_json,
+       headers: {"content_type": 'application/json'}}
+    end
+    let(:default_capabilities) do
+      {browserName: 'chrome',
+       browserVersion: 'latest',
+       platformName: 'Windows 10',
+       'sauce:options': {build: 'TEMP BUILD: 11'}}
+    end
+
+    def expect_request(body: nil, endpoint: nil)
+      body = (body || {desiredCapabilities: default_capabilities,
+                       capabilities: {firstMatch: [default_capabilities]}}).to_json
+      endpoint ||= 'https://ondemand.us-west-1.saucelabs.com/wd/hub/session'
+      stub_request(:post, endpoint).with(body: body).to_return(valid_response)
+    end
+
+    before do
+      ENV['BUILD_TAG'] = ''
+      ENV['BUILD_NAME'] = 'TEMP BUILD'
+      ENV['BUILD_NUMBER'] = '11'
+      ENV['SAUCE_USERNAME'] = 'foo'
+      ENV['SAUCE_ACCESS_KEY'] = '123'
+    end
+
+    after do
+      ENV.delete 'BUILD_TAG'
+      ENV.delete 'BUILD_NAME'
+      ENV.delete 'BUILD_NUMBER'
+      ENV.delete 'SAUCE_USERNAME'
+      ENV.delete 'SAUCE_ACCESS_KEY'
+    end
+
+    describe '#new' do
+      it 'registers a Capybara Driver' do
+        CapybaraSession.new
+
+        expect(Capybara.drivers).to include(:sauce)
+        expect(Capybara.current_driver).to eq :sauce
+      end
+    end
+
+    describe '#start' do
+      it 'starts the session with Capybara driver' do
+        expect_request
+
+        driver = CapybaraSession.new.start
+        expect(driver).to eq Capybara.current_session.driver.browser
+
+        Capybara.current_session.driver.instance_variable_set('@browser', nil)
+      end
+    end
+
+    describe '#stop' do
+      it 'quits the driver' do
+        cappy_driver = instance_double(Capybara::Selenium::Driver)
+        driver = instance_double(Selenium::WebDriver::Remote::Driver, session_id: '1234')
+        allow(cappy_driver).to receive(:browser).and_return(driver)
+
+        allow(SauceWhisk::Jobs).to receive(:change_status).with('1234', true)
+
+        session = CapybaraSession.new
+
+        allow(Capybara.current_session).to receive(:driver).and_return(cappy_driver)
+        allow(Capybara.current_session).to receive(:quit)
+
+        session.start
+        session.stop(true)
+
+        expect(SauceWhisk::Jobs).to have_received(:change_status).with('1234', true)
+        expect(Capybara.current_session).to have_received(:quit)
+
+        Capybara.current_session.driver.instance_variable_set('@browser', nil)
+      end
+    end
+  end
+end

data/spec/options.yml

@@ -0,0 +1,56 @@
+example_values:
+  browser_name: 'firefox'
+  browser_version: '123'
+  platform_name: 'Mac'
+  accept_insecure_certs: true
+  page_load_strategy: 'eager'
+  set_window_rect: true
+  unhandled_prompt_behavior: "accept"
+  strict_file_interactability: true
+  timeouts:
+    implicit: 1
+    page_load: 59
+    script: 29
+  avoid_proxy: true
+  build: 'Sample Build Name'
+  capture_performance: true
+  chromedriver_version: '71'
+  command_timeout: 2
+  custom_data:
+    foo: 'foo'
+    bar: 'bar'
+  extended_debugging: true
+  idle_timeout: 3
+  iedriver_version: '3.141.0'
+  max_duration: 300
+  name: 'Sample Test Name'
+  parent_tunnel: 'Mommy'
+  prerun:
+    executable: "http://url.to/your/executable.exe"
+    args:
+      - --silent
+      - -a
+      - -q
+    background: false
+    timeout: 120
+  priority: 0
+  public: 'team'
+  record_logs: false
+  record_screenshots: false
+  record_video: false
+  screen_resolution: '10x10'
+  selenium_version: '3.141.59'
+  tags:
+    - foo
+    - bar
+    - foobar
+  time_zone: 'San Francisco'
+  tunnel_identifier: 'tunnelname'
+  video_upload_on_pass: false
+
+invalid_option:
+  foo: "bar"
+  browser_name: "firefox"
+  browser_version: "70"
+  platform_name: "MacOS 10.12"
+  record_screenshots: false

data/spec/options_spec.rb

@@ -0,0 +1,470 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+module SauceBindings
+  describe Options do
+    before do
+      ENV['BUILD_TAG'] = ''
+      ENV['BUILD_NAME'] = 'TEMP BUILD'
+      ENV['BUILD_NUMBER'] = '11'
+    end
+
+    after { ENV.delete 'BUILD_TAG' }
+
+    describe '#new' do
+      let(:default_options) do
+        {'browserName' => 'chrome',
+         'browserVersion' => 'latest',
+         'platformName' => 'Windows 10',
+         'sauce:options' => {'build' => 'TEMP BUILD: 11'}}
+      end
+
+      it 'uses latest Chrome version on Windows 10 by default' do
+        options = Options.new
+
+        expect(options.browser_name).to eq 'chrome'
+        expect(options.browser_version).to eq 'latest'
+        expect(options.platform_name).to eq 'Windows 10'
+      end
+
+      it 'accepts provided values for browser, browser version and platform name' do
+        options = Options.new(browser_name: 'firefox',
+                              browser_version: '123',
+                              platform_name: 'Mac')
+
+        expect(options.browser_name).to eq 'firefox'
+        expect(options.browser_version).to eq '123'
+        expect(options.platform_name).to eq 'Mac'
+      end
+
+      it 'accepts other w3c values' do
+        proxy = Selenium::WebDriver::Proxy.new(ssl: 'foo')
+        timeouts = {implicit: 1,
+                    page_load: 59,
+                    script: 29}
+        options = Options.new(accept_insecure_certs: true,
+                              page_load_strategy: 'eager',
+                              proxy: proxy,
+                              set_window_rect: true,
+                              unhandled_prompt_behavior: 'accept',
+                              strict_file_interactability: true,
+                              timeouts: timeouts)
+
+        expect(options.accept_insecure_certs).to eq true
+        expect(options.page_load_strategy).to eq 'eager'
+        expect(options.proxy).to eq proxy
+        expect(options.set_window_rect).to eq true
+        expect(options.unhandled_prompt_behavior).to eq 'accept'
+        expect(options.strict_file_interactability).to eq true
+        expect(options.timeouts).to eq timeouts
+      end
+
+      it 'accepts Sauce Labs specific settings' do
+        custom_data = {foo: 'foo',
+                       bar: 'bar'}
+        prerun = {executable: 'http://url.to/your/executable.exe',
+                  args: ['--silent', '-a', '-q'],
+                  background: false,
+                  timeout: 120}
+        tags = %w[foo bar foobar]
+        sauce_options = {
+          avoid_proxy: true,
+          build: 'Sample Build Name',
+          capture_performance: true,
+          chromedriver_version: '71',
+          command_timeout: 2,
+          custom_data: custom_data,
+          extended_debugging: true,
+          idle_timeout: 3,
+          iedriver_version: '3.141.0',
+          max_duration: 300,
+          name: 'Sample Test Name',
+          parent_tunnel: 'Mommy',
+          prerun: prerun,
+          priority: 0,
+          public: 'team',
+          record_logs: false,
+          record_screenshots: false,
+          record_video: false,
+          screen_resolution: '10x10',
+          selenium_version: '3.141.59',
+          tags: tags,
+          time_zone: 'San Francisco',
+          tunnel_identifier: 'tunnelname',
+          video_upload_on_pass: false
+        }
+
+        options = Options.new(**sauce_options)
+
+        expect(options.avoid_proxy).to eq true
+        expect(options.build).to eq 'Sample Build Name'
+        expect(options.capture_performance).to eq true
+        expect(options.chromedriver_version).to eq '71'
+        expect(options.command_timeout).to eq 2
+        expect(options.custom_data).to eq custom_data
+        expect(options.extended_debugging).to eq true
+        expect(options.idle_timeout).to eq 3
+        expect(options.iedriver_version).to eq '3.141.0'
+        expect(options.max_duration).to eq 300
+        expect(options.name).to eq 'Sample Test Name'
+        expect(options.parent_tunnel).to eq 'Mommy'
+        expect(options.prerun).to eq prerun
+        expect(options.priority).to eq 0
+        expect(options.public).to eq 'team'
+        expect(options.record_logs).to eq false
+        expect(options.record_screenshots).to eq false
+        expect(options.record_video).to eq false
+        expect(options.screen_resolution).to eq '10x10'
+        expect(options.selenium_version).to eq '3.141.59'
+        expect(options.tags).to eq tags
+        expect(options.time_zone).to eq 'San Francisco'
+        expect(options.tunnel_identifier).to eq 'tunnelname'
+        expect(options.video_upload_on_pass).to eq false
+      end
+
+      it 'accepts Selenium Capabilities and overrides default browser' do
+        caps = Selenium::WebDriver::Remote::Capabilities.firefox(accept_insecure_certs: true,
+                                                                 page_load_strategy: 'eager')
+        options = Options.new(selenium_options: caps)
+
+        expect(options.browser_name).to eq 'firefox'
+        expect(options.accept_insecure_certs).to eq true
+        expect(options.page_load_strategy).to eq 'eager'
+      end
+
+      it 'accepts Selenium Options and overrides default browser' do
+        browser_opts = Selenium::WebDriver::Firefox::Options.new(args: ['--foo'])
+        options = Options.new(selenium_options: browser_opts)
+
+        expect(options.browser_name).to eq 'firefox'
+        expect(options.selenium_options['moz:firefoxOptions']).to eq('args' => ['--foo'])
+      end
+
+      it 'accepts Selenium Capabilities and Options class instances' do
+        caps = Selenium::WebDriver::Remote::Capabilities.chrome(accept_insecure_certs: true,
+                                                                page_load_strategy: 'eager')
+        browser_opts = Selenium::WebDriver::Chrome::Options.new(args: ['--foo'])
+        options = Options.new(selenium_options: [caps, browser_opts])
+
+        expect(options.page_load_strategy).to eq 'eager'
+        expect(options.accept_insecure_certs).to eq true
+        expect(options.selenium_options['goog:chromeOptions']).to eq('args' => ['--foo'])
+      end
+
+      it 'accepts W3C, Sauce, Browser Options and Capabilities at the same time' do
+        caps = Selenium::WebDriver::Remote::Capabilities.chrome(page_load_strategy: 'eager')
+        browser_opts = Selenium::WebDriver::Firefox::Options.new(args: ['--foo'])
+
+        options = Options.new(browser_version: '77',
+                              accept_insecure_certs: true,
+                              command_timeout: 2,
+                              time_zone: 'Alaska',
+                              selenium_options: [caps, browser_opts])
+
+        expect(options.browser_name).to eq 'firefox'
+        expect(options.browser_version).to eq '77'
+        expect(options.platform_name).to eq 'Windows 10'
+        expect(options.accept_insecure_certs).to eq true
+        expect(options.command_timeout).to eq 2
+        expect(options.time_zone).to eq 'Alaska'
+        expect(options.page_load_strategy).to eq 'eager'
+
+        expect(options.selenium_options['moz:firefoxOptions']).to eq('args' => ['--foo'])
+      end
+
+      it 'creates a default build value' do
+        options = Options.new
+        expect(options.build).to eq 'TEMP BUILD: 11'
+      end
+
+      it 'raises ArgumentError if parameter is not recognized as valid' do
+        expect { Options.new(foo: 'bar') }.to raise_exception(ArgumentError)
+      end
+    end
+
+    describe '#accessors' do
+      it 'parses w3c values' do
+        proxy = Selenium::WebDriver::Proxy.new(ssl: 'foo')
+        timeouts = {implicit: 1,
+                    page_load: 59,
+                    script: 29}
+
+        options = Options.new
+
+        options.browser_name = 'firefox'
+        options.browser_version = '7'
+        options.platform_name = 'macOS 10.14'
+        options.accept_insecure_certs = true
+        options.page_load_strategy = 'eager'
+        options.proxy = proxy
+        options.set_window_rect = true
+        options.unhandled_prompt_behavior = 'accept'
+        options.strict_file_interactability = true
+        options.timeouts = timeouts
+
+        expect(options.browser_name).to eq 'firefox'
+        expect(options.browser_version).to eq '7'
+        expect(options.platform_name).to eq 'macOS 10.14'
+        expect(options.accept_insecure_certs).to eq true
+        expect(options.page_load_strategy).to eq 'eager'
+        expect(options.proxy).to eq proxy
+        expect(options.set_window_rect).to eq true
+        expect(options.unhandled_prompt_behavior).to eq 'accept'
+        expect(options.strict_file_interactability).to eq true
+        expect(options.timeouts).to eq timeouts
+      end
+
+      it 'parses Sauce values' do
+        custom_data = {foo: 'foo',
+                       bar: 'bar'}
+        prerun = {executable: 'http://url.to/your/executable.exe',
+                  args: ['--silent', '-a', '-q'],
+                  background: false,
+                  timeout: 120}
+        tags = %w[foo bar foobar]
+
+        options = Options.new
+
+        options.avoid_proxy = true
+        options.build = 'Sample Build Name'
+        options.capture_performance = true
+        options.chromedriver_version = '71'
+        options.command_timeout = 2
+        options.custom_data = custom_data
+        options.extended_debugging = true
+        options.idle_timeout = 3
+        options.iedriver_version = '3.141.0'
+        options.max_duration = 300
+        options.name = 'Sample Test Name'
+        options.parent_tunnel = 'Mommy'
+        options.prerun = prerun
+        options.priority = 0
+        options.public = 'team'
+        options.record_logs = false
+        options.record_screenshots = false
+        options.record_video = false
+        options.screen_resolution = '10x10'
+        options.selenium_version = '3.141.59'
+        options.tags = tags
+        options.time_zone = 'San Francisco'
+        options.tunnel_identifier = 'tunnelname'
+        options.video_upload_on_pass = false
+
+        expect(options.avoid_proxy).to eq true
+        expect(options.build).to eq 'Sample Build Name'
+        expect(options.capture_performance).to eq true
+        expect(options.chromedriver_version).to eq '71'
+        expect(options.command_timeout).to eq 2
+        expect(options.custom_data).to eq custom_data
+        expect(options.extended_debugging).to eq true
+        expect(options.idle_timeout).to eq 3
+        expect(options.iedriver_version).to eq '3.141.0'
+        expect(options.max_duration).to eq 300
+        expect(options.name).to eq 'Sample Test Name'
+        expect(options.parent_tunnel).to eq 'Mommy'
+        expect(options.prerun).to eq prerun
+        expect(options.priority).to eq 0
+        expect(options.public).to eq 'team'
+        expect(options.record_logs).to eq false
+        expect(options.record_screenshots).to eq false
+        expect(options.record_video).to eq false
+        expect(options.screen_resolution).to eq '10x10'
+        expect(options.selenium_version).to eq '3.141.59'
+        expect(options.tags).to eq tags
+        expect(options.time_zone).to eq 'San Francisco'
+        expect(options.tunnel_identifier).to eq 'tunnelname'
+        expect(options.video_upload_on_pass).to eq false
+      end
+    end
+
+    describe '#merge_capabilities' do
+      it 'loads options from configuration' do
+        timeouts = {implicit: 1,
+                    page_load: 59,
+                    script: 29}
+        custom_data = {foo: 'foo',
+                       bar: 'bar'}
+        prerun = {executable: 'http://url.to/your/executable.exe',
+                  args: ['--silent', '-a', '-q'],
+                  background: false,
+                  timeout: 120}
+        tags = %w[foo bar foobar]
+
+        options = Options.new
+        yaml = YAML.load_file('spec/options.yml')
+        options.merge_capabilities(yaml['example_values'])
+
+        expect(options.browser_name).to eq 'firefox'
+        expect(options.browser_version).to eq '123'
+        expect(options.platform_name).to eq 'Mac'
+        expect(options.accept_insecure_certs).to eq true
+        expect(options.page_load_strategy).to eq 'eager'
+        expect(options.set_window_rect).to eq true
+        expect(options.unhandled_prompt_behavior).to eq 'accept'
+        expect(options.strict_file_interactability).to eq true
+        expect(options.timeouts).to eq timeouts
+        expect(options.avoid_proxy).to eq true
+        expect(options.build).to eq 'Sample Build Name'
+        expect(options.capture_performance).to eq true
+        expect(options.chromedriver_version).to eq '71'
+        expect(options.command_timeout).to eq 2
+        expect(options.custom_data).to eq custom_data
+        expect(options.extended_debugging).to eq true
+        expect(options.idle_timeout).to eq 3
+        expect(options.iedriver_version).to eq '3.141.0'
+        expect(options.max_duration).to eq 300
+        expect(options.name).to eq 'Sample Test Name'
+        expect(options.parent_tunnel).to eq 'Mommy'
+        expect(options.prerun).to eq prerun
+        expect(options.priority).to eq 0
+        expect(options.public).to eq 'team'
+        expect(options.record_logs).to eq false
+        expect(options.record_screenshots).to eq false
+        expect(options.record_video).to eq false
+        expect(options.screen_resolution).to eq '10x10'
+        expect(options.selenium_version).to eq '3.141.59'
+        expect(options.tags).to eq tags
+        expect(options.time_zone).to eq 'San Francisco'
+        expect(options.tunnel_identifier).to eq 'tunnelname'
+        expect(options.video_upload_on_pass).to eq false
+      end
+
+      it 'raises exception if value not recognized' do
+        options = Options.new
+        yaml = YAML.load_file('spec/options.yml')
+
+        msg = 'foo is not a valid parameter for Options class'
+        expect { options.merge_capabilities(yaml['invalid_option']) }.to raise_exception(ArgumentError, msg)
+      end
+    end
+
+    describe '#capabilities' do
+      it 'correctly generates capabilities for w3c values' do
+        proxy = Selenium::WebDriver::Proxy.new(ssl: 'foo')
+        timeouts = {implicit: 1,
+                    page_load: 59,
+                    script: 29}
+
+        options = Options.new(browser_name: 'firefox',
+                              platform_name: 'Mac',
+                              accept_insecure_certs: true,
+                              page_load_strategy: 'eager',
+                              proxy: proxy,
+                              set_window_rect: true,
+                              unhandled_prompt_behavior: 'accept',
+                              strict_file_interactability: true,
+                              timeouts: timeouts)
+
+        expect(options.capabilities).to eq('browserName' => 'firefox',
+                                           'browserVersion' => 'latest',
+                                           'platformName' => 'Mac',
+                                           'acceptInsecureCerts' => true,
+                                           'pageLoadStrategy' => 'eager',
+                                           'proxy' => {'proxyType' => 'MANUAL', 'sslProxy' => 'foo'},
+                                           'setWindowRect' => true,
+                                           'unhandledPromptBehavior' => 'accept',
+                                           'strictFileInteractability' => true,
+                                           'timeouts' => {'implicit' => 1,
+                                                          'pageLoad' => 59,
+                                                          'script' => 29},
+                                           'sauce:options' => {'build' => 'TEMP BUILD: 11'})
+      end
+
+      it 'correctly generates capabilities for sauce values' do
+        custom_data = {foo: 'foo',
+                       bar: 'bar'}
+        prerun = {executable: 'http://url.to/your/executable.exe',
+                  args: ['--silent', '-a', '-q'],
+                  background: false,
+                  timeout: 120}
+        tags = %w[foo bar foobar]
+        sauce_options = {avoid_proxy: true,
+                         build: 'Sample Build Name',
+                         capture_performance: true,
+                         chromedriver_version: '71',
+                         command_timeout: 2,
+                         custom_data: custom_data,
+                         extended_debugging: true,
+                         idle_timeout: 3,
+                         iedriver_version: '3.141.0',
+                         max_duration: 300,
+                         name: 'Sample Test Name',
+                         parent_tunnel: 'Mommy',
+                         prerun: prerun,
+                         priority: 0,
+                         public: 'team',
+                         record_logs: false,
+                         record_screenshots: false,
+                         record_video: false,
+                         screen_resolution: '10x10',
+                         selenium_version: '3.141.59',
+                         tags: tags,
+                         time_zone: 'San Francisco',
+                         tunnel_identifier: 'tunnelname',
+                         video_upload_on_pass: false}
+
+        options = Options.new(**sauce_options)
+
+        prerun_caps = {'executable' => 'http://url.to/your/executable.exe',
+                       'args' => ['--silent', '-a', '-q'],
+                       'background' => false,
+                       'timeout' => 120}
+
+        expect(options.capabilities).to eq('browserName' => 'chrome',
+                                           'browserVersion' => 'latest',
+                                           'platformName' => 'Windows 10',
+                                           'sauce:options' => {'build' => 'Sample Build Name',
+                                                               'avoidProxy' => true,
+                                                               'capturePerformance' => true,
+                                                               'chromedriverVersion' => '71',
+                                                               'commandTimeout' => 2,
+                                                               'customData' => {'foo' => 'foo',
+                                                                                'bar' => 'bar'},
+                                                               'extendedDebugging' => true,
+                                                               'idleTimeout' => 3,
+                                                               'iedriverVersion' => '3.141.0',
+                                                               'maxDuration' => 300,
+                                                               'name' => 'Sample Test Name',
+                                                               'parentTunnel' => 'Mommy',
+                                                               'prerun' => prerun_caps,
+                                                               'priority' => 0,
+                                                               'public' => 'team',
+                                                               'recordLogs' => false,
+                                                               'recordScreenshots' => false,
+                                                               'recordVideo' => false,
+                                                               'screenResolution' => '10x10',
+                                                               'seleniumVersion' => '3.141.59',
+                                                               'tags' => %w[foo bar foobar],
+                                                               'timeZone' => 'San Francisco',
+                                                               'tunnelIdentifier' => 'tunnelname',
+                                                               'videoUploadOnPass' => false})
+      end
+
+      it 'correctly generates capabilities for selenium object values' do
+        caps = Selenium::WebDriver::Remote::Capabilities.chrome(accept_insecure_certs: true,
+                                                                page_load_strategy: 'eager')
+        browser_opts = Selenium::WebDriver::Chrome::Options.new(args: ['--foo'])
+        options = Options.new(selenium_options: [caps, browser_opts])
+
+        jwp_defaults = {'cssSelectorsEnabled' => true,
+                        'javascriptEnabled' => true,
+                        'nativeEvents' => false,
+                        'platform' => 'ANY',
+                        'rotatable' => false,
+                        'takesScreenshot' => false,
+                        'version' => ''}
+
+        expected_caps = {'browserName' => 'chrome',
+                         'browserVersion' => 'latest',
+                         'platformName' => 'Windows 10',
+                         'acceptInsecureCerts' => true,
+                         'pageLoadStrategy' => 'eager',
+                         'sauce:options' => {'build' => 'TEMP BUILD: 11'},
+                         'goog:chromeOptions' => {'args' => ['--foo']}}
+
+        expect(options.capabilities).to eq(jwp_defaults.merge(expected_caps))
+      end
+    end
+  end
+end