qa_robusta 0.1.3

data/qa_observer/lib/test_extention.rb

@@ -0,0 +1,29 @@
+module TestExtention
+  def self.require_for_platform
+    @do_screenshot=true
+    if RUBY_PLATFORM =~ /win/i
+      require 'win32screenshot'
+      base_windows_bin="..\\..\\windows_bin\\"
+      ENV['PATH'] = "#{base_windows_bin}Mozilla_Firefox_309;#{base_windows_bin};#{base_windows_bin}lynx#{ENV['PATH']}"
+    # image magic will not work with jruby so not going to take shots
+    elsif RUBY_PLATFORM =~ /java/i
+      @do_screenshot=false
+    else
+    end
+  end
+
+  def self.screen_shot(method_name, at=nil, size = {:width => 800, :height => 600})
+    file = "#{File.expand_path(File.dirname(__FILE__))}/../tmp/images/#{$sequence}_#{Time.to_md5}_#{method_name}_#{at}.jpg"
+    @images << file
+    if at == 'post'
+      sleep 0.2
+    end
+    Watir::Screen.shot.resize(size[:width], size[:height]).write(file)
+    $sequence += 1
+  end 
+
+  def self.get_images
+    @images
+  end
+end
+

data/qa_observer/lib/update_element.rb

@@ -0,0 +1,12 @@
+base = File.expand_path(File.dirname(__FILE__))
+
+Dir.open("#{base}/firewatir").each { |i|
+  file = "#{base}/firewatir/#{i}"
+  next if File.directory?(file)
+  f = File.read(file)
+  f = f.gsub("< Element", "< Tmp::Element")
+  fd=File.open(file, 'w+')
+  fd.puts f
+  fd.close
+}
+

data/qa_observer/lib/watir.rb

@@ -0,0 +1,42 @@
+module ImageWrap
+  def self.included(klass)
+    klass.instance_methods(false).each do |existing_method|
+      if existing_method == :click
+        wrap(klass, existing_method)
+      end
+    end
+  end
+    
+  def self.wrap(klass, method) 
+    klass.class_eval do
+      name = method.to_s
+      original_method = instance_method(name)
+
+      define_method(name) do |*args, &block|
+        TestExtention.screen_shot($current_test_method, 'pre')
+        result = original_method.bind(self).call(*args, &block)
+        TestExtention.screen_shot($current_test_method, 'post')
+        result
+      end
+    end
+  end
+end
+
+module Watir
+  module Screen
+    def self.shot
+      if RUBY_PLATFORM =~ /win/i
+        width, height, bitmap = Win32::Screenshot.desktop
+        img_lst = Magick::ImageList.new
+        img_lst.from_blob(bitmap)
+      else 
+        Magick::Image.capture(silent=true, frame=false, descent=false, 
+                              screen=true, borders=false) { self.filename = 'root' }
+      end
+    end
+  end
+  class Element
+    include ImageWrap
+  end
+end
+

data/qa_observer/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:taza, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/qa_observer/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+#RubiGen::Base.use_component_sources! [:taza, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/qa_observer/sites/demo/conf/base_urls.yaml

@@ -0,0 +1,6 @@
+:test:
+  :demo_home: http://127.0.0.1:9090
+:development:
+  :demo_home: http://127.0.0.1:9090
+:production:
+  :demo_home: http://127.0.0.1:9090

data/qa_observer/sites/demo/conf/html_elements.yaml

@@ -0,0 +1,22 @@
+--- 
+:some_page:
+  :page_element1:
+    :type: text_field
+    :what: "watir's what parameter"
+    :what: "watir's how parameter"
+  :page_element2:
+    :type: text_field
+    :what: "watir's what parameter"
+    :what: "watir's how parameter"
+:another_page:
+  :page_element1:
+    :type: text_field
+    :what: "watir's what parameter"
+    :what: "watir's how parameter"
+  :page_element2:
+    :type: text_field
+    :what: "watir's what parameter"
+    :what: "watir's how parameter"
+
+
+

