qa_robusta 0.1.8 → 0.1.9

data/lib/qa_robusta.rb

@@ -1,3 +1,3 @@
 class QaRobusta
-  VERSION = '0.1.8'
+  VERSION = '0.1.9'
 end

data/qa_observer/lib/doc.rb

@@ -20,14 +20,18 @@ module TCDoc
       }
     }
     html += "</body></html>"
-    fd = File.open(save_to, 'w+')
-    fd.puts html
-    fd.close
+    begin
+      fd = File.open(save_to, 'w+')
+      fd.puts html
+      fd.close
+    rescue => e
+    end
   end
 
   def self.class_names_from_file(file_content)
     class_names = file_content.grep(/class .* <.*SystemTest/)
     class_names.each_with_index { |name, ct|
+
       class_names[ct] = name.gsub!(/\n|class| |<|SystemTest/, '')
     }
     class_names
@@ -61,7 +65,7 @@ module TCDoc
     }
     
     html=''
-    `#{$test_case_dir}/../../../../common/gems/installed/gems/rdoc-3.9.4/bin/rdoc -o #{rdoc_dir} #{execution_file}`
+    `#{$test_case_dir}/../../../../common/gems/installed/bin/rdoc -o #{rdoc_dir} #{execution_file}`
     current_test_class.gsub!(/\r/, '')
     rdoc_content = File.read("#{rdoc_dir}/#{current_test_class}.html")
     doc=Hpricot(rdoc_content)

data/qa_observer/lib/form_helpers.rb

@@ -10,7 +10,7 @@ module FormHelpers
     command maps to.
 EOF
     
-    raise ArgumentError, msg unless params.nitems > 0 && objs.nitems > 0
+    #raise ArgumentError, msg unless params.nitems > 0 && objs.nitems > 0
     
     checkbox_state=[true, false]
     params.each { |i|

data/qa_observer/lib/watir.rb

@@ -1,8 +1,23 @@
-module WatirExtention
+module WatirBrowserExtention
+  def self.included(klass)
+    add_alert_box(klass)
+  end
+
+  def self.add_alert_box(klass)
+    klass.class_eval {
+      define_method('alert_box') { |*args, &block|
+        driver.switch_to.alert
+      }
+    }
+  end
+end
+
+module WatirElementExtention
   def self.included(klass)
     image_wrap(klass)
     add_scroll_to(klass)
     add_in_viewable_area?(klass)
+    add_mouseover(klass)
   end
 
   def self.image_wrap(klass)
@@ -30,25 +45,18 @@ module WatirExtention
 	    var w = 0;
 	    var h = 0;
 	    if(!window.innerWidth) {
-              w = window.pageXOffset;h = window.pageYOffset; 
-/*
-              if(!(document.documentElement.clientWidth == 0)) { 
-                w = document.documentElement.clientWidth + document.body.scrollLeft; 
-                h = document.documentElement.clientHeight + document.body.scrollTop; 
-                //w = document.documentElement.clientWidth + document.body.scrollLeft; 
-                //h = document.documentElement.clientHeight + document.body.scrollTop; 
-              } else { 
-               w = window.pageXOffset; 
-               h = window.pageYOffset; 
-              // w = document.body.clientWidth + window.pageXOffset; 
-              // h = document.body.clientHeight + window.pageYOffset; 
-              }
-*/
-            } else { w = window.pageXOffset; h = window.pageYOffset; }
-            return {x: h, y: w}
+              x = document.documentElement.clientWidth + document.body.scrollLeft; 
+              y = document.documentElement.clientHeight + document.body.scrollTop; 
+            } else { 
+              x = window.pageXOffset + window.innerWidth;
+              y = window.pageYOffset + window.innerHeight;
+            }
+            return {x: x, y: y}
           EOF
+
           d = driver.execute_script(script) 
-          element_location.x >= d['y'] && element_location.y <= d['x']
+          element_location.x <= d['x'] && element_location.y <= d['y']
+
         else
           return false
         end
