awetestlib 0.1.30-x86-mingw32 → 1.2.4-x86-mingw32

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 233110f8a75a2d768b126c57d59052e151844014
+  data.tar.gz: 7853f33a306044e6da2d84caff7e4182e2de87ab
+SHA512:
+  metadata.gz: 2752fa08082ae8112d6ff7c2b7b99db0c2da594e5868ddc41b7dae3388ab9385f506d5030ec1254045548bfe775f6a4415a6bb00ca8e41f49b8ed4a0d4461db8
+  data.tar.gz: c130f7b10173234ceedcdbc5254cc0cdece3461611c649a65e6db74dd920a6075aeca96d78500e93704b2204a15d7c50066c937d65538d0aa91dfdc754134cdd

data/README.md

@@ -1,49 +1,85 @@
 Awetestlib
 ==========
 
-Automate testing of browser-based applications in Windows or Mac.
+Automate testing of browser-based applications in Windows, OSX, iOS, or Android
+
+## Note: Awetestlib is undergoing significant changes and this document is very much a work in progress.
+1. Support for cucumber and calabash is removed to keep things focused
+2. Support for classic Watir is removed.  Watir-Webdriver and Selenium IE support are much improved since Awetestlib was first written.
+3. Native and hybrid mobile applications are not supported.  Browser based apps only.
+4. The legacy awetestlib dsl is being phased out.
+5. The new dsl is both simplified and expanded. Code readability and consistency is the primary aim.
+6. The gem will be heavily documented using Yard conventions so look for the current deployed version in rubygems and rubydoc.info
 
-After completing this guide you will be able to run tests locally from command line or from an IDE.
 
 ------------
-## Prerequisites: Ruby 1.8.7 and RubyInstaller Devkit
+## Prerequisites: Ruby 2.0.x and RubyInstaller Devkit (Windows) or Xcode (Mac)
+
+### Windows
+#### Ruby 2.0.x
+You need to have Ruby 2.0.x installed using the RubyInstaller package.
 