data/qa_observer/sites/demo/conf/remote_machine.yaml

@@ -0,0 +1,12 @@
+:test:
+  :ssh_ip: 127.0.0.1
+  :ssh_user: cliff
+  :ssh_password:
+:development:
+  :ssh_ip: 127.0.0.1
+  :ssh_user: cliff
+  :ssh_password: 
+:production:
+  :ssh_ip: 127.0.0.1
+  :ssh_user: cliff
+  :ssh_password: 

data/qa_observer/sites/demo/conf/users_list.yaml

@@ -0,0 +1,21 @@
+:development:
+  :manager: 
+    :user: 'user1'
+    :password: 'user1_password'
+  :employee: 
+    :user: 'user2'
+    :password: 'user2_password'
+:test:
+  :manager: 
+    :user: 'user1'
+    :password: 'user1_password'
+  :employee: 
+    :user: 'user2'
+    :password: 'user2_password'
+:production:
+  :manager: 
+    :user: 'user1'
+    :password: 'user1_password'
+  :employee: 
+    :user: 'user2'
+    :password: 'user2_password'

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

@@ -0,0 +1,9 @@
+module Demo 
+  class HomePage < SystemTest
+    def initialize
+      element(:file_status) {$browser.div(:id, 'create_file_status')}
+      element(:create_file_text_field) {$browser.text_field(:id, 'create_file_name')}
+      element(:submit_create_file) {$browser.button(:id, 'create_file')}
+    end 
+  end
+end

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

@@ -0,0 +1,37 @@
+base = File.expand_path(File.dirname(__FILE__))
+require "#{$qa_observer_client}/lib/system_test"
+
+class DemoFlows < 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
+  def initialize
+    # NOTE: Define an instance of an element page 
+    # in order for flow methods to be able to access
+    # elements.  @login_page is an example the demo
+    # login method below utilizes.  It's also a good idea
+    # to include in the attr_reader list so that the flows 
+    # 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
+  end
+
+=begin
+  Best Practice: Anytime arriving at a page it's a best practice to wait for
+  the last element on the page to load(wait_for).  
+=end
+  def home
+    $browser.goto($test_data[:base_urls][$test_environment][:demo_home])
+    wait_for(5) { @home_page.submit_create_file.exists? }
+  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 != '' }
+  end
+end
+

data/qa_observer/sites/demo/lib/navigate.rb

@@ -0,0 +1,32 @@
+class Navigate
+  attr_reader :browser
+  def initialize(browser)
+    @browser = browser
+  end
+  def go(nav_path=[])
+    raise ArgumentError if nav_path.class != Array || nav_path.nitems < 1 
+    nav_path.each { |item|
+      case item[:type]
+        when 'link'
+          exec = "@browser.link(#{item[:how]}, #{item[:what]}).#{item[:action]}"
+          eval exec
+        when 'text_field'
+          if item.has_key?(:value)
+            # escape ' in item[:value] as it's used for quoted string in the set
+            #item[:value].gsub(/'/, /\'/)
+            exec = "@browser.text_field(#{item[:how]}, #{item[:what]}).#{item[:action]}('#{item[:value]}')"
+            eval exec
+          end
+        when 'check_box'
+          # escape ' in item[:value] as it's used for quoted string in the set
+          #item[:value].gsub(/'/, /\'/)
+          exec = "@browser.checkbox(#{item[:how]}, #{item[:what]}).#{item[:action]}"
+          eval exec
+        when 'submit'
+            exec = "@browser.button(#{item[:how]}, #{item[:what]}).#{item[:action]}"
+            eval exec
+         
+      end
+    }  
+  end
+end

data/qa_observer/sites/demo/lib/reports.rb

@@ -0,0 +1,7 @@
+require 'pdf/writer'
+
+module BuildReport
+  def pdf(report)
+    
+  end  
+end

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