@@ -59,30 +67,20 @@ module WatirExtention
   def self.add_scroll_to(klass)
     klass.class_eval {
       define_method('scroll_to') { |*args, &block|
-        
-        if self.id == '' && self.name != ''
-          element = "element = document.getElementsByName(\"#{self.name}\")[0];"
-        elsif self.id != '' && self.name == ''
-          element = "element = document.getElementById(\"#{self.id}\");"
-        end
-      
-        if element
-          # javascript borrowed from: 
-          # http://radio.javaranch.com/pascarello/2005/01/09/1105293729000.html
-          script=<<-EOF
-            function ScrollToElementByID(id){
-              #{element} var selectedPosX = 0; var selectedPosY = 0;
-              while(element != null) { selectedPosX += element.offsetLeft; selectedPosY += element.offsetTop; element = element.offsetParent; }
-              window.scrollTo(selectedPosX,selectedPosY);
-            }
-            ScrollToElementByID("#{self.id}");
-          EOF
-          driver.execute_script(script) 
-        end
+        wd.location_once_scrolled_into_view 
       }
     }
     
   end
+
+  def self.add_mouseover(klass)
+    klass.class_eval {
+      define_method('mouseover') { |*args, &block|
+        driver.mouse.move_to(wd)
+      }
+    }
+  end
+
 end
 
 module Watir
@@ -90,8 +88,7 @@ module Watir
     def self.shot
       if RUBY_PLATFORM =~ /win/i
         width, height, bitmap = Win32::Screenshot.desktop
-        img_lst = Magick::ImageList.new
-        img_lst.from_blob(bitmap)
+        Magick::ImageList.new.from_blob(bitmap)
       else 
         Magick::Image.capture(silent=true, frame=false, descent=false, 
                               screen=true, borders=false) { self.filename = 'root' }
@@ -99,7 +96,10 @@ module Watir
     end
   end
   class Element
-    include WatirExtention
+    include WatirElementExtention
+  end
+  class Browser
+    include WatirBrowserExtention
   end
 end
 

data/qa_observer/sites/demo/elements/demo_elements.rb

@@ -1,5 +1,5 @@
 module Demo 
-  class HomePage < SystemTest
+  class HomeElements < SystemTest
     def initialize
       element(:file_status) {$browser.div(:id, 'create_file_status')}
       element(:create_file_text_field) {$browser.text_field(:id, 'create_file_name')}
@@ -8,4 +8,53 @@ module Demo
       element(:link_with_name) {$browser.link(:name, 'link_with_no_id_but_has_name')}
     end 
   end
+
+  class RegisterElements < SystemTest
+    def initialize
+      element(:email) { $browser.text_field(:id, 'email') }
+      element(:email_error) { $browser.div(:id, 'email_error') }
+      element(:password) { $browser.text_field(:id, 'password') }
+      element(:password_error) { $browser.div(:id, 'password_error') }
+      element(:password) { $browser.text_field(:id, 'password') }
+      element(:step_1_div) { $browser.div(:id => 'step_1') }
+      element(:step_2_div) { $browser.div(:id => 'step_2') }
+      element(:step_1_displayed?) { step_1_div.html.grep(/ui-accordion-content-active/).length > 0 }
+      element(:step_2_displayed?) { step_2_div.html.grep(/ui-accordion-content-active/).length > 0 }
+      element(:step_navigation_div) { $browser.div(:id, 'step_navigation_left') }
+      element(:step_1_next) { step_1_div.link(:title => 'Move on to Step 2') }
+      element(:step_2_next) { step_2_div.link(:title => 'Move on to Step 3') }
+      element(:step_2_prev) { step_2_div.link(:title => 'Go back to Step 1') }
+      
+     
+    end 
+  end
+
+  class TabElements < SystemTest
+    def initialize
+      element(:base) {$browser.link(:href, '#tab_base')}
+      element(:registration) {$browser.link(:href, '#tab_user_reg')}
+    end
+  end
+
+  class MenuElements < SystemTest
+    def initialize
+      element(:full_menu_div) {$browser.div(:id, 'main_menu')}
+      element(:actions_menu_item) { full_menu_div.link(:text, 'Actions') }
+      element(:test_alert_menu_item) {
+                                       actions_menu_item.mouseover 
+                                       full_menu_div.link(:text, 'Test Alert') 
+                                     }
+      element(:test_modal_dialog_menu_item) { 
+                                              actions_menu_item.mouseover 
+                                              full_menu_div.link(:text, 'Test Modal Dialog') 
+                                            }
+
+      element(:test_dialog_menu_item) { 
+                                        actions_menu_item.mouseover 
+                                        full_menu_div.link(:text, 'Test Dialog') 
+                                      }
+
+    end 
+  end
+
 end

data/qa_observer/sites/demo/flows/demo_flows.rb

@@ -1,11 +1,11 @@
 base = File.expand_path(File.dirname(__FILE__))
 require "#{$qa_observer_client}/lib/system_test"
 
-class DemoFlows < SystemTest
+class SiteFlows < SystemTest
   # provide a means for the flow instance to access the elements.
   # this is handy from the test case perspective as it will have
   # access to the flow's but not the elements directly
-  attr_reader :home_page
+  attr_reader :home_page_elements, :register_flows, :menu_elements, :tab_elements
   def initialize
     # NOTE: Define an instance of an element page 
     # in order for flow methods to be able to access
@@ -15,7 +15,10 @@ class DemoFlows < SystemTest
     # instance defined in a test class can access the element
     # objects without the need to re-instantiate from the test
 
-    @home_page = Demo::HomePage.new
+    @home_page_elements = Demo::HomeElements.new
+    @register_flows = RegisterFlows.new
+    @tab_elements = Demo::TabElements.new
+    @menu_elements = Demo::MenuElements.new
   end
 
 =begin
@@ -24,14 +27,36 @@ class DemoFlows < SystemTest
 =end
   def home
     $browser.goto($test_data[:base_urls][$test_environment][:demo_home])
-    wait_for(5) { @home_page.submit_create_file.exists? }
+    @home_page_elements.submit_create_file.wait_until_present
   end
 
   def create_file(file_name='')
     home
-    @home_page.create_file_text_field.set(file_name)
-    @home_page.submit_create_file.click
-    wait_for(2) { @home_page.file_status.text != '' }
+    @home_page_elements.create_file_text_field.set(file_name)
+    @home_page_elements.submit_create_file.click
+    wait_for(2) { @home_page_elements.file_status.text != '' }
+  end
+end
+
+
+class RegisterFlows < SiteFlows
+  attr_reader :register_elements, :tab_elements
+  def initialize
+    @register_elements = Demo::RegisterElements.new
+    @tab_elements = Demo::TabElements.new
+  end
+  def home
+    $browser.goto($test_data[:base_urls][$test_environment][:demo_home])
+    @tab_elements.registration.click 
+  end
+  def step_1(params={})
+    params[:submit] ||= 'true'
+    params[:submit] = params[:submit].to_bool
+    params[:email] ||= ''
+    params[:password] ||= ''
+    @register_elements.email.set(params[:email]) if params[:email] != ''
+    @register_elements.password.set(params[:password]) if params[:password] != ''
+    @register_elements.step_1_next.click if params[:submit]
   end
 end
 

data/qa_observer/sites/demo/test_cases/home_page.rb

@@ -20,11 +20,8 @@ class HomePage < SystemTest
     # parameter to the interpreter default to :test
     $test_environment ||= :test
     super
-    @remote_unix = RemoteUnix::GeneralUnix.new(:host => $test_data[:remote_machine][$test_environment][:ssh_ip], 
-                                               :user => $test_data[:remote_machine][$test_environment][:ssh_user], 
-                                               :password => $test_data[:remote_machine][$test_environment][:ssh_password])
   
