sauce_bindings 1.1.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ac45f63a4a484e6d4e5a60a31d5134a523533eabb46ac587517384307a1f84f
-  data.tar.gz: 43a328c5b629db206a6af37c77208e5370e547c6ee09239f112a45e77bc6c460
+  metadata.gz: d6fa82b7cd3b5e29fcfdb6e77f98f9dd7cb309d51523427de63e586b6094ac75
+  data.tar.gz: 8e8b4147c5a77459710f52cb36e927018050c34b4fff186960ddbb433ada23a7
 SHA512:
-  metadata.gz: c26b2b21b1550daedae332c11d5e7ca3efb1f90c349b60ea2e06c1f4f869bdf1908b4405ec8d3213c1f7160f6b077602847951f2ef5d6a30e7af6631bb2c0741
-  data.tar.gz: 3f911b1b2335fb00e7bb8fbe2d406907d40a3989edaf2860bccb5e2ab9de675185af71a8015ce96a4c48e12d393b5baf5c1f89bcb67458135be308fca948bd91
+  metadata.gz: 2b0970705b477b0df8ad01f5f162b8e64731b76396cbe6c2038f10a501a4d5769aedfa00e33429ca8f0fc2e905a0efd6187b09f3d4e2ceb9262334183f596bbc
+  data.tar.gz: d4336f5ef88d197a1995142fb7ceb36c6dfe69038d8ac2204cd9fe3e04e82eeef2ad810279c9403977b1b27014f56f72ac6805d4dc5299a5917e6bbf386e4e1c

data/.rubocop.yml

@@ -1,5 +1,5 @@
 AllCops:
-  TargetRubyVersion: 2.5.3
+  TargetRubyVersion: 2.7.5
 
 require:
   - rubocop-rspec
@@ -9,7 +9,7 @@ Layout/SpaceInsideHashLiteralBraces:
   EnforcedStyle: no_space
 
 Metrics/AbcSize:
-  Max: 25
+  Max: 27
 
 Metrics/BlockLength:
   Exclude:
@@ -22,14 +22,13 @@ Metrics/PerceivedComplexity:
   Max: 11
 
 Metrics/ClassLength:
-  Exclude:
-    - 'lib/sauce_bindings/options.rb'
+  Enabled: false
 
 Metrics/LineLength:
   Max: 120
 
 Metrics/MethodLength:
-  Max: 17
+  Max: 20
 
 Metrics/ModuleLength:
   CountComments: false
@@ -55,4 +54,11 @@ RSpec/MultipleExpectations:
   Enabled: false
 
 RSpec/DescribedClass:
-  EnforcedStyle: explicit
+  EnforcedStyle: explicit
+
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - 'spec/spec_helper.rb'
+
+Style/BlockDelimiters:
+  EnforcedStyle: braces_for_chaining

data/CHANGES.md

@@ -0,0 +1,46 @@
+### 1.3.0 - June 15, 2022
+
+* Fix links to work all data centers
+* Manage credentials in Options instead of Session
+* Deprecate using magic strings for stopping a session
+* Implement pausing — `Session#pause`
+* Implement commenting in Sauce command list — `Session#annotate` 
+* Implement logging control — `Session#enable_logs`, `Session#disable_logs` 
+* Implement network control — `Session#stop_network`, `Session#start_network`
+* Implement updating test information — `Session#change_name`, `Session#tags=`
+* Require Selenium 4 and Ruby 2.7
+
+### 1.2.1 - March 1, 2022
+
+* Added latest Windows and Mac platforms 
+
+### 1.2.0 - July 12, 2021
+
+* Accessibility functionality via Sa11y
+
+### 1.1.1 - July 10, 2021
+
+* `Options` class methods only allow setting valid options for the provided browser
+* `Options` class supports Edge browser
+* Support Selenium 4
+
+### 1.1.0 - May 30, 2021
+
+* Build Name support for Github Actions
+* APAC data center tentatively supported
+* Update `Options` to be constructed with class methods for browsers
+
+### 1.0.0 - April 24, 2020
+
+* Link to job on Sauce UI in STDOUT
+
+### 1.0.0.beta1 - March 10, 2020
+
+* `Options` class to construct capabilities
+* `Session` class to wrap driver instance
+* `Session#data_center=` to choose data center
+* `Options` automatically uses default value for `build` name
+* `Options` class accepts Selenium `Options` classes as argument
+* `Options` accepts serialized information via a `Hash`
+* `CapybaraSession` class for special Capybara support
+* Sauce options for `user` and `access_key` must be obtained by ENV variables

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019 Titus Fortner
+Copyright (c) 2019-2022 Sauce Labs
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,23 +1,13 @@
 # Sauce Bindings 
