awetestlib 0.1.12 → 0.1.13

data/README.md

@@ -7,37 +7,76 @@ After completing this guide you will be able to run tests locally from command l
 
 ------------
 
-### Prerequisites
+## Prerequisites
 
 You need to have Ruby 1.8.7 installed. You can download Ruby 1.8.7 
 [here](http://rubyinstaller.org/downloads/)
 
+You can check your Ruby version using:
+
+    ruby -v
+
 Additionally, you will need to install DevKit to compile a few dependent gems. You can download DevKit
 [here](http://rubyinstaller.org/downloads/)
 
-### Install
+## Install
+
+In a terminal or command prompt, install the awetestlib gem
+
+    gem install awetestlib --no-ri --no-rdoc
+
+Note: This could take up to 5 minutes for first time installs and you may need to use 'sudo'
+
+
+## Setup Regression Module
+
+To setup the regression module, run the following command and verify the step
+  
+    awetestlib regression_setup
+
+## Usage
 
-1. In a terminal or command prompt, install the awetestlib gem
-  - `gem install awetestlib --no-ri --no-rdoc`
+Run the following command to see the different usages
 
+    awetestlib
 
-2. To setup the regression module, run the following command and verify the step
-  - `awetestlib regression_setup`
+## Setup Browsers
 
-### Usage
+### Setup Safari (Mac OS X only)
 
-1. Run the following command to see the different usages
-  - `awetestlib`
+To setup support for Safari browser, please follow the instructions at [SafariDriver](http://code.google.com/p/selenium/wiki/SafariDriver) 
 
-2. To setup the awetestlib gem with Netbeans or Rubymine, run either of the commands
-  - `awetestlib rubymine_setup`
+### Setup Chrome
+To setup support for Google Chrome browser, please download the latest Chromedriver version from [here](http://code.google.com/p/chromedriver/downloads/list) 
 
-  or 
-  - `awetestlib netbeans_setup`
+Then move the executables in your PATH. To find your PATHs, type the command below in your terminal/command prompt
 
-  You can now start your scripts within the IDE. Use the Run Configuration button.
+For Mac OSX:
 
-  For additional information on IDE setup, refer to the links below:
+    echo $PATH
+
+For Windows:
+
+    PATH
+    
+### Setup Internet Explorer
+To setup support for Internet Explorer, please download the latest IEDriver version from [here](http://code.google.com/p/selenium/downloads/list) 
+and move the executable into your PATH.
+
+
+### Setup IDEs (Rubymine, Netbeans)
+
+To setup the awetestlib gem with Rubymine use:
+
+    awetestlib rubymine_setup <ProjectName>
+    
+To setup awetestlib with Netbeans use:
+ 
+    awetestlib netbeans_setup <ProjectName>
+
+You can now start your scripts within the IDE. Use the Run Configuration button.
+
+For additional information on IDE setup, refer to the links below:
 
   - [Netbeans IDE setup](https://github.com/3qilabs/awetestlib/blob/develop/netbeans_setup.md)
 
@@ -58,12 +97,12 @@ The full list of parameters for the command line currently are:
         -x, --excel EXCEL_FILE           Specify an excel file containing variables to be loaded
         -v, --version VERSION            Specify a browser version
 
-To get started writing your own script, refer to the [Getting Started Scripting](https://github.com/3qilabs/awetestlib/wiki/Getting-Started---Scripting) wiki
+To start writing your own script, refer to the [Scripting Guide/Wiki](https://github.com/3qilabs/awetestlib/wiki/Getting-Started---Scripting) wiki
 
 ### Cucumber Support 
 
 One of the technologies that the Awetest framework supports is [Cucumber](http://cukes.info/). To get setup with cucumber, you can run the following command: `awetestlib cucumber_setup` which will create your typical cucumber folder structure.
 
-
+Visit our [wiki](https://github.com/3qilabs/awetestlib/wiki/Predefined-Cucumber-Web-Steps) to see the list of predefined steps provided by awetestlib
 
 

data/bin/awetestlib-cucumber-setup.rb

@@ -1,14 +1,20 @@
 def awetestlib_cucumber_setup
-  @cucumber_dir = File.join(FileUtils.pwd, "sample_cucumber")
-  @source_dir = File.join(File.dirname(__FILE__), '..', 'setup_samples', 'sample_cucumber')
+  if ARGV[1].nil?
+    @proj_dir = "sample_cucumber"
+  else
+    @proj_dir = ARGV[1]
+  end
+
+  @cucumber_dir = File.join(FileUtils.pwd, @proj_dir)
+  @source_dir = File.join(File.dirname(__FILE__), '..', 'setup_samples', @proj_dir)
 
   if File.exists?(@cucumber_dir)
-    puts "Sample Cucumber features directory already exists."
+    puts "Cucumber project directory already exists."
     exit 1
   end
 
   msg("Question") do
-    puts "I'm about to create a sample cucumber feature in this directory"
+    puts "I'm about to create a cucumber project named #{@proj_dir} in this directory"
     puts "Please hit return to confirm that's what you want."
     puts "NOTE: You may need to run this command as an administrator."
   end

data/bin/awetestlib-helpers.rb

@@ -21,7 +21,7 @@ def print_usage
     awetestlib mobile_app_setup <project_name>
       setup a mobile app project
 
-    awetestlib cucumber_setup
+    awetestlib cucumber_setup <project_name>
       setup cucumber regression and provide skeleton folder structure
 
     awetestlib <script_file> [parameters]

data/lib/awetestlib/regression/browser.rb

@@ -1050,9 +1050,183 @@ tags: system, http, fatal, error
 example: See click()
 related methods: rescue_me()
 =end
-      def validate(browser, fileName = '', lnbr = __LINE__, dbg = false) # need to get rid of validate call, issues if modal comes up after click
-      end 
- 
+      def validate(browser, fileName = '', lnbr = __LINE__, dbg = false)
+        debug_to_log("#{__method__} begin") if dbg
+        msg  = ''
+        myOK = true
+        if not browser
+          msg  = "#{fileName}----browser is nil object. (#{lnbr})"
+          myOK = false
+        elsif not is_browser?(browser)
+          msg = "#{fileName}----not a browser. (#{lnbr})"
+          debug_to_log(browser.inspect)
+          myOK = false
+
+        else
+          if browser.respond_to?(:url)
+            if not browser.url == @currentURL
+              @currentURL = browser.url
+              debug_to_log("Current URL: [#{@currentURL}]")
+              #        mark_testlevel( "Current URL: [#{@currentURL}]", 1 )
+            end
+          end
+
+          if @capture_js_errors
+            if browser.respond_to?(:status)
+              if browser.status.downcase =~ /errors? on page/ and
+                  not browser.status.downcase.include?('Waiting for')
+                capture_js_error(browser)
+              end
+            end
+          end
+
+          begin
+            browser_text = browser.text.downcase
+          rescue => e
+            if not rescue_me(e, __method__, "browser.text.downcase", "#{browser.class}", browser)
+              debug_to_log("browser.text.downcase in #{__method__} #{browser.class}")
+              debug_to_log("#{get_callers}")
+              raise e
+            else
+              return true
+            end
+          end
+
+          if browser_text
+            if browser_text.match(/unrecognized error condition has occurred/i)
+              msg  = "#{fileName}----Unrecognized Exception occurred. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/cannot find server or dns error/i)
+              msg  = "#{fileName}----Cannot find server error or DNS error. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/the rpc server is unavailable/i)
+              msg  = "#{fileName}----RPC server unavailable. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/404 not found/i) or
+                browser_text.match(/the page you were looking for does\s*n[o']t exist/i)
+              msg  = "#{fileName}----RFC 2068 HTTP/1.1: 404 URI Not Found. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/we're sorry, but something went wrong/i) or
+                browser_text.match(/http status 500/i)
+              msg  = "#{fileName}----RFC 2068 HTTP/1.1: 500 Internal Server Error. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/internet explorer cannot display the webpage/i)
+              msg  = "#{fileName}----Probably RFC 2068 HTTP/1.1: 500 Internal Server Error. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/503.*service unavailable/i)
+              msg  = "#{fileName}----RFC 2068 HTTP/1.1: 503 Service Unavailable. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/java.lang.NullPointerException/i)
+              msg  = "#{fileName}----java.lang.NullPointerException. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/due to unscheduled maintenance/i)
+              msg  = "#{fileName}----Due to unscheduled maintenance. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/network\s+error\s*(.+)$/i)
+              $1.chomp!
+              msg  = "#{fileName}----Network Error #{$1}. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/warning: page has expired/i)
+              msg  = "#{fileName}----Page using information from form has expired. Not automatically resubmitted. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/no backend server available/i)
+              msg  = "#{fileName}----Cannot Reach Server (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/sign on\s+.+\s+unsuccessful/i)
+              msg  = "#{fileName}----Invalid Id or Password (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/you are not authorized/i)
+              msg  = "#{fileName}----Not authorized to view this page. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/too many incorrect login attempts have been made/i)
+              msg  = "#{fileName}----Invalid Id or Password. Too many tries. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/system error\.\s+an error has occurred/i)
+              msg  = "#{fileName}----System Error. An error has occurred. Please try again or call the Help Line for assistance. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/Internal Server failure,\s+NSAPI plugin/i)
+              msg  = "#{fileName}----Internal Server failure, NSAPI plugin. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/Error Page/i)
+              msg  = "#{fileName}----Error Page. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/The website cannot display the page/i)
+              msg  = "#{fileName}----HTTP 500. (#{lnbr})"
+              myOK = false
+
+              #        elsif browser_text.match(/Insufficient Data/i)
+              #          msg  = "#{fileName}----Insufficient Data. (#{lnbr})"
+              #          myOK = false
+
+            elsif browser_text.match(/The timeout period elapsed/i)
+              msg  = "#{fileName}----Time out period elapsed or server not responding. (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/Unexpected\s+errors*\s+occur+ed\.\s+(?:-+)\s+(.+)/i)
+              msg = "#{fileName}----Unexpected errors occurred. #{$2.slice(0, 120)} (#{lnbr})"
+              if not browser_text.match(/close the window and try again/i)
+                myOK = false
+              else
+                debug_to_log("#{msg}")
+              end
+
+            elsif browser_text.match(/Server Error in (.+) Application\.\s+(?:-+)\s+(.+)/i)
+              msg  = "#{fileName}----Server Error in #{1} Application. #{$2.slice(0, 100)} (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/Server Error in (.+) Application\./i)
+              msg  = "#{fileName}----Server Error in #{1} Application. '#{browser_text.slice(0, 250)}...' (#{lnbr})"
+              myOK = false
+
+            elsif browser_text.match(/An error has occur+ed\. Please contact support/i)
+              msg  = "#{fileName}----An error has occurred. Please contact support (#{lnbr})"
+              myOK = false
+
+            end
+          else
+            debug_to_log("browser.text returned nil")
+          end
+        end
+
+        if not myOK
+          msg << " (#{browser.url})"
+          puts msg
+          debug_to_log(browser.inspect)
+          debug_to_log(browser.text)
+          fatal_to_log(msg, lnbr)
+          raise(RuntimeError, msg, caller)
+        else
+          debug_to_log("#{__method__} returning OK") if dbg
+          return myOK
+        end
+
+      rescue
+        errmsg = $!
+        if errmsg.match(msg)
+          errmsg = ''
+        end
+        bail_out(browser, lnbr, "#{msg} #{errmsg}")
+      end
+
+      alias validate_browser validate
 
 
     end

data/lib/version.rb

@@ -1,4 +1,4 @@
 module Awetestlib
-  VERSION = "0.1.12"
-  VERSION_DATE = "2012-09-10"
+  VERSION = "0.1.13"
+  VERSION_DATE = "2012-09-18"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: awetestlib
 version: !ruby/object:Gem::Version 
-  hash: 3
+  hash: 1
   prerelease: 
   segments: 
   - 0
   - 1
-  - 12
-  version: 0.1.12
+  - 13
+  version: 0.1.13
 platform: ruby
 authors: 
 - Anthony Woo
@@ -16,7 +16,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-09-10 00:00:00 Z
+date: 2012-09-18 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: watir-webdriver