-    @demo_flows = DemoFlows.new 
+    @browse_site = SiteFlows.new 
   end
 
   def teardown
@@ -54,13 +51,13 @@ class HomePage < SystemTest
    Verify the user can enter a value in the create_file_name text field
 =end
   def test_home_elements
-     @demo_flows.home
+     @browse_site.home
      assert_equal $test_data[:base_urls][$test_environment][:demo_home].gsub(/\/$/, ''), $browser.url.gsub(/\/$/, '')
-     assert @demo_flows.home_page.file_status.exists?
-     assert @demo_flows.home_page.create_file_text_field.exists?
-     assert @demo_flows.home_page.submit_create_file.exists?
-     @demo_flows.home_page.create_file_text_field.set('blah')
-     assert_equal 'blah', @demo_flows.home_page.create_file_text_field.value
+     assert @browse_site.home_page_elements.file_status.exists?
+     assert @browse_site.home_page_elements.create_file_text_field.exists?
+     assert @browse_site.home_page_elements.submit_create_file.exists?
+     @browse_site.home_page_elements.create_file_text_field.set('blah')
+     assert_equal 'blah', @browse_site.home_page_elements.create_file_text_field.value
   end
 
 =begin rdoc
@@ -75,9 +72,19 @@ class HomePage < SystemTest
    * Login to the remote machine and verify that the file exists
 =end
   def test_file_created
-     @demo_flows.create_file('blah')
-     assert_equal 'file created', @demo_flows.home_page.file_status.text
-     assert @remote_unix.file_exists?('/tmp/blah')
+    # if more than one test requires such a remote unix interface it's a best 
+    # practice to put this in the setup method and make it an instance var.
+    # But putting this in the single method so that if users not running an ssh server
+    # want to execute other test cases they can specify all test but test_file_create
+    # for the test runner or in a test suite.
+    remote_unix = RemoteUnix::GeneralUnix.new(:host => $test_data[:remote_machine][$test_environment][:ssh_ip], 
+                                              :user => $test_data[:remote_machine][$test_environment][:ssh_user], 
+                                              :password => $test_data[:remote_machine][$test_environment][:ssh_password])
+
+
+     @browse_site.create_file('blah')
+     assert_equal 'file created', @browse_site.home_page_elements.file_status.text
+     assert remote_unix.file_exists?('/tmp/blah')
   end
 
 =begin rdoc
@@ -93,10 +100,20 @@ class HomePage < SystemTest
      created
 =end
   def test_error_message_with_no_file_name
-    remote_tmp_files_pre = @remote_unix.ls('/tmp')
-    @demo_flows.create_file
-    assert_equal 'Please provide a file name', @demo_flows.home_page.file_status.text
-    remote_tmp_files_post = @remote_unix.ls('/tmp')
+
+    # if more than one test requires such a remote unix interface it's a best 
+    # practice to put this in the setup method and make it an instance var.
+    # But putting this in the single method so that if users not running an ssh server
+    # want to execute other test cases they can specify all test but test_file_create
+    # for the test runner or in a test suite.
+    remote_unix = RemoteUnix::GeneralUnix.new(:host => $test_data[:remote_machine][$test_environment][:ssh_ip], 
+                                              :user => $test_data[:remote_machine][$test_environment][:ssh_user], 
+                                              :password => $test_data[:remote_machine][$test_environment][:ssh_password])
+
+    remote_tmp_files_pre = remote_unix.ls('/tmp')
+    @browse_site.create_file
+    assert_equal 'Please provide a file name', @browse_site.home_page_elements.file_status.text
+    remote_tmp_files_post = remote_unix.ls('/tmp')
     assert_equal remote_tmp_files_pre, remote_tmp_files_post
   end
 

data/qa_observer/sites/demo/test_cases/test_element_scroll_to.rb

@@ -20,8 +20,8 @@ class TestElementScrollTo < SystemTest
     # parameter to the interpreter default to :test
     $test_environment ||= :test
     super
