testcentricity_web 2.2.1 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a22d10e0a98ccb67cbad9cbd9b53ec13aca5e5a8
-  data.tar.gz: 080382fb259e781f11dbdd2482273c990dc89abc
+  metadata.gz: ad3e1644f9aadc806902d2980e39b0082cca13df
+  data.tar.gz: 554500bbda1bd296e2d8b7607d6f513fb050c7c6
 SHA512:
-  metadata.gz: 8deb7b3f53d6e059a1fecceb37054b8818b28c1f50c627769d6b2e0e21fa6acc9e4ce3d0b99423cabafb1da729b3b396fdfebf31b3031b8c236db48dc1b22cf5
-  data.tar.gz: 6b504a926fb6d58edd47331207fb5af0185eba4d84eb50f0eac39be82e7193ad836606fa74665e8226a60253cb9a3733f6c77802a51317ec28eb1ca067f9957b
+  metadata.gz: 8468742f8cf244605a697cb536fe4b6c10fdac707df726b0251c7e8a4ccb8d37ff64a2e1592cfdf1c4afe7f1c25db631c44bbd3310b62c80c8a9f48d56f27caa
+  data.tar.gz: 7b5a456238bf4c3fbffb9e0dc347540cb481abcab88f1d4456c0c218bae8cc3d65aa3da339bb7ae84858bffc43af26b1f39dcffc0b67019e98831f2da7f7cfeb

data/README.md