-You need to have Ruby 1.8.7 installed using RubyInstaller. 
+You can download the RubyInstaller for 2.0.x
+[here](http://rubyinstaller.org/downloads/).  Choose the most recent 2.0.x.
 
-You can download the RubyInstaller for 1.8.7 
-[here](http://rubyinstaller.org/downloads/).  Choose the most recent 1.8.7.  
+**Install in a directory without spaces, like C:\Ruby187. Don't install in Program Files.**
 
-Make sure you tell the installer to put Ruby in the PATH environment variable.
+**Make sure you tell the installer to put Ruby in the PATH environment variable.**
 
 You can check your Ruby version using:
 
     ruby -v
 
-Additionally, for Windows, you will need to install the RubyInstaller DevKit to compile a few dependent gems. 
+
+#### RubyInstaller Devkit (Windows only)
+Additionally, for Windows, you will need to install the RubyInstaller DevKit to compile a few dependent gems.
 
 Download DevKit
-[here](http://rubyinstaller.org/downloads/)
-and the installation directions can be found
-[here](https://github.com/oneclick/rubyinstaller/wiki/Development-Kit). 
+[from here](http://rubyinstaller.org/downloads/)
+and the installation directions can also be found
+[here](https://github.com/oneclick/rubyinstaller/wiki/Development-Kit).
+
+Choose the one for Ruby 2.0.x and your Windows word size (32 or 64 bit) and download the package.
+
+Create directory C:\devkit and unzip the devkit package into that directory.
+
+Open a command window and change to C:\devkit.
+
+Then execute
+
+	ruby dk.rb init
 
-Choose the one for Ruby 1.8.7.
+And do
+
+	ruby dk.rb review 
+
+And make sure you see C:\Ruby20x at the end of the output.  Now
+
+	ruby dk.rb install
 
 If you have difficulties with the above in Windows 7 and/or behind a firewall, you may have to set the http_proxy and/or run the installers as administrator. (see below)
 
+### OSX
+#### Ruby
+Ruby 1.8.7 is installed by default in OSX. You will have to update to 2.0.x
+
+#### Xcode
+Follow Mac instructions for installing/upgrading Xcode to latest version.
+
 ## Install Awetestlib
 
-**Start** by opening a command window or terminal
+**Start** by opening a command window or terminal.
 
 ----------
 
-####NOTE: If you are behind a firewall:
+#### NOTE: If you are behind a firewall:
 
 1. You will need to set the http_proxy environment variable
-2. You may have to change the HOMEDRIVE environment variable to C: in Windows
+2. You _may_ have to change the HOMEDRIVE environment variable to C: in Windows
 3. You may need to run the Windows 7 command window as administrator.
 
 In Windows
-	
+
 	set http_proxy=http://myproxy.mycompany.com:80
 	set HOMEDRIVE=C:
 
@@ -53,16 +89,24 @@ In OSX
 
 
 ----------
-	
+#### Temporary but necessary (13may2013)
 
-**Then**, in a terminal or command prompt, install the awetestlib gem:
+In the command window:
 
-    gem install awetestlib --no-ri --no-rdoc
+	gem install nokogiri -v 1.5.9 --no-ri --no-rdoc
+
+And
+
+	gem install mini_magick -v 3.5.0 --no-ri --no-rdoc
+
+**Then**, in the command window, install the awetestlib gem.
 
 Note: This could take up to 5 minutes for first time installs.  You may need to use 'sudo' on OSX
 
+    gem install awetestlib --no-ri --no-rdoc
+
 **Then** run the following command and verify the step
-  
+
     awetestlib regression_setup
 
 ### Usage
@@ -70,45 +114,63 @@ Note: This could take up to 5 minutes for first time installs.  You may need to
 Run the following command to see the different usages
 
     awetestlib
+    
+## Mobile
+### Appium (both Windows and OSX)
+#### Android
+##### Emulator (Windows only)
+##### Device
+#### iOs
+##### Simulator (OSX only)
+##### Device
 
 ## Setup Browsers
-### Safari (Mac OS X only)
-To setup support for Safari browser, please follow the instructions at [SafariDriver](http://code.google.com/p/selenium/wiki/SafariDriver)
+### Safari (OSX only)
+To setup support for Safari browser, download the Selenium Safari Standalone Server from [Selenium downloads](https://code.google.com/p/selenium/downloads/list).  
+Select selenium-server-standalone-x.xx.xx.jar.  (The version is 2.33.0 as of this writing.)  Download it and copy it into /Library/Java/Extensions.
+You will need to start this process in a terminal session before running Safari scripts, else you will get a 'waiting for connection' error. 
+Start it with this command in a terminal session:
 
-It is likely you will need to start a selenium-server-standalone process in a terminal session before running Safari scripts, else you will get a 'waiting for connection' error. Get the jar [here](https://code.google.com/p/selenium/downloads/list).
+	  nohup java -jar /Library/Java/Extensions/selenium-server-standalone-2.33.0.jar & 
 
 When using raw Watir-webdriver for Safari, open the browser with
 
     browser = Watir::Browser.new(:remote, :desired_capabilities=>:'safari')
 
+A Caveat: The Selenium SafariDriver currently cannot handle modal alerts/windows, except to dismiss them (invisibly) whenever they exist. ([Issue 3862](https://code.google.com/p/selenium/issues/detail?id=3862))  
+This means that any modal, expected or not, will not be visible when the selenium-server-standalone is running.  Expected alerts ('Are you sure?') also do not appear, even when manually clicking link or button that should produce alert. 
+
+### Firefox
+
+Firefox support is built into the selenium-webdriver gem (required by the watir-webdriver gem) for both Windows and OSX.  
+
 ### Chrome
-To setup support for Google Chrome browser, please download the latest Chromedriver version from [here](http://code.google.com/p/chromedriver/downloads/list) 
+To setup support for Google Chrome browser, please download the latest Chromedriver version for your platform from [here](http://code.google.com/p/chromedriver/downloads/list)
 
-Then move the executables in your PATH. To find your PATH, type the command below in your terminal/command prompt:
+Then move the executables into your PATH. To find your PATH, type the command below in your terminal/command prompt:
 
-For Mac OSX:
+For OSX:
 
     echo $PATH
 
 For Windows:
 
     PATH
- 
-We suggest putting both drivers in \Ruby187\bin as it should already be in your path.
-   
-### Internet Explorer
-To setup support for Internet Explorer, please download the latest IEDriverServer version from [here](http://code.google.com/p/selenium/downloads/list) 
+
+### Internet Explorer (Windows only)
+To setup support for Internet Explorer, please download the latest IEDriverServer version from [here](http://code.google.com/p/selenium/downloads/list)
 and move the executable into your PATH.
 
+We suggest putting the Chrome and IE drivers in C:\Ruby187\bin (in Windows) as it should already be in 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. Follow the instructions in each IDE for creating and executing run/debug configurations.
@@ -122,15 +184,15 @@ For additional information on IDE setup, refer to the links below:
 ## Command Line Execution
 If you prefer to run your tests from command line, you can use the following command
 
-  `awetestlib <script_file> [parameters]`
+  `awetestlib <script_file> [options]`
 
   For example: To run a script named demo.rb in Firefox, your command will look like:
 
   `awetestlib demo.rb -b FF`
 
-Here is the full list of the currently available command line parameters:
+Here is the full list of the currently available command line options:
 
-    Usage: awetestlib <script_file> [parameters]
+    Usage: awetestlib <script_file> [options]
         -b, --browser BROWSER            Specify a browser (IE, FF, S, C)
         -r, --root_path ROOT_PATH        Specify the root path (default is current path)
         -l, --library LIBRARY            Specify a library to be loaded
@@ -142,7 +204,7 @@ Here is the full list of the currently available command line parameters:
         -u, --selenium_remote_url URL    Specify the device's remote url and port
         -s, --screencap_path PATH        Specify the path where screenshots will be saved
         -o, --output_to_log              Write to log file
-            --log_path_subdir SUBDIR     Specify log path relative to root_path
+            --log_path_subdir SUBDIR     Specify log path relative to root_path. Defaults to (root_path)/log if -o is specified.
 		-p, --pry						 Require Pry for debugging
 		-c, --classic_watir				 Use Classic Watir for IE instead of Watir-webdriver
             --report_all_test_refs       Include list of all error/test case reference ids actually validated
@@ -151,7 +213,7 @@ To start writing your own script, refer to the [Scripting Guide/Wiki](https://gi
 
 For the latest documentation of the Awetest DSL go to [Rubydoc](http://rubydoc.info/gems/awetestlib) and look in Awetestlib::Regression.
 
-### Cucumber Support 
+### 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:
 
@@ -159,6 +221,4 @@ One of the technologies that the Awetest framework supports is [Cucumber](http:/
 
 That will create the standard cucumber folder structure in the ProjectName directory.
 
-Visit our [wiki](https://github.com/3qilabs/awetestlib/wiki/Predefined-Cucumber-Web-Steps) to see the list of predefined steps provided by awetestlib
-
-
+Visit our [wiki](https://github.com/3qilabs/awetestlib/wiki/Predefined-Cucumber-Web-Steps) to see the list of predefined steps provided by awetestlib.

data/awetestlib.gemspec

@@ -1,57 +1,46 @@
 # -*- encoding: utf-8 -*-
 puts "#{$0}"
-require "lib/version"
-
-#hack for debugging
-`wellsproxy`
-#end hack
+require File.expand_path('../lib/version', __FILE__)
 
 Gem::Specification.new do |s|
 
-  s.name = "awetestlib"
-  s.version = Awetestlib::VERSION
-  s.date = Awetestlib::VERSION_DATE
-  s.platform = Gem::Platform::RUBY
+  s.name     = %q{awetestlib}
+  s.version  = Awetestlib::VERSION
+  s.date     = Awetestlib::VERSION_DATE
+  s.platform = Gem::Platform::CURRENT
+
+  s.metadata                  = {
+      "version"         => Awetestlib::VERSION.to_s,
+      "git_branch"      => Awetestlib::BRANCH.to_s,
+      "git_commit"      => Awetestlib::SHA.to_s,
+      "git_commit_date" => Awetestlib::SHA_DATE.to_s
+  }
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Anthony Woo", "Patrick Neve"]
-  s.email = %q{patrick@3qilabs.com}
-  s.summary = %q{Awetest DSL for automated testing of browser-based applications.}
-  s.homepage = %q{http://3qilabs.com}
-  s.description = %q{Awetest DSL for automated testing of browser-based applications.}
-
-  # possible dependencies (from shamisen gemfile)
-  #s.add_dependency('i18n')
-
-  # windows specific
-  #s.add_dependency('watir', '1.8.1')
-  #s.add_dependency('commonwatir', '1.8.1')
-  #s.add_dependency('firewatir', '1.8.1')
-  #s.add_dependency('watirloo')
-  #s.add_dependency('win32-process')
-  #s.add_dependency('win32screenshot')
-
-  # all platforms?
-  begin
-    #s.add_dependency('ffi', '= 1.0.9')
-    s.add_dependency('activesupport', '~> 3.0.0')
-    s.add_dependency('watir-webdriver')
-    s.add_dependency('andand')
-    s.add_dependency('spreadsheet', '0.6.8')
-    s.add_dependency('google-spreadsheet-ruby', '0.1.6')
-    s.add_dependency('roo', '1.10.1')
-    #s.add_dependency('selenium-client')   # for running selenium scripts
-    s.add_dependency('selenium-webdriver')
-  rescue
-    puts "#{$!}"
-  end
-
-  s.require_paths = ["lib","ext"]
-  s.files = `git ls-files`.split("\n")
-  s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-
-  #This line tells rubygems to look for an extension to install
-  s.extensions << 'ext/mkrf_conf.rb'
+  s.authors                   = ["Patrick Neve", "Anthony Woo"]
+  s.email                     = %q{patrick@3qilabs.com}
+  s.summary                   = %q{Awetest DSL for automated testing desktop and mobile browser-based applications.}
+  s.homepage                  = %q{http://3qilabs.com}
+  s.description               = %q{Features robust and flexible reporting.}
+
+  s.add_dependency('watir-webdriver')
+  s.add_dependency('watir-nokogiri')
+  s.add_dependency('activesupport', '~> 4.2', '>= 4.2.0')
+  s.add_dependency('andand')
+  s.add_dependency('roo', '~> 2.0', '>= 2.0.1')
+  s.add_dependency('selenium-webdriver')
+  s.add_dependency('nokogiri')
+  s.add_dependency('i18n')
+  s.add_dependency('appium_lib', '~> 6.0')
+  s.add_dependency('pry')
+  s.add_dependency('sys-uname')
+  s.add_dependency('w3c_validators')
+  s.add_dependency('html_validation')
+  s.add_dependency('git')
+
+  s.require_paths = ["lib"]
+  s.files         = `git ls-files`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
 
 end
 

data/awetestlib_osx.gemspec

@@ -1,5 +1,5 @@
 # -*- encoding: utf-8 -*-
-require "lib/version"
+require File.expand_path('../lib/version', __FILE__)
 
 Gem::Specification.new do |s|
 
@@ -8,34 +8,40 @@ Gem::Specification.new do |s|
   s.date = Awetestlib::VERSION_DATE
   s.platform = Gem::Platform::RUBY
 
+  s.metadata                  = {
+      "version"         => Awetestlib::VERSION.to_s,
+      "git_branch"      => Awetestlib::BRANCH.to_s,
+      "git_commit"      => Awetestlib::SHA.to_s,
+      "git_commit_date" => Awetestlib::SHA_DATE.to_s
+  }
+
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Anthony Woo", "Patrick Neve"]
-  s.email = %q{patrick@3qilabs.com}
-  s.summary = %q{Awetest DSL for automated testing of browser-based applications.}
-  s.homepage = %q{http://3qilabs.com}
-  s.description = %q{Awetest DSL for automated testing of browser-based applications.}
+  s.authors                   = ["Patrick Neve", "Anthony Woo"]
+  s.email                     = %q{patrick@3qilabs.com}
+  s.summary                   = %q{Awetest DSL for automated testing desktop and mobile browser-based applications.}
+  s.homepage                  = %q{http://3qilabs.com}
+  s.description               = %q{Features robust and flexible reporting.}
 
   s.add_dependency('watir-webdriver')
-  s.add_dependency('activesupport', '~> 3.0.0')
+  s.add_dependency('watir-nokogiri')
+  s.add_dependency('activesupport', '~> 4.2', '>= 4.2.0')
   s.add_dependency('andand')
-  s.add_dependency('spreadsheet', '0.6.8')
-  s.add_dependency('google-spreadsheet-ruby', '0.1.6')
-  s.add_dependency('roo', '1.10.1')
-  s.add_dependency('multipart-post', '1.1.4')
+  s.add_dependency('roo', '~> 2.0', '>= 2.0.1')
   s.add_dependency('selenium-webdriver')
   s.add_dependency('nokogiri')
   s.add_dependency('i18n')
-  s.add_dependency('rb-appscript')
+  s.add_dependency('appium_lib', '~> 6.0')
   s.add_dependency('pry')
-  s.add_dependency('cucumber')
-  s.add_dependency('calabash-cucumber')
   s.add_dependency('sys-uname')
-  s.require_paths = ["lib"]   #,"ext"]
+  s.add_dependency('w3c_validators')
+  s.add_dependency('html_validation')
+  s.add_dependency('git')
+
+  #s.add_dependency('rb-appscript')
+
+  s.require_paths = ["lib"]
   s.files = `git ls-files`.split("\n")
   s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
 
-  #This line tells rubygems to look for an extension to install
-  #s.extensions = ["ext\\mkrf_conf.rb"]
-
 end
 

data/awetestlib_windows.gemspec

@@ -0,0 +1,46 @@
+# -*- encoding: utf-8 -*-
+puts "#{$0}"
+require File.expand_path('../lib/version', __FILE__)
+
+Gem::Specification.new do |s|
+
+  s.name     = %q{awetestlib}
+  s.version  = Awetestlib::VERSION
+  s.date     = Awetestlib::VERSION_DATE
+  s.platform = Gem::Platform::CURRENT
+
+  s.metadata                  = {
+      "version"         => Awetestlib::VERSION.to_s,
+      "git_branch"      => Awetestlib::BRANCH.to_s,
+      "git_commit"      => Awetestlib::SHA.to_s,
+      "git_commit_date" => Awetestlib::SHA_DATE.to_s
+  }
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors                   = ["Patrick Neve", "Anthony Woo"]
+  s.email                     = %q{patrick@3qilabs.com}
+  s.summary                   = %q{Awetest DSL for automated testing desktop and mobile browser-based applications.}
+  s.homepage                  = %q{http://3qilabs.com}
+  s.description               = %q{Features robust and flexible reporting.}
+
+  s.add_dependency('watir-webdriver')
+  s.add_dependency('watir-nokogiri')
+  s.add_dependency('activesupport', '~> 4.2', '>= 4.2.0')
+  s.add_dependency('andand')
+  s.add_dependency('roo', '~> 2.0', '>= 2.0.1')
+  s.add_dependency('selenium-webdriver')
+  s.add_dependency('nokogiri')
+  s.add_dependency('i18n')
+  s.add_dependency('appium_lib', '~> 6.0')
+  s.add_dependency('pry')
+  s.add_dependency('sys-uname')
+  s.add_dependency('w3c_validators')
+  s.add_dependency('html_validation')
+  s.add_dependency('git')
+
+  s.require_paths = ["lib"]
+  s.files         = `git ls-files`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+
+end
+