+
 ## A library for interacting with Sauce Labs using Ruby
 
 This gem is intended as a way to interact with Sauce Labs in an obvious and straightforward way. 
 
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'sauce_bindings'
-```
-
-And then execute:
+## User Installation & Usage
 
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install sauce_bindings
+Please see the [documentation on our website](https://opensource.saucelabs.com/sauce_bindings), 
+and select the "Ruby" tab for code examples. 
 
 ## Running Tests
 
@@ -25,79 +15,13 @@ To run tests for the Ruby Sauce Bindings, execute
 
     $ bundle exec rake
 
-## Usage
-
-`SauceBindings` is broken into two main components, `Options` and `Session`
-
-### Options class
-`Options` provides an easy interface to the Sauce Labs specific settings you want in your tests.
-
-If you want the default settings (the latest Chrome version on Windows 10) with no other settings,
-this is all the code you need:
-```
-sauce_opts = SauceBindings::Options.new
-```
-To specify additional 
-[Sauce Labs supported settings](https://wiki.saucelabs.com/display/DOCS/Test+Configuration+Options),
-simply pass these in as a `Hash`, or use an accessor:
-```
-sauce_options = {screen_resolution: '1080x720',
-                 browser_name: 'Firefox',
-                 platform_name: 'Mac OS'}
-sauce_opts = SauceBindings::Options.new(sauce_options)
-sauce_opts.idle_timeout = 100
-```
-if you have additional browser specific settings, or 
-[webdriver w3c spec compliant settings](http://w3c.github.io/webdriver/webdriver-spec.html#capabilities), in 
-Selenium 3.x you need to generate each of these separately; see the `Session` class below for how to use it:
-```
-sauce_options = SauceBindings::Options.new(screen_resolution: '1080x720',
-                                         browser_name: 'Firefox',
-                                         platform_name: 'Mac OS')
-
-selenium_options = Selenium::WebDriver::Remote::Capabilities.new(accept_insecure_certs: false,
-                                                                 page_load_strategy: 'eager'}
-
-browser_options = Selenium::WebDriver::Firefox::Options.new('args' => ['-foo'])
-```
-
-### Session class
-#### Intializing a Session
-`Session` class gets initialized with an `Options` instance. If you want the
-default settings (latest Chrome version on Windows 10), you don't even need to use an `Options` instance:
-```ruby
-@session = SauceBindings::Session.new
-```
-If you want something other than the default, create a Sauce `Option` instance (as generated in the section above,
-then pass it into the constructor:
-```ruby
-@session = SauceBindings::Session.new(sauce_opts)
-```
-If you also have Selenium or Browser options as described above, then you pass them in with an `Array` like so:
-```ruby
-@session = SauceBindings::Session.new([sauce_opts, se_opts, browser_opts])
-```
-
-#### Creating a driver instance
-The `#start` method is required, and will return a `Selenium::WebDriver::<Browser>::Driver` instance,
-and the `#stop` method will automatically quit the driver as well as ending the Sauce Labs session.
-```ruby
-session = SauceBindings::Session.new
-driver = session.start
-# Use the driver
-session.stop
-```
-Note that the `Driver` instance can also be obtained at any time with the `#driver` method:
-```ruby
-session = SauceBindings::Session.new
-session.start
-driver = session.driver
-# Use the driver
-session.stop
-```
-#### Additional Session methods
-We have a number of features we plan to add; stay tuned to see what additional features are made available. If you
-have any request, please contact the Sauce Labs Solution Architect team.
+## Building and Releasing
+
+Use `gem` instead of `rake` so that it isn't auto-tagged on github
+
+* Bump `SauceBindings::VERSION`
+* `$ gem build sauce_bindings.gemspec`
+* `$ gem push pkg/sauce_bindings-<VERSION>.gem`
 
 ## Contributing
 

