test_utils 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6f5cc67e26da491024e823bc41b1a50db9c5b55c
-  data.tar.gz: 12439ec011be63d4494c7437d9f031b22479b2cc
+  metadata.gz: cbb5176870f09ae466b4b886d5aa61506ae28f2e
+  data.tar.gz: 19e6ef95190cfd5a306c5f2989bac64cc06b815d
 SHA512:
-  metadata.gz: bbad3487f30cc243dcfe444e0d5a502466dbefb91860fef118098e0e86a86456d3ed9716f2af17ce6f29788bdece5781326877e9ec158c090177898ac23e8c76
-  data.tar.gz: 4704927d1ed5712c7042f16f8155d7fbc009e73c1b18b5cf7c713a10ceb16e11b939d9572f33ab5a26e9fd7c5aea4389d05f0ea22a5d69a8043570b23370702e
+  metadata.gz: 833ff1cf55fe0dd0da232c5f6a7e0e3e24be9a6fd155561a30b5c035f1613eed52c0d9c8ffc11d27b4bfc68f01d36c2d15d8aa07818eab250104cafa0ca74708
+  data.tar.gz: 0c645c1fde916ba8485c994a5ec80796da85b93c2df5e3f75c948b586f3d0c807ebb314ebaa1833a293c96edc33acefa779a47d9c8b6583bcecb14a457af197d

data/README.md

@@ -23,27 +23,50 @@ Or install it yourself as:
 
 ### Start up a browser locally
 
-1. Set the environment variable "PLATFORM" to "Chrome", "Firefox" or "Mobile". The drivers are already included in the (resources) directory.
+Set the environment variable "BROWSER" to "Chrome", "Firefox" or "Mobile". The drivers are already included in the (resources) directory.
 
-   `$ PLATFORM=Chrome`
+`$ BROWSER=Chrome`
 
-   ```ruby
-   require 'test_utils/browser_tests/browser_setup'
-   include BrowserSetup
+```ruby
+require 'test_utils/browser_tests/browser_setup'
+include BrowserSetup
 
-   start_browser
-   @browser.goto 'https://github.com/ef-ice/test_utils'
-   raise 'not found!' unless @browser.title.include?('Readme')
-   close_browser
-
-   ```
+start_browser
+@browser.goto 'https://github.com/ef-ice/test_utils'
+raise 'not found!' unless @browser.title.include?('Readme')
+close_browser
+```
 
 Note: Using "Mobile" will start a browser in mobile size (this uses the [webdriver-user-agent](https://github.com/alisterscott/webdriver-user-agent) gem)
 
 
 ### Start up a browser in Browser stack
 
-1. Set the environment variable "BS":
+Browserstack requires to set four capabilities to start up a browser (os, osVersion, browser, browserVersion). This is too cumbersome, so instead with this gem you can set a single environment variable called "BS" that combines all of these together and sets them up on their corresponding capabilities when you call "start_browser". 
+
+The format for the "BS" environment variable is "osName_osVersion_browserName_browserVersion" in desktop, and "device_version" in mobile.
+
+#### Running tests in desktop:
+
+1. osName: win (windows), mac.
+
+2. osVersion: See options [here](https://www.browserstack.com/list-of-browsers-and-platforms?product=automate). 
+
+3. browserName: ie, chrome, firefox, etc.
+
+4. browserVersion: blank for latest, otherwise any option from [here](https://www.browserstack.com/list-of-browsers-and-platforms?product=automate).
+   
+   
+#### Valid values for mobile:
+ 
+ 1. device: iphone, android.
+ 
+ 2. deviceVersion: 6s, nexus5, etc. (see options [here](https://www.browserstack.com/list-of-browsers-and-platforms?product=automate))
+ 
+
+#### Examples
+
+1. Set your "BS" env var:
 
   `$ BS="win_7_ie_11"`
   

data/lib/test_utils/browser_tests/browser_setup.rb

@@ -55,13 +55,13 @@ module BrowserSetup
       @browser = Watir::Browser.new(:chrome, :http_client => client, :switches => %w[--no-sandbox])
     rescue Net::ReadTimeout => error
       if times_retried < max_retries
-        p '### ERROR: Net::ReadTimeout on Browser Initialize (Watir::Browser.new) ###'
-        p '### RETRYING ... ###'
+        puts '### ERROR: Net::ReadTimeout on Browser Initialize (Watir::Browser.new) ###'
+        puts '### RETRYING ... ###'
         sleep 2
         times_retried += 1
         retry
       else
-        p '### ERROR: Net::ReadTimeout on Browser Initialize (Watir::Browser.new) ###'
+        puts '### ERROR: Net::ReadTimeout on Browser Initialize (Watir::Browser.new) ###'
         p error
         fail "Browser failed to initialize after #{(times_retried + 1)} attempts. ###"
       end
@@ -120,23 +120,20 @@ module BrowserSetup
 
   # Closes the browser
   # Takes screenshot and prints relevant information before closing
-  def close_browser(scenario = nil)
-    if !scenario.nil? && !@browser.nil?
-      if @current_page.nil?
-        file_name = "#{DateTime.now.strftime("%Y%m%d_%H%M%S")}.png"
-        @browser.screenshot.save file_name
-        embed(file_name, 'image/png')
-      else
-        file_name = "#{@current_page.class}-#{DateTime.now.strftime("%Y%m%d_%H%M%S")}.png"
-        @current_page.save_screenshot(file_name)
-        embed(file_name, 'image/png')
-      end
-      if scenario.failed?
-        print_session_storage
-        print_console_errors
-      end
+  def close_browser
+    unless @browser.nil?
+      take_screenshot
+      print_session_storage
+      print_console_errors
+      @browser.close
     end
-    @browser.close unless @browser.nil?
+  end
+
+  # Save screenshot
+  def take_screenshot
+    file_name = "error-#{DateTime.now.strftime("%Y%m%d_%H%M%S")}.png"
+    @browser.screenshot.save file_name
+    embed(file_name, 'image/png')
   end
 
   # Prints all sessionStorage data

data/lib/test_utils/version.rb

@@ -1,3 +1,3 @@
 module TestUtils
-  VERSION = '0.1.1'
+  VERSION = '0.1.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: test_utils
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Cinthya Villalobos
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-03-06 00:00:00.000000000 Z
+date: 2017-04-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver