testcentricity_web 0.8.8 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 42ed99dccff2f618eb499debb1cddd8c325d31e6
-  data.tar.gz: 4dbd5db9f6aecdef99969f1a53eb86c614b7916f
+  metadata.gz: 72ebdc8a23d3951e0331e793891a986e90f9087d
+  data.tar.gz: 9bb16a5cdc5ee7dbbc8f271dcd9a06afeb7dc54c
 SHA512:
-  metadata.gz: fb1ca9ad90740fb481c69b3aab09d9a48fe8f34bebc2b7eaa0553d599cf924d9bb0e7b641d607659c019a65cd214c312590169401eddebaf0ec5ad404f6aada9
-  data.tar.gz: b9f0fbfa6aef8af141397216e1e2de40c55fcf51d6fbc8bdea78dc54f7dc90c91641c1a2cbae8f96e2301eef4b5e92ac33b3e1bc853a520a0795dca46f5a4a6a
+  metadata.gz: 460918f5625d82888571ab34ecb5de8d78ea310a1c411f28b898662121f1f53440273384a96c0687b335758e1dbaa924a8de4913d9001168c7bf67a708354c89
+  data.tar.gz: 21f1d4af406c383e94f7c338da5d29714facbcd909bb8f51ba230b65b5db967b73aa666cde0d221c0d6a96c396cd9467728c4876946c3abab20c189236b41296

data/README.md

@@ -11,6 +11,7 @@ The TestCentricity™ Web gem supports running testing against the following web
 * locally hosted desktop browsers (Firefox, Chrome, Safari, IE, or Edge)
 * locally hosted emulated iOS, Android, and Windows Phone mobile browsers (using Firefox or Chrome)
 * a "headless" browser (using Poltergeist and PhantomJS)
+* mobile Safari browsers on iOS device simulators (using Appium and XCode on OS X)
 * cloud hosted desktop or mobile web browsers using the BrowserStack, Sauce Labs, CrossBrowserTesting, or TestingBot services.
 
 
@@ -56,6 +57,22 @@ project's Gemfile:
     gem 'poltergeist'
 
 
+### Using Appium
+
+If you will be running your tests on mobile Safari browsers on simulated iOS devices using Appium and XCode Simulators, you need to require
+the following in your *env.rb* file:
+
+    require 'appium_capybara'
+
+You also need to add this line to your automation project's Gemfile:
+
+    gem 'appium_capybara'
+
+And then execute:
+
+    $ bundle
+
+
 
 ## Page Objects
 
@@ -153,11 +170,12 @@ the UI to hide implementation details, as shown below:
       trait(:page_locator)    { 'body.login-body' }
     
       # Login page UI elements
-      textfield :user_id_field,       '#userName'
-      textfield :password_field,      '#password'
-      button    :login_button,        '#login'
-      checkbox  :remember_checkbox,   '#rememberUser'
-      label     :error_message_label, 'div#statusBar.login-error'
+      textfield :user_id_field,        '#userName'
+      textfield :password_field,       '#password'
+      button    :login_button,         '#login'
+      checkbox  :remember_checkbox,    '#rememberUser'
+      label     :error_message_label,  'div#statusBar.login-error'
+      link      :forgot_password_link, 'a.forgotPassword'
     
       def login(user_id, password)
         user_id_field.set(user_id)
@@ -168,6 +186,18 @@ the UI to hide implementation details, as shown below:
       def remember_me(state)
         remember_checkbox.set_checkbox_state(state)
       end
+
+      def verify_page_ui
+        ui = {
+            login_button         => { :visible => true, :value => 'LOGIN' },
+            user_id_field        => { :visible => true, :enabled => true },
+            password_field       => { :visible => true, :enabled => true, :value => '', :placeholder => 'Password' },
+            remember_checkbox    => { :exists  => true, :enabled => true, :checked => false },
+            forgot_password_link => { :visible => true, :value => 'Forgot your password?' },
+            }
+        verify_ui_states(ui)
+        super
+      end
     end
 
 
@@ -389,6 +419,29 @@ To use a local instance of the Chrome desktop browser to host the emulated mobil
 to `chrome`.
 
 
+### Mobile Safari browser on iOS Simulators
+
+You can run your mobile web tests against the mobile Safari browser on simulated iOS devices using Appium and XCode on OS X. You will need to install
+XCode and Appium, and ensure that the `appium_capybara` gem is installed and required as described above.
+
+Once your test environment is properly configured, the following **Environment Variables** must be set as described in the table below.
+
+**Environment Variable** | **Description**
+--------------- | ----------------
+`WEB_BROWSER` | Must be set to `appium`
+`APP_PLATFORM` | Must be set to `MAC`
+`APP_PLATFORM_NAME` | Must be set to `iOS`
+`APP_BROWSER` | Must be set to `Safari`
+`APP_VERSION` | Must be set to `9.3`, `9.2`, or which ever iOS Simulator version are installed in XCode
+`APP_DEVICE`| Set to iOS device name supported by the iOS Simulator (`iPhone 6s Plus`, `iPad Pro`, `iPad Air 2`, etc.)
+`ORIENTATION` | [Optional] Set to `portrait` or `landscape`
+`APP_ALLOW_POPUPS` | [Optional] Allow javascript to open new windows in Safari. Set to `true` or `false`
+`APP_IGNORE_FRAUD_WARNING` | [Optional] Prevent Safari from showing a fraudulent website warning. Set to `true` or `false`
+`APP_NO_RESET` | [Optional] Don't reset app state after each test. Set to `true` or `false`
+`APP_INITIAL_URL` | [Optional] Initial URL, default is a local welcome page.  e.g.  `http://www.apple.com`
+
+
+
 ### Remotely hosted desktop and mobile web browsers
 
 You can run your automated tests against remotely hosted desktop and mobile web browsers using the BrowserStack, CrossBrowserTesting,
@@ -570,10 +623,30 @@ replace the placeholder text with your user account and authorization code for t
     #==============
     # profiles for mobile device screen orientation
     #==============
+    
     portrait:           ORIENTATION=portrait
     landscape:          ORIENTATION=landscape
     
     
+    #==============
+    # profiles for mobile Safari web browsers hosted within XCode iOS simulator
+    # NOTE: Requires installation of XCode, iOS version specific target simulators, Appium, and the appium_capybara gem
+    #==============
+    
+    appium_ios:            WEB_BROWSER=appium APP_PLATFORM="MAC" APP_PLATFORM_NAME="iOS" APP_BROWSER="Safari" <%= mobile %>
+    app_ios_93:            --profile appium_ios APP_VERSION="9.3"
+    app_ios_92:            --profile appium_ios APP_VERSION="9.2"
+    ipad_retina_93_sim:    --profile app_ios_93 APP_DEVICE="iPad Retina"
+    ipad_pro_93_sim:       --profile app_ios_93 APP_DEVICE="iPad Pro"
+    ipad_air_93_sim:       --profile app_ios_93 APP_DEVICE="iPad Air"
+    ipad_air2_93_sim:      --profile app_ios_93 APP_DEVICE="iPad Air 2"
+    ipad_2_93_sim:         --profile app_ios_93 APP_DEVICE="iPad 2"
+    iphone_6s_plus_93_sim: --profile app_ios_93 APP_DEVICE="iPhone 6s Plus"
+    iphone_6s_93_sim:      --profile app_ios_93 APP_DEVICE="iPhone 6s"
+    iphone_5s_93_sim:      --profile app_ios_93 APP_DEVICE="iPhone 5s"
+    iphone_4s_93_sim:      --profile app_ios_93 APP_DEVICE="iPhone 4s"
+    
+    
     #==============
     # profiles for remotely hosted web browsers on the BrowserStack service
     #==============
@@ -810,17 +883,28 @@ invoking Cucumber in the command line. For instance, the following command invok
 will be used as the target web browser:
     
     $ cucumber -p chrome
-    
+
+
 The following command specifies that Cucumber will run tests against a local instance of Firefox, which will be used to emulate an iPad Pro
 in landscape orientation:
     
     $ cucumber -p ipad_pro -p landscape
- 
+
+
+The following command specifies that Cucumber will run tests against an iPad Pro with iOS version 9.3 in an XCode Simulator
+in landscape orientation:
+    
+    $ cucumber -p ipad_pro_93_sim -p landscape
+    
+    NOTE:  Appium must me running prior to executing this command
+
+
 The following command specifies that Cucumber will run tests against a remotely hosted Safari web browser running on an OS X Yosemite
 virtual machine on the BrowserStack service:
 
     cucumber -p bs_safari_yos
  
+
 The following command specifies that Cucumber will run tests against a remotely hosted Mobile Safari web browser on an iPhone 6s Plus in
 landscape orientation running on the BrowserStack service:
 

data/lib/testcentricity_web/page_objects_helper.rb

@@ -255,7 +255,11 @@ module TestCentricity
             when :checked
               actual = ui_object.checked?
             when :selected
-              actual = ui_object.selected?
+              if ui_object.get_object_type == :selectlist
+                actual = ui_object.get_selected_option
+              else
+                actual = ui_object.selected?
+              end
             when :value
               actual = ui_object.get_value
             when :maxlength

data/lib/testcentricity_web/page_sections_helper.rb

@@ -271,7 +271,11 @@ module TestCentricity
             when :checked
               actual = ui_object.checked?
             when :selected