@@ -24,6 +24,14 @@ feature incomplete and potentially unstable. More information can be found [here
 
 ## What's New
 
+###Version 2.3.0
+
+* When testing using the remotely hosted browsers on the BrowserStack service, the BrowserStack Local instance is automatically started if the `TUNNELING`
+Environment Variable is set to `true`. `Environ.tunneling` will be set to true if the BrowserStack Local instance is succesfully started. Requires the
+[browserstack-local gem](https://rubygems.org/gems/browserstack-local).
+* Added `TestCentricity::WebDriverConnect.close_tunnel` method to close BrowserStack Local instance when Local testing is enabled. Refer to the
+**Remotely hosted desktop and mobile web browsers** section for information on usage.
+
 ###Version 2.2.0
 
 * CSS selectors or XPath expressions may be used as locators for all types of **UI Elements**, including tables.
@@ -57,7 +65,7 @@ for textfields.
 
 * Added support for "tiling" or cascading multiple browser windows when the `BROWSER_TILE` and `PARALLEL` Environment Variables are set to true. For each
 concurrent parallel thread being executed, the position of each browser will be offset by 100 pixels right and 100 pixels down. For parallel test execution,
-use the [parallel_tests gem](https://github.com/grosser/parallel_tests) to decrease overall test execution time.
+use the [parallel_tests gem](https://rubygems.org/gems/parallel_tests) to decrease overall test execution time.
 
 ###Version 2.1.2
 
@@ -74,6 +82,10 @@ use the [parallel_tests gem](https://github.com/grosser/parallel_tests) to decre
 
 
 ## What's Fixed
+###Version 2.2.1
+
+* `SelectList.choose_option` method now accepts index values for Chosen list objects.
+
 ###Version 2.1.9
 
 * Fixed bug in `SelectList.choose_option`, `SelectList.get_options`, `SelectList.get_option_count`, and `SelectList.get_selected_option` methods which
@@ -889,12 +901,20 @@ for information regarding the specific capabilities.
 `BS_OS_VERSION` | Refer to `os_version` capability in chart
 `BS_BROWSER`    | Refer to `browser` capability in chart
 `BS_VERSION`    | [Optional] Refer to `browser_version` capability in chart. If not specified, latest stable version of browser will be used.
-`TUNNELING`     | Must be `true` if you are testing against internal/local servers (`true` or `false`)
+`TUNNELING`     | Must be `true` if you are testing against internal/local servers (`true` or `false`). If `true`, the BrowserStack Local instance will be automatically started.
 `RESOLUTION`    | [Optional] Refer to supported screen `resolution` capability in chart
 `BROWSER_SIZE`  | [Optional] Specify width, height of browser window
 `RECORD_VIDEO`  | [Optional] Enable screen video recording during test execution (`true` or `false`)
 `TIME_ZONE`     | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart
 
+If the BrowserStack Local instance is running (`TUNNELING` Environment Variable is `true`), call the`TestCentricity::WebDriverConnect.close_tunnel` method
+upon completion of your test suite to stop the Local instance. Place the code shown below in your `env.rb` file.
+
+    # Code to stop BrowserStack Local instance after end of test (if tunneling is enabled)
+    at_exit do
+      TestCentricity::WebDriverConnect.close_tunnel if Environ.tunneling
+    end
+
 
 #### Remote mobile browsers on the BrowserStack service
 
@@ -912,7 +932,7 @@ for information regarding the specific capabilities.
 `BS_PLATFORM`    | Must be set to `MAC` (for iOS) or `ANDROID`
 `BS_DEVICE`      | Refer to `device` capability in chart
 `BS_REAL_MOBILE` | Set to `true` if running against a real device
-`TUNNELING`      | Must be `true` if you are testing against internal/local servers (`true` or `false`)
+`TUNNELING`      | Must be `true` if you are testing against internal/local servers (`true` or `false`). If `true`, the BrowserStack Local instance will be automatically started.
 `ORIENTATION`    | [Optional] Set to `portrait` or `landscape`
 `RECORD_VIDEO`   | [Optional] Enable screen video recording during test execution (`true` or `false`)
 `TIME_ZONE`      | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart

data/lib/testcentricity_web/environment.rb

@@ -37,6 +37,7 @@ module TestCentricity
     attr_accessor :device_os
     attr_accessor :device_orientation
     attr_accessor :platform
+    attr_accessor :tunneling
 
     attr_accessor :signed_in
     attr_accessor :portal_status
@@ -190,6 +191,14 @@ module TestCentricity
       @device_orientation
     end
 
+    def self.tunneling=(state)
+      @tunneling = state
+    end
+
+    def self.tunneling
+      @tunneling
+    end
+
     # @deprecated Please use {#platform=} instead
     def self.set_platform(platform)
       warn "[DEPRECATION] 'TestCentricity::Environ.set_platform' is deprecated.  Please use 'Environ.platform =' instead."

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '2.2.1'
+  VERSION = '2.3.0'
 end

data/lib/testcentricity_web/webdriver_helper.rb

@@ -1,5 +1,6 @@
 require 'selenium-webdriver'
 require 'os'
+require 'browserstack/local'
 
 
 module TestCentricity
@@ -7,6 +8,7 @@ module TestCentricity
     include Capybara::DSL
 
     attr_accessor :webdriver_path
+    attr_accessor :bs_local
 
     def self.initialize_web_driver(app_host = nil)
       Capybara.app_host = app_host unless app_host.nil?
@@ -150,6 +152,17 @@ module TestCentricity
       Environ.session_state = :running
     end
 
+    def self.close_tunnel
+      unless @bs_local.nil?
+        @bs_local.stop
+        if @bs_local.isRunning
+          raise 'BrowserStack Local instance could not be stopped'
+        else
+          puts 'BrowserStack Local instance has been stopped'
+        end
+      end
+    end
+
     private
 
     def self.initialize_appium
@@ -375,10 +388,23 @@ module TestCentricity
           capabilities['javascriptEnabled'] = 'true'
           capabilities['cleanSession'] = 'true'
         end
+
+        if ENV['TUNNELING']
+          @bs_local = BrowserStack::Local.new
+          bs_local_args = {'key' => "#{ENV['BS_AUTHKEY']}"}
+          @bs_local.start(bs_local_args)
+          if @bs_local.isRunning
+            puts 'BrowserStack Local instance has been started'
+          else
+            puts 'BrowserStack Local instance failed to start'
+          end
+        end
+
         Capybara::Selenium::Driver.new(app, browser: :remote, url: endpoint, desired_capabilities: capabilities)
       end
 
       Environ.browser = browser
+      Environ.tunneling = ENV['TUNNELING'] if ENV['TUNNELING']
 
       Capybara.default_driver = :browserstack
       Capybara.run_server = false

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 2.2.1
+  version: 2.3.0
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-11-29 00:00:00.000000000 Z
+date: 2017-12-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler