win32-autogui 0.4.0 → 0.4.1

data/.gemfiles

@@ -30,6 +30,7 @@ examples/quicknote/quicknote.cfg
 examples/quicknote/quicknote.dof
 examples/quicknote/quicknote.dpr
 examples/quicknote/quicknote.res
+examples/quicknote/spec/aruba_helper.rb
 examples/quicknote/spec/quicknote/form_about_spec.rb
 examples/quicknote/spec/quicknote/form_main_spec.rb
 examples/quicknote/spec/quicknote/form_splash_spec.rb
@@ -50,6 +51,7 @@ examples/skeleton/features/step_definitions/.gitignore
 examples/skeleton/features/step_definitions/application_steps.rb
 examples/skeleton/features/support/env.rb
 examples/skeleton/lib/myapp.rb
+examples/skeleton/spec/aruba_helper.rb
 examples/skeleton/spec/myapp/form_about_spec.rb
 examples/skeleton/spec/myapp/form_main_spec.rb
 examples/skeleton/spec/spec.opts
@@ -66,6 +68,7 @@ lib/win32/autogui/logging.rb
 lib/win32/autogui/window.rb
 lib/win32/autogui/windows/window.rb
 spec/applications/calculator.rb
+spec/aruba_helper.rb
 spec/auto_gui/application_spec.rb
 spec/auto_gui/logging_spec.rb
 spec/auto_gui/window_spec.rb

data/Gemfile

@@ -1,4 +1,4 @@
-source "http://rubygems.org"
+source :rubygems
 
 # Specify your gem's dependencies in the .gemspec file
 gemspec

data/Gemfile.lock

@@ -1,12 +1,12 @@
 PATH
   remote: .
   specs:
-    win32-autogui (0.4.0)
+    win32-autogui (0.4.1)
       log4r (>= 1.1.9)
-      win32-clipboard (>= 0.5.2)
-      win32-process (>= 0.6.4)
-      windows-api (>= 0.4.0)
-      windows-pr (>= 1.1.2)
+      win32-clipboard (= 0.5.2)
+      win32-process (= 0.6.4)
+      windows-api (= 0.4.0)
+      windows-pr (= 1.1.2)
 
 GEM
   remote: http://rubygems.org/
@@ -49,12 +49,7 @@ DEPENDENCIES
   bundler (>= 1.0.7)
   cucumber (>= 0.9.4)
   kramdown (>= 0.12.0)
-  log4r (>= 1.1.9)
   rake (>= 0.8.7)
   rspec (= 1.3.1)
   win32-autogui!
-  win32-clipboard (>= 0.5.2)
-  win32-process (>= 0.6.4)
-  windows-api (>= 0.4.0)
-  windows-pr (>= 1.1.2)
   yard (>= 0.6.2)

data/HISTORY.markdown

@@ -6,12 +6,20 @@ Most recent changes are at the top
 Changes
 -------
 
+### 0.4.1 - 02/03/2011 ###
+
+* Window.wait_for_close yields if a block is given allowing callbacks during
+  long running waits in order to check for error message dialogs, etc.
+* Lock down win32 gem dependencies to known working versions
+* Add input support for shift numeric row
+* Add input support for VK_OEM_1 through VK_OEM_7
+
 ### 0.4.0 - 11/22/2010 ###
 
 * Internal specs, features and all examples should run out-of-the-box on both Cygwin and MingW installs
 * EnumerateDesktopWindows now accepts an optional timeout allowing the "find"
   method to continue enumerating windows until the timeout is reached
-* Added static logging constants to Autogui::Loggting
+* Added static logging constants to Autogui::Logging
 
 ### 0.3.0 - 11/08/2010 ###
 

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2010 GearheadForHire, LLC
+Copyright (c) 2010-2011 GearheadForHire, LLC
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.markdown