-              actual = ui_object.selected?
+              if ui_object.get_object_type == :selectlist
+                actual = ui_object.get_selected_option
+              else
+                actual = ui_object.selected?
+              end
             when :value
               actual = ui_object.get_value
             when :maxlength

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '0.8.8'
+  VERSION = '0.9.0'
 end

data/lib/testcentricity_web/webdriver_helper.rb

@@ -16,6 +16,9 @@ module TestCentricity
       Environ.set_device_type('browser')
 
       case browser.downcase.to_sym
+
+      when :appium
+        initialize_appium
       when :browserstack
         initialize_browserstack
       when :crossbrowser
@@ -31,13 +34,45 @@ module TestCentricity
       end
 
       # set browser window size only if testing with a desktop web browser
-      initialize_browser_size unless Capybara.current_driver == :poltergeist
+      initialize_browser_size unless Capybara.current_driver == :poltergeist || Capybara.current_driver == :appium
 
       puts "Using #{Environ.browser.to_s} browser"
     end
 
     private
 
+    def self.initialize_appium
+      Environ.set_device(true)
+      Environ.set_platform(:mobile)
+      Environ.set_device(true)
+      Environ.set_device_type(ENV['APP_DEVICE'])
+      Capybara.default_driver = :appium
+      endpoint = 'http://localhost:4723/wd/hub'
+      desired_capabilities = {
+          platform:        ENV['APP_PLATFORM'],
+          platformName:    ENV['APP_PLATFORM_NAME'],
+          platformVersion: ENV['APP_VERSION'],
+          browserName:     ENV['APP_BROWSER'],
+          deviceName:      ENV['APP_DEVICE']
+      }
+      desired_capabilities['deviceOrientation'] = ENV['ORIENTATION'] if ENV['ORIENTATION']
+      desired_capabilities['udid'] = ENV['APP_UDID'] if ENV['APP_UDID']
+      desired_capabilities['safariInitialUrl'] = ENV['APP_INITIAL_URL'] if ENV['APP_INITIAL_URL']
+      desired_capabilities['safariAllowPopups'] = ENV['APP_ALLOW_POPUPS'] if ENV['APP_ALLOW_POPUPS']
+      desired_capabilities['safariIgnoreFraudWarning'] = ENV['APP_IGNORE_FRAUD_WARNING'] if ENV['APP_IGNORE_FRAUD_WARNING']
+      desired_capabilities['noReset'] = ENV['APP_NO_RESET'] if ENV['APP_NO_RESET']
+
+      Capybara.register_driver :appium do |app|
+        appium_lib_options = { server_url: endpoint }
+        all_options = {
+            browser:     :safari,
+            appium_lib:  appium_lib_options,
+            caps:        desired_capabilities
+        }
+        Appium::Capybara::Driver.new app, all_options
+      end
+    end
+
     def self.initialize_local_browser(browser)
       Capybara.default_driver = :selenium
       Capybara.register_driver :selenium do |app|

data/testcentricity_web.gemspec

@@ -15,8 +15,8 @@ Gem::Specification.new do |spec|
     TestCentricity™ core generic framework for desktop and mobile web site testing implements a Page Object Model DSL
     for use with Cucumber, Capybara, and Selenium-Webdriver. Supports testing against locally hosted desktop browsers
     (Firefox, Chrome, Safari, IE, or Edge), locally hosted emulated iOS and Android mobile browsers (using Firefox or
-    Chrome), a "headless" browser (using Poltergeist and PhantomJS), or on cloud hosted browsers using the BrowserStack,
-    Sauce Labs, CrossBrowserTesting, or TestingBot services.}
+    Chrome), a "headless" browser (using Poltergeist and PhantomJS), mobile Safari web browsers on iOS device simulators,
+    or on cloud hosted browsers using the BrowserStack, Sauce Labs, CrossBrowserTesting, or TestingBot services.}
   spec.homepage      = ''
   spec.license       = 'BSD3'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 0.8.8
+  version: 0.9.0
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-02 00:00:00.000000000 Z
+date: 2016-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -147,8 +147,8 @@ description: |2-
       TestCentricity™ core generic framework for desktop and mobile web site testing implements a Page Object Model DSL
       for use with Cucumber, Capybara, and Selenium-Webdriver. Supports testing against locally hosted desktop browsers
       (Firefox, Chrome, Safari, IE, or Edge), locally hosted emulated iOS and Android mobile browsers (using Firefox or
-      Chrome), a "headless" browser (using Poltergeist and PhantomJS), or on cloud hosted browsers using the BrowserStack,
-      Sauce Labs, CrossBrowserTesting, or TestingBot services.
+      Chrome), a "headless" browser (using Poltergeist and PhantomJS), mobile Safari web browsers on iOS device simulators,
+      or on cloud hosted browsers using the BrowserStack, Sauce Labs, CrossBrowserTesting, or TestingBot services.
 email:
 - test_automation@icloud.com
 executables: []