data/Rakefile

@@ -5,4 +5,18 @@ require 'rspec/core/rake_task'
 
 RSpec::Core::RakeTask.new(:spec)
 
-task default: :spec
+task default: %i[examples unit integration]
+
+RSpec::Core::RakeTask.new(:unit) do |spec|
+  spec.pattern = 'spec/unit/*_spec.rb'
+end
+
+desc 'Run examples in parallel'
+task :examples do
+  system 'parallel_split_test spec/examples/*_spec.rb'
+end
+
+desc 'Run integration tests in parallel'
+task :integration do
+  system 'parallel_split_test spec/integration/*_spec.rb'
+end

data/lib/sauce_bindings/capybara_session.rb

@@ -15,9 +15,6 @@ module SauceBindings
     end
 
     def start
-      raise ArgumentError, "needs username; use `ENV['SAUCE_USERNAME']` or `Session#username=`" unless @username
-      raise ArgumentError, "needs access_key; use `ENV['SAUCE_ACCESS_KEY']` or `Session#access_key=`" unless @access_key
-
       @capybara_driver = Capybara.current_session.driver
       @driver = @capybara_driver.browser
     end

data/lib/sauce_bindings/errors.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module SauceBindings
+  class SessionNotStartedError < RuntimeError; end
+
+  class InvalidPlatformError < RuntimeError; end
+end

data/lib/sauce_bindings/logger.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module SauceBindings
+  #
+  # @example Enable full logging
+  #   SauceBindings.logger.level = :debug
+  #
+  # @example Log to file
+  #   SauceBindings.logger.output = 'webdrivers.log'
+  #
+  # @example Use logger manually
+  #   SauceBindings.logger.info('This is info message')
+  #   SauceBindings.logger.warn('This is warning message')
+  #
+  class Logger < Selenium::WebDriver::Logger
+    def initialize
+      super('SauceBindings')
+    end
+  end
+end

data/lib/sauce_bindings/options.rb

@@ -39,7 +39,7 @@ module SauceBindings
 
       def safari(**opts)
         opts[:browser_name] = 'safari'
-        opts[:platform_name] ||= 'macOS 11.00'
+        opts[:platform_name] ||= 'macOS 11'
         opts[:valid_options] = SafariConfigurations.valid_options
         Options.new(**opts)
       end
@@ -66,8 +66,9 @@ module SauceBindings
       valid_options = opts.delete(:valid_options)
       if valid_options.nil?
         valid_options = SAUCE + W3C
-        warn 'Using `Options.new(opts)` directly is deprecated, use static methods for desired browser instead; ' \
-        'e.g., `Options.chrome(opts)` or `Options.safari(opts)'
+        SauceBindings.logger.deprecate('Using `Options.new(opts)` directly',
+                                       'static methods for desired browser',
+                                       id: :options_init) { '(e.g., `Options.chrome(opts)`)' }
       end
 
       create_variables(valid_options, opts)
@@ -86,7 +87,13 @@ module SauceBindings
         value = parse_w3c_key(key)
         caps[self.class.camel_case(key)] = value unless value.nil?
       end
+
       caps['sauce:options'] = {}