-    @demo_flows = DemoFlows.new 
-    @demo_flows.home
+    @browse_site = SiteFlows.new 
+    @browse_site.home
   end
 
   def teardown
@@ -45,10 +45,10 @@ class TestElementScrollTo < SystemTest
    3.  Verify that the element is now in the viewable area of the browser 
 =end
   def test_scroll_to_element_with_no_id_but_with_name
-     assert !@demo_flows.home_page.link_with_name.in_viewable_area?
-     @demo_flows.home_page.link_with_name.scroll_to
-     assert @demo_flows.home_page.link_with_name.in_viewable_area?
-     TestExtention.screen_shot($current_test_method, 'pre')
+     assert !@browse_site.home_page_elements.link_with_name.in_viewable_area?
+     @browse_site.home_page_elements.link_with_name.scroll_to
+     assert @browse_site.home_page_elements.link_with_name.in_viewable_area?
+     TestExtention.screen_shot($current_test_method, 'some_tag_name')
   end
 
 =begin rdoc
@@ -60,9 +60,9 @@ class TestElementScrollTo < SystemTest
    3.  Verify that the element is now in the viewable area of the browser 
 =end
   def test_scroll_to_element_with_id_but_no_name
-     assert !@demo_flows.home_page.link_with_id.in_viewable_area?
-     @demo_flows.home_page.link_with_id.scroll_to
-     assert @demo_flows.home_page.link_with_id.in_viewable_area?
+     assert !@browse_site.home_page_elements.link_with_id.in_viewable_area?
+     @browse_site.home_page_elements.link_with_id.scroll_to
+     assert @browse_site.home_page_elements.link_with_id.in_viewable_area?
      TestExtention.screen_shot($current_test_method, 'pre')
   end
 

data/qa_observer/sites/demo/test_cases/test_menu.rb

@@ -0,0 +1,59 @@
+base = File.expand_path(File.dirname(__FILE__))
+
+# If the user is executing the test case stand alone
+# without an agent we need to set a reference to
+# for where to find the qa_observer_client as well as let
+# the qa_observer_client know where the test case directory is
+#  URGENT: DO NOT MODIFY
+unless $qa_observer_client
+  TEST_CASE_DIR = "#{base}"
+  $qa_observer_client = File.expand_path("#{base}/../../..")
+end
+# END OF DO NOT MODIFY
+
+require "#{$qa_observer_client}/lib/system_test"
+require "#{$qa_observer_client}/lib/env_details.rb"
+
+class TestMenu < SystemTest
+  def setup
+    # if the user hasn't provided the environment as an input
+    # parameter to the interpreter default to :test
+    $test_environment ||= :test
+    super
+    @browse_site = SiteFlows.new
+    @browse_site.home
+
+  end
+
+  def teardown
+    # NOTE: Place all items you wish to do at after each test method
+    # in the unless @skip section before the $browser.close.  DO NOT
+    # remove this section as it's critical if the test class is executed
+    # by an agent. 
+    unless @skip
+      $browser.close if $browser
+    end
+
+    super
+  end
+  
+=begin rdoc
+   Test Purpose: Verify the Watir::Element#mouseover and Watir::Browser#alert_box
+                 extensions
+
+   Steps:
+   1.  <b>Navigate</b> to the demo site's home page
+   2.  <b>Mouse over</b> the <i>Actions</i> menu item
+   3.  <b>Click</b> the menu item with text <i>Test Alert</i>
+   4.  <b>Verify</b> an alert box is displayed with text <i>QA Robusta Test Alert</i>
+       If we see the alert box text the mouseover functioned properly, as
+       selenium-webdriver will not be able to locate menu item <i>Test Alert</i> unless
+       the menu is expanded via a mouseover.
+=end
+  def test_menu_item_alert
+    @browse_site.menu_elements.test_alert_menu_item.click
+    assert_equal 'QA Robusta Test Alert', $browser.alert_box.text
+    $browser.alert_box.dismiss
+  end
+
+end