@@ -0,0 +1,106 @@
+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 HomePage < 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
+    @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 
+  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
+  
+  # TODO: add test methods
+  # don't forget to update the documentation associated with each test method,
+  # by placing an rdoc style comment in plain text.  The documentation will be
+  # included in the report for each execution.
+
+=begin rdoc
+   Test Purpose:
+   After the user arrives on the home page verify the following elements exists:
+   * Div with id = create_file_status
+   * Text field with id= create_file_name
+   * Submit button with id = create_file
+
+   Verify the user can enter a value in the create_file_name text field
+=end
+  def test_home_elements
+     @demo_flows.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
+  end
+
+=begin rdoc
+   Test Purpose:
+   After the user arrives on the home page verify the create file feature
+
+   Steps:
+   * Naviage to the home page
+   * Enter a file name in the Create Tmp File text field
+   * Click the Create Tmp File submit button
+   * Verify a message is displayed on the home page that the file was created
+   * 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')
+  end
+
+=begin rdoc
+   Test Purpose:
+   After the user arrives on the home page verify when no file name is provided a
+   message is provided informing the user to provide a file name
+
+   Steps:
+   * Naviage to the home page
+   * Click the Create Tmp File submit button
+   * Verify a message is displayed on the home page to provide a file name
+   * Login to the remote machine hosting the web site and ensure that no file was
+     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')
+    assert_equal remote_tmp_files_pre, remote_tmp_files_post
+  end
+
+end
+
+
+

data/qa_observer/suites/demo_lg_chrome/lg.yaml

@@ -0,0 +1,11 @@
+--- 
+# global setup items, can override on a per suite basis
+:default:
+  :browser: chrome
+
+:suites:
+  - :site: demo
+    :test_case_file: home_page.rb
+    :environment: production
+    :methods_to_execute: test_error_message_with_no_file_name
+

data/qa_observer/suites/demo_md_chrome/md.yaml

@@ -0,0 +1,11 @@
+--- 
+# global setup items, can override on a per suite basis
+:default:
+  :browser: chrome
+
+:suites:
+  - :site: demo
+    :test_case_file: home_page.rb
+    :environment: production
+    :methods_to_execute: test_file_created 
+

data/qa_observer/suites/demo_sm_chrome/sm.yaml

@@ -0,0 +1,11 @@
+--- 
+# global setup items, can override on a per suite basis
+:default:
+  :browser: chrome
+
+:suites:
+  - :site: demo
+    :test_case_file: home_page.rb
+    :environment: production
+    :methods_to_execute: test_home_elements
+

data/qa_observer/suites/init.rb

@@ -0,0 +1,41 @@
+require 'yaml'
+
+module SuiteHelper
+  def self.exec(suite, junit=false, proxy=nil)
+    base = File.expand_path(File.dirname(__FILE__))
+    cfg = YAML::load_file(suite)
+
+    optional_options = ''  
+    
+    if proxy
+      optional_options += " --proxy=#{proxy}"           
+    end
+
+    if junit
+      optional_options += " --format=junit"
+    end
+    
+    cfg[:suites].each { |test|
+      puts "looking at test: #{test.inspect}"
+
+      # if the current test for the suite has a browser use that
+      # else take default browser  
+      if test.has_key?(:browser)
+        browser = test[:browser]
+      else
+        browser = cfg[:default][:browser]
+      end
+
+      params = "--site=#{test[:site]} --file_name=#{test[:test_case_file]} --execute_methods=#{test[:methods_to_execute]} --browser=#{browser} --environment=#{test[:environment]} #{optional_options}"      
+      
+      puts "executing test_runner with options: #{params}"
+      out = `ruby #{base}/../test_runner.rb  #{params}`        
+      puts out        
+
+    }
+  end
+end
+
+suite = ARGV[0]
+raise ArgumentError unless File.exists? suite
+SuiteHelper.exec suite