@@ -6,10 +6,10 @@ A Win32 GUI testing framework packaged as a [RubyGem](http://rubygems.org/).
 
 Overview
 --------
-Win32-autogui provides a framework to enable GUI application testing 
-with Ruby.  This facilitates integration testing of Windows binaries using 
-Ruby based tools like [RSpec](http://github.com/dchelimsky/rspec) 
-and [Cucumber](http://github.com/aslakhellesoy/cucumber).  Examples of 
+Win32-autogui provides a framework to enable GUI application testing
+with Ruby.  This facilitates integration testing of Windows binaries using
+Ruby based tools like [RSpec](http://github.com/dchelimsky/rspec)
+and [Cucumber](http://github.com/aslakhellesoy/cucumber).  Examples of
 using both these tools are provided with this gem.
 
 
@@ -24,7 +24,7 @@ Read our introduction blog posting here: <http://www.gearheadforhire.com/article
 Run Win32-autogui's internal specs and example programs.
 
     gem install win32-autogui
-    gem install rake bundler win32console cucumber 
+    gem install rake bundler win32console cucumber
     gem install rspec -v 1.3.1
 
     cd C:\Ruby187\lib\ruby\gems\1.8\gems\win32-autogui-0.4.0
@@ -41,59 +41,63 @@ Run Win32-autogui's internal specs and example programs.
 Example Usage: Driving Calc.exe
 -------------------------------
 
-Using [RSpec](http://github.com/dchelimsky/rspec) to test drive the stock 
-Window's calculator application.  This example is used as Win32-autogui's 
-internal spec. See [spec/auto_gui/application_spec.rb](spec/auto_gui/application_spec.rb).  
+Using [RSpec](http://github.com/dchelimsky/rspec) to test drive the stock
+Window's calculator application.  This example is used as Win32-autogui's
+internal spec. See [spec/auto_gui/application_spec.rb](spec/auto_gui/application_spec.rb).
 
-A more complete example of testing a Window's Delphi program is presented with 
+A more complete example of testing a Window's Delphi program is presented with
 source and binaries in [examples/quicknote/](examples/quicknote/).
 
 ### Wrap the application to be tested ###
 The first step is to subclass Win32-autogui's application class.
 
-    require 'win32/autogui'
+    require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
 
     class Calculator < Autogui::Application
 
       # initialize with the binary name 'calc' and the window title
-      # 'Calculator' used along with the application pid to find the 
+      # 'Calculator' used along with the application pid to find the
       # main application window
       def initialize(options = {})
         defaults = {
                      :name => "calc",
                      :title => "Calculator",
-                     :logger_filename => "calculator.log"
+                     :logger_level => Autogui::Logging::DEBUG
                    }
         super defaults.merge(options)
       end
 
-      # the calculator's results window 
+      # the calculator's results window
       def edit_window
         main_window.children.find {|w| w.window_class == 'Edit'}
       end
 
       # About dialog, hotkey (VK_MENU, VK_H, VK_A)
-      def dialog_about
-        Autogui::EnumerateDesktopWindows.new.find do |w| 
+      def dialog_about(options = {})
+        Autogui::EnumerateDesktopWindows.new(options).find do |w|
           w.title.match(/About Calculator/) && (w.pid == pid)
         end
       end
 
       # the 'CE' button
       def clear_entry
+        set_focus
         keystroke(VK_DELETE)
       end
 
     end
 
+
 ### Write specs ###
-The following RSpec code describes driving the Windows calculator for testing. 
+The following RSpec code describes driving the Windows calculator for testing.
 Multiple instances running simultaneously are supported.  See "should control
 focus with set_focus."
 
+
     require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
 
     include Autogui::Input
+    include Autogui::Logging
 
     describe Autogui::Application do
 
@@ -101,6 +105,7 @@ focus with set_focus."
 
         before(:all) do
           @calculator = Calculator.new
+          @calculator.set_focus
         end
 
         after(:all) do
@@ -112,6 +117,13 @@ focus with set_focus."
           @calculator.should be_running
         end
 
+        it "should die when sending the kill signal" do
+          killme = Calculator.new
+          killme.should be_running
+          killme.kill
+          killme.should_not be_running
+        end
+
         it "should have the title 'Calculator' that matches the main_window title" do
           @calculator.main_window.title.should == 'Calculator'
           @calculator.main_window.title.should == @calculator.title
@@ -121,27 +133,30 @@ focus with set_focus."
           @calculator.inspect.should match(/children=</)
         end
 
-        it "should calculate '2+2=4' using the keystroke method" do
-          @calculator.set_focus
-          keystroke(VK_2, VK_ADD, VK_2, VK_RETURN) 
-          @calculator.edit_window.text.strip.should == "4."
-        end
-
-        it "should calculate '2+12=14' using the type_in method" do
-          @calculator.set_focus
-          type_in("2+12=")
-          @calculator.edit_window.text.strip.should == "14."
+        it "should raise an error if setting focus and the application title is incorrect" do
+          goodcalc = Calculator.new :title => "Calculator"
+          lambda { goodcalc.set_focus }.should_not raise_error
+          goodcalc.close
+
+          badcalc = Calculator.new :title => "BaDTitle"
+          lambda {
+            begin
+              badcalc.setfocus
+            ensure
+              badcalc.kill
+            end
+          }.should raise_error
         end
 
         it "should control the focus with 'set_focus'" do
           @calculator.set_focus
           keystroke(VK_9)
           @calculator.edit_window.text.strip.should == "9."
-          
+
           calculator2 = Calculator.new
           calculator2.pid.should_not == @calculator.pid
           calculator2.set_focus
-          keystroke(VK_1, VK_0) 
+          keystroke(VK_1, VK_0)
           calculator2.edit_window.text.strip.should == "10."
 
           @calculator.set_focus
@@ -154,7 +169,7 @@ focus with set_focus."
           @calculator.set_focus
           dialog_about = @calculator.dialog_about
           dialog_about.should be_nil
-          keystroke(VK_MENU, VK_H, VK_A) 
+          keystroke(VK_MENU, VK_H, VK_A)
           dialog_about = @calculator.dialog_about
           dialog_about.title.should == "About Calculator"
           dialog_about.combined_text.should match(/Microsoft . Calculator/)
@@ -162,20 +177,38 @@ focus with set_focus."
           @calculator.dialog_about.should be_nil
         end
 
+        describe "calculations" do
+          before(:each) do
+            @calculator.clear_entry
+          end
+
+          it "should calculate '2+2=4' using the keystroke method" do
+            @calculator.set_focus
+            keystroke(VK_2, VK_ADD, VK_2, VK_RETURN)
+            @calculator.edit_window.text.strip.should == "4."
+          end
+
+          it "should calculate '2+12=14' using the type_in method" do
+            @calculator.set_focus
+            type_in("2+12=")
+            @calculator.edit_window.text.strip.should == "14."
+          end
+        end
+
         describe "clipboard" do
           before(:each) do
             @calculator.clear_entry
             @calculator.clipboard.text = ""
             @calculator.clipboard.text.should == ""
           end
-          
+
           describe "copy (VK_CONTROL, VK_C)" do
             it "should copy the edit window" do
               @calculator.set_focus
               type_in("3002")
-              @calculator.edit_window.text.strip.should == "3,002."
+              @calculator.edit_window.text.strip.should match(/3,?002\./)
               @calculator.edit_window.set_focus
-              keystroke(VK_CONTROL, VK_C) 
+              keystroke(VK_CONTROL, VK_C)
               @calculator.clipboard.text.should == "3002"
             end
           end
@@ -185,8 +218,8 @@ focus with set_focus."
               @calculator.edit_window.set_focus
               @calculator.clipboard.text = "12345"
               @calculator.edit_window.text.strip.should == "0."
-              keystroke(VK_CONTROL, VK_V) 
-              @calculator.edit_window.text.strip.should == "12,345."
+              keystroke(VK_CONTROL, VK_V)
+              @calculator.edit_window.text.strip.should match(/12,?345\./)
             end
           end
 
@@ -199,7 +232,7 @@ focus with set_focus."
 System Requirements
 -------------------
 
-Windows OS, version 2000 or higher 
+Windows OS, version 2000 or higher
 
 Testing was done on the following Ruby platforms:
 
@@ -262,27 +295,30 @@ rake -T
 
 ### Autotesting with Watchr ###
 
-[Watchr](http://github.com/mynyml/watchr) provides a flexible alternative to Autotest.  A
-jump start script is provided in spec/watchr.rb.
+[Watchr](http://github.com/mynyml/watchr) provides a flexible alternative to Autotest.
 
-#### Install watchr ###
+**NOTE:** _The following assumes a global setting of 'git config core.autocrlf
+input' and that you want to modify the Delphi 7 source to Quicknote which
+requires CRLF line endings._
 
-    gem install watchr
+Grab the source
 
-#### Run watchr ###
+    cd ~/workspace
+    git clone http://github.com/robertwahler/win32-autogui -n
+    cd win32-autogui
+    git config core.autocrlf true
+    git checkout
 
-    watchr spec/watchr.rb
+#### Install Watchr ####
 
-outputs a menu
+    gem install watchr
 
-    Ctrl-\ for menu, Ctrl-C to quit
+#### Run Watchr on Quicknote ####
 
-Watchr will now watch the files defined in 'spec/watchr.rb' and run RSpec or Cucumber, as appropriate.
-The watchr script provides a simple menu.
-
-Ctrl-\
+    cd examples/quicknote
+    watchr spec/watchr.rb
 
-    MENU: a = all , f = features  s = specs, l = last feature (none), q = quit
+Watchr will now watch the files defined in 'spec/watchr.rb' and run RSpec or Cucumber, as appropriate.
 
 
 Copyright

data/Rakefile

@@ -1,10 +1,10 @@
 # encoding: utf-8
 
-# bundler/setup is managing $LOAD_PATH, any gem needed by this Rakefile must 
+# bundler/setup is managing $LOAD_PATH, any gem needed by this Rakefile must
 # be listed as a development dependency in the gemspec
 
 require 'rubygems'
-require 'bundler/setup' 
+require 'bundler/setup'
 
 # TODO: remove this once issue corrected
 # Bundler broken up to 1.0.7 on Windows
@@ -60,7 +60,7 @@ namespace :doc do
   task :clean do
     rm_r doc_destination if File.exists?(doc_destination)
   end
-  
+
   desc "List undocumented objects"
   task :undocumented do
     system('yard stats --list-undoc')

data/TODO.markdown

@@ -6,7 +6,7 @@ general
 
 * (1.0) stop changing $LOAD_PATH in specs and features, modify ENV[] in before and afters
 * (1.0) implement Application.find and add option to not start application automatically, allows driving already running applications
-* (1.0) application class should be a mixin, not classical inheritance 
+* (1.0) application class should be a mixin, not classical inheritance
 * (1.0) "rake release" broken on Windows, create patch to fix Bundler.  For now, 'git tag v0.3.0 && rake build && gem push pkg/win32-autogui-0.3.0.gem'
 * (1.0) add an exception dialog watcher that accepts a block and scans for exception dialogs in a separate thread
 * unicode support for window text

data/VERSION

@@ -1 +1 @@
-0.4.0
+0.4.1

data/examples/quicknote/FormMainU.pas

@@ -126,7 +126,7 @@ begin
       // form after a short wait
       SplashForm.Timer.Enabled := True;
     end;
-  end;  
+  end;
 
   Reset;
 end;

data/examples/quicknote/README.markdown

@@ -1,7 +1,7 @@
 QuickNote README
 ================
 
-QuickNote is a stripped down Notepad clone written in Delphi.  It is an example GUI executable with 
+QuickNote is a stripped down Notepad clone written in Delphi.  It is an example GUI executable with
 source code for the Win32-autogui gem.  It is not fit for any other purpose.
 
 

data/examples/quicknote/lib/quicknote.rb

@@ -2,15 +2,14 @@
 # Production code should simply require 'win32/autogui'
 require File.expand_path(File.dirname(__FILE__) + '/../../../lib/win32/autogui')
 
-
 class Quicknote < Autogui::Application
 
   def initialize(options = {})
     # relative path to app using Windows style path
-    @name ="exe\\quicknote.exe"  
+    @name ="exe\\quicknote.exe"
     defaults = {
-                 :title=> "QuickNote -", 
-                 :parameters => '--nosplash', 
+                 :title=> "QuickNote -",
+                 :parameters => '--nosplash',
                  :main_window_timeout => 20
                }
     super defaults.merge(options)
@@ -25,19 +24,19 @@ def status_bar
   end
 
   def dialog_about(options={})
-    Autogui::EnumerateDesktopWindows.new(options).find do |w| 
+    Autogui::EnumerateDesktopWindows.new(options).find do |w|
       w.title.match(/^About QuickNote/) && (w.pid == pid)
     end
   end
 
   def splash(options={})
-    Autogui::EnumerateDesktopWindows.new(options).find do |w| 
+    Autogui::EnumerateDesktopWindows.new(options).find do |w|
       w.title.match(/^FormSplash/) && (w.pid == pid)
     end
   end
 
   def message_dialog_confirm(options={})
-    Autogui::EnumerateDesktopWindows.new(options).find do |w| 
+    Autogui::EnumerateDesktopWindows.new(options).find do |w|
       w.title.match(/^Confirm/) && (w.pid == pid)
     end
   end
@@ -45,9 +44,9 @@ def message_dialog_confirm(options={})
   # Title and class are the same as dialog_overwrite_confirm
   # Use child windows to differentiate
   def dialog_overwrite_confirm(options={})
-    Autogui::EnumerateDesktopWindows.new(options).find do |w| 
-      w.title.match(/^Text File Save$/) && 
-        (w.pid == pid) && 
+    Autogui::EnumerateDesktopWindows.new(options).find do |w|
+      w.title.match(/^Text File Save$/) &&
+        (w.pid == pid) &&
         (w.window_class == "#32770") &&
         (w.combined_text.match(/already exists/))
     end
@@ -55,8 +54,8 @@ def dialog_overwrite_confirm(options={})
 
   # Title and class are the same as dialog_overwrite_confirm
   def file_save_as_dialog(options={})
-    Autogui::EnumerateDesktopWindows.new(options).find do |w| 
-      w.title.match(/^Text File Save/) && 
+    Autogui::EnumerateDesktopWindows.new(options).find do |w|
+      w.title.match(/^Text File Save/) &&
         (w.pid == pid) &&
         (w.window_class == "#32770") &&
         (w.combined_text.match(/Save \&in:/))
@@ -64,13 +63,13 @@ def file_save_as_dialog(options={})
   end
 
   def file_open_dialog(options={})
-    Autogui::EnumerateDesktopWindows.new(options).find do |w| 
+    Autogui::EnumerateDesktopWindows.new(options).find do |w|
       w.title.match(/^Text File Open/) && (w.pid == pid)
     end
   end
 
   def error_dialog(options={})
-    Autogui::EnumerateDesktopWindows.new(options).find do |w| 
+    Autogui::EnumerateDesktopWindows.new(options).find do |w|
       w.title.match(/^QuickNote$/) && (w.pid == pid) && (w.window_class == "#32770")
     end
   end
@@ -78,23 +77,23 @@ def error_dialog(options={})
   # menu action File, New
   def file_new(options={})
     set_focus
-    keystroke(VK_MENU, VK_F, VK_N) 
-    if message_dialog_confirm 
+    keystroke(VK_MENU, VK_F, VK_N)
+    if message_dialog_confirm
       options[:save] == true ? keystroke(VK_Y) : keystroke(VK_N)
     end
     # sanity check
-    raise "confirm dialog is still here" if message_dialog_confirm 
+    raise "confirm dialog is still here" if message_dialog_confirm
   end
-  
+
   # menu action File, New
   def file_open(filename, options={})
     set_focus
-    keystroke(VK_MENU, VK_F, VK_O) 
-    if message_dialog_confirm 
+    keystroke(VK_MENU, VK_F, VK_O)
+    if message_dialog_confirm
       options[:save] == true ? keystroke(VK_Y) : keystroke(VK_N)
     end
 
-    raise "sanity check, confirm dialog is still here" if message_dialog_confirm 
+    raise "sanity check, confirm dialog is still here" if message_dialog_confirm
     raise "sanity check, file_open_dialog not found" unless file_open_dialog
 
     # Paste in filename for speed, much faster than 'type_in(filename)'
@@ -107,22 +106,22 @@ def file_open(filename, options={})
   # menu action File, Exit
   def file_exit
     set_focus
-    keystroke(VK_N) if message_dialog_confirm 
+    keystroke(VK_N) if message_dialog_confirm
     keystroke(VK_ESCAPE) if file_open_dialog
-    keystroke(VK_MENU, VK_F, VK_X) 
-    keystroke(VK_N) if message_dialog_confirm 
+    keystroke(VK_MENU, VK_F, VK_X)
+    keystroke(VK_N) if message_dialog_confirm
   end
-  
+
   # menu action File, Save
   def file_save
     set_focus
-    keystroke(VK_MENU, VK_F, VK_S) 
+    keystroke(VK_MENU, VK_F, VK_S)
   end
- 
+
   # menu action File, Save As
   def file_save_as(filename, options={})
     set_focus
-    keystroke(VK_MENU, VK_F, VK_A) 
+    keystroke(VK_MENU, VK_F, VK_A)
     raise "sanity check, file_save_as_dialog not found" unless file_save_as_dialog
 
     # Paste in filename for speed, much faster than 'type_in(filename)'
@@ -130,10 +129,10 @@ def file_save_as(filename, options={})
     keystroke(VK_CONTROL, VK_V)
     keystroke(VK_RETURN)
 
-    if dialog_overwrite_confirm 
+    if dialog_overwrite_confirm
       options[:overwrite] == true ? keystroke(VK_Y) : keystroke(VK_N)
     end
-    raise "sanity check, overwrite confirm dialog is still here" if dialog_overwrite_confirm 
+    raise "sanity check, overwrite confirm dialog is still here" if dialog_overwrite_confirm
 
   end