+      caps['sauce:options']['username'] = ENV['SAUCE_USERNAME'] ||
+                                          raise(ArgumentError, "needs username; use `ENV['SAUCE_USERNAME']`")
+      caps['sauce:options']['accessKey'] = ENV['SAUCE_ACCESS_KEY'] ||
+                                           raise(ArgumentError, "needs access key; use `ENV['SAUCE_ACCESS_KEY']`")
+
       SAUCE.each do |key|
         value = parse_sauce_key(key)
         caps['sauce:options'][self.class.camel_case(key)] = value unless value.nil?
@@ -105,6 +112,14 @@ module SauceBindings
       end
     end
 
+    def mac?
+      @platform_name.include?('mac') || @platform_name.include?('OS X')
+    end
+
+    def windows?
+      @platform_name.include?('Windows')
+    end
+
     private
 
     def key_value(key)
@@ -120,8 +135,11 @@ module SauceBindings
         value.as_json
       elsif key == :timeouts
         if value
-          warn ':timeouts is deprecated, use :implicit_wait_timeout, :page_load_timeout or :script_timeout directly; ' \
-          '(ensure the values are set as seconds not milliseconds)'
+          SauceBindings.logger.deprecate(':timeouts',
+                                         ':implicit_wait_timeout, :page_load_timeout or :script_timeout;',
+                                         id: :timeouts) do
+            '(ensure the values are set as seconds not milliseconds)'
+          end
           value.transform_keys do |old_key|
             self.class.camel_case(old_key)
           end

data/lib/sauce_bindings/session.rb

@@ -1,17 +1,18 @@
 # frozen_string_literal: true
 
 require 'sauce_whisk'
+require 'sa11y/analyze'
 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_CENTRAL: 'ondemand.eu-central-1.saucelabs.com',
-                    APAC_SOUTHEAST: 'ondemand.apac-southeast-1.saucelabs.com'}.freeze
+    DATA_CENTERS = {US_WEST: 'us-west-1',
+                    US_EAST: 'us-east-1',
+                    EU_CENTRAL: 'eu-central-1',
+                    APAC_SOUTHEAST: 'apac-southeast-1'}.freeze
 
     attr_writer :url
-    attr_reader :driver, :options, :data_center
+    attr_reader :driver, :options, :data_center, :session_id
     attr_accessor :http_client, :listener
 
     def initialize(options = nil, data_center: nil, http_client: nil, listener: nil)
@@ -19,27 +20,25 @@ module SauceBindings
       @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
+      @session_id = @driver.session_id
+      @driver
     end
 
     def stop(result)
       return if @driver.nil?
 
-      SauceWhisk::Jobs.change_status(@driver.session_id, result)
-      # Add output for the Sauce OnDemand Jenkins plugin
-      # The first print statement will automatically populate links on Jenkins to Sauce
-      # The second print statement will output the job link to logging/console
-      puts "SauceOnDemandSessionID=#{@driver.session_id} job-name=#{@options.name}"
-      puts "Test Job Link: https://app.saucelabs.com/tests/#{@driver.session_id}"
+      unless result.is_a?(TrueClass) || result.is_a?(FalseClass)
+        raise ArgumentError, 'Result must be a boolean value representing whether a test has passed'
+      end
+
+      SauceWhisk::Jobs.change_status(@session_id, result)
+      print_results
+
       @driver.quit
     end
 
@@ -53,15 +52,96 @@ module SauceBindings
       @data_center = data_center
     end
 
