rformspec 0.3.2-x86-mingw32 → 0.4-x86-mingw32

data/CHANGELOG

@@ -1,5 +1,12 @@
 CHANGELOG
 =========
+
+0.4 (2011-10)
+- Change Window class: not wait for active by default
+- using global variable reference to AutoIt3 OLE
+- New AutoIt class
+- Examples update
+
 0.3.2
 
 Add option in Window class to wait to focus window (default)

data/Rakefile

@@ -34,7 +34,7 @@ Rake::RDocTask.new { |rdoc|
 spec = Gem::Specification.new do |s|
   s.platform= Gem::Platform::CURRENT
   s.name = "rformspec"
-  s.version = "0.3.2"
+  s.version = "0.4"
   s.summary = "An wrap of AUTOIT3 for functional testing of Windows form applications"
   # s.description = ""
 

data/lib/rformspec/driver.rb

@@ -3,26 +3,9 @@ require 'win32ole'
 module RFormSpec
   module Driver
 
-    def init
-      driver
-    end
-
     def driver
-      return @a3 if @a3
-
-      @a3 = WIN32OLE.new('AutoItX3.Control')
-
-      @a3.AutoItSetOption("CaretCoordMode", 0);
-      @a3.AutoItSetOption("ColorMode", 1);
-      @a3.AutoItSetOption("MouseCoordMode", 0);
-      @a3.AutoItSetOption("PixelCoordMode", 0);
-      @a3.AutoItSetOption("SendKeyDelay", 15)
-      return @a3
-    end
-
-    def set_autoit_option(key, value)
-      init if @a3.nil?
-      @a3.AutoItSetOption(key, value)
+      return $a3 if $a3
+      return RFormSpec::AutoIt.init
     end
 
     def wait_for_window(win, timeout=30)
@@ -32,6 +15,7 @@ module RFormSpec
 
     def wait_and_focus_window(title, text="",  timeout=30)
       driver.WinWaitActive(title, text, timeout * 1000)
+      driver.WinActivate(title, text)
     end
 
     def window_exists?(title)
@@ -65,6 +49,15 @@ module RFormSpec
     end
     alias press_key key_press
 
+    # Wrapper of mouse operation
+    def mouse_move(x, y)
+      RFormSpec::Mouse.move_to(x, y)
+    end
+
+    def mouse_click(x, y)
+      RFormSpec::Mouse.click(x, y)
+    end
+
     # standard open file dialog
     def open_file_dialog(title, filepath)
       wait_and_focus_window(title)
@@ -75,6 +68,5 @@ module RFormSpec
     end
 
     #TODO: save as file dialog
-
   end
 end

data/lib/rformspec/window.rb

@@ -3,16 +3,24 @@ require File.dirname(__FILE__) + "/control"
 
 module RFormSpec
 
-
   class Window  < BaseControl
     attr_accessor :title, :text
-
-    def initialize(title, text = '', timeout = 10, options = {:wait => true})
+    
+    ##
+    # title : page title, depends autoit options, might use as substring match or exact match
+    # text:  some text in window for further identifing the window
+    # options: 
+    #   present => true | false,   already there
+    #   wait_timeout: wiat for maxium seconds if not active, throw error
+    #    (active: means the window becomes the active window)
+    # otherwise, inside window class, using focus_window methods
+    def initialize(title, text = '', options = {:present => false, :wait_timeout => 0})
       # for some windows, the title might change depends when it is invoked
       if title.class == Array
         title.each { |a_title|
           @title = a_title
           @text = text if text
+          timeout = options[:wait_timeout]
           result = driver.WinWaitActive(@title, @text, timeout)
           return if result != 0
         }
@@ -21,12 +29,14 @@ module RFormSpec
 
       @title = title
       @text = text if text
-      if options[:wait] then
-        result = driver.WinWaitActive(@title, @text, timeout)
-      else
+      timeout = options[:wait_timeout]
+      if options[:present]
         result = driver.WinActivate(@title, @text)
+        raise "window not found: #{self.to_s}" if result == 0
+      elsif timeout && timeout.to_i > 1 then
+        result = driver.WinWaitActive(@title, @text, timeout)
+        raise "timeout while waiting for window: #{self.to_s}" if result == 0
       end
-      raise "timeout while waiting for window: #{self.to_s}" if result == 0
     end
 
     def focus

data/lib/rformspec.rb

@@ -13,3 +13,29 @@ require File.dirname(__FILE__) + "/rformspec/open_file_dialog"
 require File.dirname(__FILE__) + "/rformspec/saveas_file_dialog"
 require File.dirname(__FILE__) + "/rformspec/process"
 require File.dirname(__FILE__) + "/rformspec/form_testcase"
+
+module RFormSpec
+
+  class AutoIt
+
+    def self.init
+      $a3 = WIN32OLE.new('AutoItX3.Control')
+
+      $a3.AutoItSetOption("WinSearchChildren", 1); # Search Children window as well
+      $a3.AutoItSetOption("WinTitleMatchMode", 2); 
+
+      $a3.AutoItSetOption("CaretCoordMode", 0);
+      $a3.AutoItSetOption("ColorMode", 1);
+      $a3.AutoItSetOption("MouseCoordMode", 0);
+      $a3.AutoItSetOption("PixelCoordMode", 0);
+      $a3.AutoItSetOption("SendKeyDelay", 15)
+      return $a3
+    end
+
+    def self.set_option(key, value)
+      self.init if $a3.nil?
+      $a3.AutoItSetOption(key, value)
+    end
+
+  end
+end

data/sample/form_calculator/calc_helper.rb

@@ -0,0 +1,68 @@
+require 'rformspec'
+
+module CalcSpecHelper
+  include RFormSpec::Driver
+
+  def run_calc
+    RFormSpec::Process.run("calc.exe")
+    @calc_win = RFormSpec::Window.new('Calculator', "", :wait_timeout => 2)
+  end
+  alias start_calc run_calc
+
+  def exit_calc
+    @calc_win.close
+  end
+
+  def click_3
+    @calc_win.click_button('127')  #3
+    sleep(0.5)
+  end
+
+  def click_7
+    @calc_win.click_button('131')  #7
+    sleep(0.5)
+  end
+
+  def click_add
+    @calc_win.click_button('92')   # +
+    sleep(0.5)
+  end
+  alias click_plus click_add
+
+  def click_multiply
+    @calc_win.click_button('91')   #*
+    sleep(0.5)
+  end
+
+  def click_equals
+    @calc_win.click_button('112')  #=
+    sleep(0.5)
+  end
+
+  def result
+    @calc_win.get_control_text('403')
+  end
+  alias get_result result
+
+  def perform(actions)
+    methods_to_call = actions.collect { |act|
+      case act
+      when '+':
+        'plus'
+      when '-':
+        'minus'
+      when '*':
+        'multiply'
+      when '=':
+        'equals'
+      else
+        act
+      end
+    }
+
+    methods_to_call.each { |met|
+      self.send("click_#{met}")
+    }
+    get_result
+  end
+end

data/sample/form_calculator/calc_spec.rb

@@ -0,0 +1,33 @@
+require File.join(File.dirname(__FILE__), 'calc_helper')
+
+describe 'Simple Calculation' do
+  include CalcSpecHelper
+
+  before (:all) do
+    start_calc
+  end
+
+  after(:all) do
+    exit_calc
+  end
+
+  it "can do adding" do
+    click_3
+    click_add
+    click_7
+    click_equals
+    result.should == "10. "
+  end
+
+  it "can do muliply" do
+    click_3
+    click_multiply
+    click_7
+    click_equals
+    result.should == "21. "
+  end
+
+  it "if you think above is good, we can make it more readable" do
+    perform(%w(3 + 7 =)).should == "10. "
+  end
+end

data/sample/form_calculator/calculator.tpr

@@ -0,0 +1,27 @@
+<?xml version="1.1" encoding="US-ASCII"?>
+<project>
+  <name>Calculator</name>
+  <default_browser></default_browser>
+  <test_framework>Watir</test_framework>
+  <syntax_framework>RWebSpec</syntax_framework>
+  <environments>
+  </environments>
+  <exclude_dirs></exclude_dirs>
+  <exclude_files></exclude_files>
+  <test_named_as>specification</test_named_as>
+  <spec_template></spec_template>
+  <page_template></page_template>
+  <storywise_url></storywise_url>
+  <jira_url></jira_url>
+  <jira_project></jira_project>
+  <jira_login></jira_login>
+  <jira_password></jira_password>
+  <heart_beat>
+    <spec_suite></spec_suite>
+    <environment></environment>
+    <start_time></start_time>
+    <repeat></repeat>
+    <end_repeat></end_repeat>
+    <emails></emails>
+  </heart_beat>
+</project>

data/sample/form_calculator/calculator.tws

@@ -0,0 +1,13 @@
+<?xml version="1.1" encoding="US-ASCII"?>
+<workspace>
+  <project_name>Calculator</project_name>
+  <project_file>C:\work\testwise\samples\form_calculator\calculator.tpr</project_file>
+  <opened_files>
+    <entry name="$PROJECT_DIR$/calc_spec.rb"/>
+  </opened_files>
+  <recent_files>
+    <entry name="$PROJECT_DIR$/calc_spec.rb"/>
+  </recent_files>
+  <test_suites>
+  </test_suites>
+</workspace>

data/sample/mouse.rb

@@ -0,0 +1,19 @@
+require 'rubygems'
+require 'rformspec'
+
+RFormSpec::AutoIt.set_option("WinSearchChildren", 1)
+
+class TextWiseWindow < RFormSpec::Window
+  def initialize(title = "TextWise", text = "", opts = {})
+     super(title, text, opts)
+     wait_and_focus_window(title) 
+  end
+
+end
+
+
+win = TextWiseWindow.new("TextWise", "", :present => true)
+win.mouse_move(90, 30)
+#win.mouse_click(241, 645)
+win.mouse_click(220, 640)
+#RFormSpec::Mouse.move_to(200, 40)

data/sample/notepad.rb

@@ -3,7 +3,7 @@ require 'rformspec'
 include RFormSpec::Driver
 
 RFormSpec::Process.run("C:\\WINDOWS\\NOTEPAD.EXE")
-notepad_win = RFormSpec::Window.new('Untitled - Notepad')
+notepad_win = RFormSpec::Window.new('Untitled - Notepad', "", :wait_timeout => 2)
 RFormSpec::Keyboard.type("Hello, Missing No. 5.{ENTER}1 2 3 4 6 7 8 9 10{ENTER}")
 RFormSpec::Keyboard.press("+{UP 2}")
 

data/sample/notepad1.rb

@@ -3,12 +3,12 @@ require 'rformspec'
 include RFormSpec::Driver
 
 RFormSpec::Process.run("C:\\WINDOWS\\NOTEPAD.EXE")
-notepad_win = RFormSpec::Window.new('Untitled - Notepad')
+notepad_win = RFormSpec::Window.new('Untitled - Notepad', "", :wait_timeout => 2)
 RFormSpec::Keyboard.type("Hello from Notepad, {ENTER}1 2 3 4 5 6 7 8 9 10{ENTER}")
 sleep(0.5)
 RFormSpec::Keyboard.press("+{UP 2}")
 sleep(0.5)
 notepad_win.close
 
-notepad_confirm_dialog = RFormSpec::Window.new('Notepad', 'No')
+notepad_confirm_dialog = RFormSpec::Window.new('Notepad', 'No', :wait_timeout => 1)
 notepad_confirm_dialog.click_button('&No')

data/sample/test_calc.rb

@@ -1,14 +1,23 @@
 require 'rformspec'
 
 class CalcTest < RFormSpec::FormTestCase
+  include RFormSpec::Driver
 
   def setup
+    RFormSpec::AutoIt.init
+
+    if window_exists?("Calculator")
+      focus_window('Calculator')
+      RFormSpec::Window.new('Calculator')
+    else
     RFormSpec::Process.run("calc.exe")
-    @calc_win = RFormSpec::Window.new('Calculator')
+    end
+
+    @calc_win = RFormSpec::Window.new('Calculator', "", :wait_timeout => 2)
   end
 
   def teardown
-    @calc_win.close
+    # @calc_win.close
   end
 
   def test_multiple
@@ -16,6 +25,7 @@ class CalcTest < RFormSpec::FormTestCase
     @calc_win.click_button('91')   #*
     @calc_win.click_button('131')  #7
     @calc_win.click_button('112')  #=
+    sleep 1
     assert_equal "21. ", @calc_win.get_control_text('403')
 
   end

metadata

@@ -1,13 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: rformspec
 version: !ruby/object:Gem::Version 
-  hash: 23
-  prerelease: false
+  hash: 3
+  prerelease: 
   segments: 
   - 0
-  - 3
-  - 2
-  version: 0.3.2
+  - 4
+  version: "0.4"
 platform: x86-mingw32
 authors: 
 - Zhimin Zhan
@@ -15,8 +14,7 @@ autorequire: rformspec
 bindir: bin
 cert_chain: []
 
-date: 2011-01-04 00:00:00 +00:00
-default_executable: 
+date: 2011-10-07 00:00:00 Z
 dependencies: []
 
 description: 
@@ -43,14 +41,15 @@ files:
 - lib/rformspec/saveas_file_dialog.rb
 - lib/rformspec/window.rb
 - lib/rformspec.rb
-- sample/calc.rb
-- sample/calc_spec.rb
+- sample/form_calculator/calculator.tpr
+- sample/form_calculator/calculator.tws
+- sample/form_calculator/calc_helper.rb
+- sample/form_calculator/calc_spec.rb
+- sample/mouse.rb
 - sample/notepad.rb
 - sample/notepad1.rb
-- sample/rspec_calc.rb
 - sample/test_calc.rb
 - docs/index.html
-has_rdoc: true
 homepage: http://github.com/zhimin/rformspec
 licenses: []
 
@@ -80,7 +79,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: 
 - none
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.7.2
 signing_key: 
 specification_version: 3
 summary: An wrap of AUTOIT3 for functional testing of Windows form applications

data/sample/calc.rb

@@ -1,25 +0,0 @@
-require 'rformspec'
-
-module Calc
-  include RFormSpec::Driver
-
-  def start_calc
-    RFormSpec::Process.run("calc.exe")
-    RFormSpec::Window.new('Calculator')
-  end
-
-  def find_existing_calc_win
-    if window_exists?("Calculator")
-      focus_window('Calculator')
-      RFormSpec::Window.new('Calculator')
-    else
-      nil
-    end
-  end
-
-  def quit_calc
-    focus_window('Calculator')
-    RFormSpec::Keyboard.press("!{F4}")
-  end
-
-end

data/sample/calc_spec.rb

@@ -1,16 +0,0 @@
-require File.dirname(__FILE__) + '/rspec_calc'
-
-context "Calculator" do
-
-  setup do
-  end
-
-  specify "Multiple works" do
-    @calc_win.click_button('127')  #3
-    @calc_win.click_button('91')   #*
-    @calc_win.click_button('131')  #7
-    @calc_win.click_button('112')  #=
-    @calc_win.get_control_text('403').should == '21. '
-  end
-
-end

data/sample/rspec_calc.rb

@@ -1,24 +0,0 @@
-require File.dirname(__FILE__) + '/calc'
-
-class RSpecCalc
-  include Calc
-
-  def setup
-    init # initialize
-    @calc_win = find_existing_calc_win
-    if @calc_win.nil?
-      @calc_win = start_calc
-    end
-  end
-end
-
-module Spec
-  module Runner
-    class Context
-      def before_context_eval
-        #inherit RSpecCalc # inherit not supported after 0.8
-        inherit_context_eval_module_from RSpecCalc
-      end
-    end
-  end
-end