+    def accessibility_results(js_lib: nil, frames: true, cross_origin: false)
+      validate_session_started('accessibility_results')
+      sa11y = Sa11y::Analyze.new(driver, js_lib: js_lib, frames: frames, cross_origin: cross_origin)
+      sa11y.results
+    end
+
+    def annotate(comment)
+      validate_session_started('annotate')
+      driver.execute_script("sauce:context=#{comment}")
+    end
+
+    def pause
+      validate_session_started('pause')
+      driver.execute_script('sauce: break')
+      puts "\nThis test has been stopped; no more driver commands will be accepted"
+      puts "\nYou can take manual control of the test from the Sauce Labs UI here: #{test_link}"
+      @driver = nil
+    end
+
+    def disable_logging
+      validate_session_started('disable_logging')
+      driver.execute_script('sauce: disable log')
+    end
+
+    def enable_logging
+      validate_session_started('enable_logging')
+      driver.execute_script('sauce: enable log')
+    end
+
+    def stop_network
+      validate_session_started('stop_network')
+      unless options.mac?
+        error = "Can only start or stop the network on a Mac; current platform is: #{options.platform_name}"
+        raise InvalidPlatformError, error
+      end
+
+      driver.execute_script('sauce: stop network')
+    end
+
+    def start_network
+      validate_session_started('start_network')
+      unless options.mac?
+        error = "Can only start or stop the network on a Mac; current platform is: #{options.platform_name}"
+        raise InvalidPlatformError, error
+      end
+
+      driver.execute_script('sauce: start network')
+    end
+
+    def change_name(name)
+      validate_session_started('change_name')
+
+      driver.execute_script("sauce:job-name=#{name}")
+    end
+
+    def add_tags(tags)
+      tags = Array(tags)
+      validate_session_started('tags=')
+      @driver.execute_script("sauce:job-tags=#{tags.join(',')}")
+    end
+
     def url
-      @url ||= "https://#{@username}:#{@access_key}@#{DATA_CENTERS[data_center]}:443/wd/hub"
+      @url ||= "https://ondemand.#{DATA_CENTERS[data_center]}.saucelabs.com/wd/hub"
     end
 
     def to_selenium
-      caps = {url: url, desired_capabilities: options.capabilities}
+      caps = {url: url, capabilities: Selenium::WebDriver::Remote::Capabilities.new(options.capabilities)}
       caps[:listener] = listener if listener
       caps[:http_client] = http_client if http_client
       caps
     end
+
+    private
+
+    def test_link
+      dc = data_center == :US_WEST ? '' : "#{DATA_CENTERS[data_center]}."
+      "https://app.#{dc}saucelabs.com/tests/#{@session_id}"
+    end
+
+    def validate_session_started(method)
+      raise SessionNotStartedError, "session must be started before executing ##{method}" unless @driver
+    end
+
+    def print_results
+      # Add output for the Sauce OnDemand Jenkins plugin
+      # The first print statement will automatically populate links on Jenkins to Sauce
+      # The second print statement will output the job link to logging/console
+      puts "SauceOnDemandSessionID=#{@session_id} job-name=#{@options.name}"
+
+      puts "Test Job Link: #{test_link}"
+    end
   end
 end

data/lib/sauce_bindings/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SauceBindings
-  VERSION = '1.1.1'
+  VERSION = '1.3.0'
 end

data/lib/sauce_bindings.rb

@@ -2,6 +2,7 @@
 
 require 'sauce_bindings/version'
 require 'sauce_bindings/options'
+require 'sauce_bindings/errors'
 require 'sauce_bindings/session'
 require 'sauce_bindings/base_configurations'
 require 'sauce_bindings/vdc_configurations'
@@ -10,3 +11,10 @@ require 'sauce_bindings/edge_configurations'
 require 'sauce_bindings/firefox_configurations'
 require 'sauce_bindings/ie_configurations'
 require 'sauce_bindings/safari_configurations'
+require 'sauce_bindings/logger'
+
+module SauceBindings
+  def self.logger
+    @logger ||= Logger.new
+  end
+end

data/sauce_bindings.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.version       = SauceBindings::VERSION
   spec.authors       = ['Titus Fortner']
   spec.email         = ['titusfortner@gmail.com']
-  spec.required_ruby_version = '>= 2.5.0'
+  spec.required_ruby_version = '>= 2.7.0'
 
   spec.summary       = 'Simple interface for interacting with Sauce Labs.'
   spec.description   = 'Reduces complexity in user code for running Selenium tests on Sauce Labs'
@@ -22,13 +22,14 @@ Gem::Specification.new do |spec|
 
   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 'climate_control', '~> 1.1'
+  spec.add_development_dependency 'parallel_split_test', '~> 0.10'
+  spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'rubocop', '~> 1.0'
-  spec.add_development_dependency 'rubocop-performance'
   spec.add_development_dependency 'rubocop-rspec', '~> 2.0'
   spec.add_development_dependency 'webmock', '~> 3.5'
 
-  spec.add_runtime_dependency 'sauce_whisk'
-  spec.add_runtime_dependency 'selenium-webdriver', '>= 3.142.7'
+  spec.add_runtime_dependency 'sa11y', '~> 0.2.0'
+  spec.add_runtime_dependency 'sauce_whisk', '~> 0.3.2'
+  spec.add_runtime_dependency 'selenium-webdriver', '~> 4.0'
 end

data/spec/examples/accessibility_spec.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'sauce_bindings'
+require 'rspec'
+
+describe 'Create Session' do
+  it 'starts session' do
+    # 1. Create Session object with the desired Data Center
+    session = SauceBindings::Session.new
+
+    # 2. Start Session to get the Driver
+    driver = session.start
+
+    # 3. Use the driver in your tests just like normal
+    driver.get('https://www.saucedemo.com/')
+
+    # 4a. Get accessibility default results with frame support
+    session.accessibility_results
+
+    # 4b. Get accessibility default results without frame support
+    session.accessibility_results(frames: false)
+
+    # 4c. Get accessibility results with cross origin frame support
+    session.accessibility_results(cross_origin: true)
+
+    # 4d. Get accessibility results with a different version of Axe Core JS Library
+    session.accessibility_results(js_lib: File.read(File.expand_path('axe.min.js', __dir__)))
+
+    # 5. Stop the Session with whether the test passed or failed
+    session.stop(true)
+  end
+end

data/spec/examples/axe.min.js

@@ -0,0 +1 @@
+// Blank file

data/spec/examples/browser_options_spec.rb

@@ -6,10 +6,10 @@ require 'rspec'
 describe 'Browser Options' do
   it 'creates session' do
     # 1. Create Selenium Browser Options instance
-    browser_options = Selenium::WebDriver::Firefox::Options.new(args: ['--foo'])
+    browser_options = Selenium::WebDriver::Chrome::Options.new(args: ['--start-fullscreen'])
 
     # 2. Create Sauce Options object with the Browser Options object instance
-    sauce_options = SauceBindings::Options.firefox(selenium_options: browser_options)
+    sauce_options = SauceBindings::Options.chrome(selenium_options: browser_options)
 
     # 3. Create Session object with SauceOptions object instance
     session = SauceBindings::Session.new(sauce_options)

data/spec/examples/{basic_options_spec.rb → common_options_spec.rb}

@@ -3,11 +3,12 @@
 require 'sauce_bindings'
 require 'rspec'
 
-describe 'Basic Options' do
+describe 'Common Options' do
   it 'creates session' do
-    # 1. Create a SauceOptions instance with the 3 primary parameters
+    # 1. Create Options instance with common w3c options
     sauce_options = SauceBindings::Options.firefox(browser_version: '88.0',
-                                                   platform_name: 'Windows 8')
+                                                   platform_name: 'Windows 8',
+                                                   unhandled_prompt_behavior: 'ignore')
 
     # 2. Create Session object with SauceOptions object instance
     session = SauceBindings::Session.new(sauce_options)

data/spec/examples/sauce_options_spec.rb

@@ -7,7 +7,7 @@ describe 'Sauce Options' do
   it 'creates session' do
     # 1. Create a SauceOptions instance with Sauce Labs Specific Options
     sauce_options = SauceBindings::Options.firefox(extended_debugging: true,
-                                                   idle_timeout: 100,
+                                                   idle_timeout: 45,
                                                    time_zone: 'Alaska')
 
     # 2. Create Session object with SauceOptions object instance