win32-autogui 0.3.0 → 0.4.0

data/.gemfiles

@@ -0,0 +1,78 @@
+.gemfiles
+.gitattributes
+.gitignore
+.yardopts
+Gemfile
+Gemfile.lock
+HISTORY.markdown
+LICENSE
+README.markdown
+Rakefile
+TODO.markdown
+VERSION
+config/cucumber.yml
+examples/quicknote/.gitignore
+examples/quicknote/FormAboutU.dfm
+examples/quicknote/FormAboutU.pas
+examples/quicknote/FormMainU.dfm
+examples/quicknote/FormMainU.pas
+examples/quicknote/FormSplashU.dfm
+examples/quicknote/FormSplashU.pas
+examples/quicknote/LICENSE
+examples/quicknote/README.markdown
+examples/quicknote/Rakefile
+examples/quicknote/TODO.markdown
+examples/quicknote/dcu/.gitignore
+examples/quicknote/exe/.gitignore
+examples/quicknote/exe/quicknote.exe
+examples/quicknote/lib/quicknote.rb
+examples/quicknote/quicknote.cfg
+examples/quicknote/quicknote.dof
+examples/quicknote/quicknote.dpr
+examples/quicknote/quicknote.res
+examples/quicknote/spec/quicknote/form_about_spec.rb
+examples/quicknote/spec/quicknote/form_main_spec.rb
+examples/quicknote/spec/quicknote/form_splash_spec.rb
+examples/quicknote/spec/spec.opts
+examples/quicknote/spec/spec_helper.rb
+examples/quicknote/spec/watchr.rb
+examples/skeleton/.gitignore
+examples/skeleton/HISTORY.markdown
+examples/skeleton/LICENSE
+examples/skeleton/README.markdown
+examples/skeleton/Rakefile
+examples/skeleton/TODO.markdown
+examples/skeleton/config/cucumber.yml
+examples/skeleton/dcu/.gitignore
+examples/skeleton/exe/.gitignore
+examples/skeleton/features/basic.feature
+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/myapp/form_about_spec.rb
+examples/skeleton/spec/myapp/form_main_spec.rb
+examples/skeleton/spec/spec.opts
+examples/skeleton/spec/spec_helper.rb
+examples/skeleton/spec/watchr.rb
+features/automating_an_application.feature
+features/step_definitions/.gitignore
+features/step_definitions/calculator_steps.rb
+features/support/env.rb
+lib/win32/autogui.rb
+lib/win32/autogui/application.rb
+lib/win32/autogui/input.rb
+lib/win32/autogui/logging.rb
+lib/win32/autogui/window.rb
+lib/win32/autogui/windows/window.rb
+spec/applications/calculator.rb
+spec/auto_gui/application_spec.rb
+spec/auto_gui/logging_spec.rb
+spec/auto_gui/window_spec.rb
+spec/basic_gem/aruba_helper_spec.rb
+spec/basic_gem/basic_gem_spec.rb
+spec/basic_gem/gemspec_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+spec/watchr.rb
+win32-autogui.gemspec

data/.yardopts

@@ -1,5 +1,4 @@
 --verbose
---list-undoc
 -
 LICENSE
 HISTORY.markdown

data/Gemfile.lock

@@ -1,22 +1,19 @@
 PATH
   remote: .
   specs:
-    win32-autogui (0.3.0)
+    win32-autogui (0.4.0)
       log4r (>= 1.1.9)
       win32-clipboard (>= 0.5.2)
-      win32-process (>= 0.6.2)
+      win32-process (>= 0.6.4)
       windows-api (>= 0.4.0)
-      windows-pr (>= 1.0.9)
+      windows-pr (>= 1.1.2)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    aruba (0.2.3)
-      background_process
-      cucumber (~> 0.9.0)
-    background_process (1.2)
+    aruba (0.2.2)
     builder (2.1.2)
-    cucumber (0.9.3)
+    cucumber (0.9.4)
       builder (~> 2.1.2)
       diff-lcs (~> 1.1.2)
       gherkin (~> 2.2.9)
@@ -27,37 +24,37 @@ GEM
       json (~> 1.4.6)
       term-ansicolor (~> 1.0.5)
     json (1.4.6)
+    kramdown (0.12.0)
     log4r (1.1.9)
     rake (0.8.7)
-    rdiscount (1.6.5)
     rspec (1.3.1)
     term-ansicolor (1.0.5)
     win32-api (1.4.6)
     win32-clipboard (0.5.2)
       windows-pr (>= 1.0.3)
-    win32-process (0.6.2)
-      windows-pr (>= 1.0.5)
+    win32-process (0.6.4)
+      windows-pr (>= 1.1.0)
     windows-api (0.4.0)
       win32-api (>= 1.4.5)
-    windows-pr (1.0.9)
+    windows-pr (1.1.2)
       win32-api (>= 1.4.5)
       windows-api (>= 0.3.0)
-    yard (0.6.1)
+    yard (0.6.2)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  aruba (>= 0.2.3)
-  bundler (>= 1.0.3)
-  cucumber (>= 0.9.2)
+  aruba (= 0.2.2)
+  bundler (>= 1.0.7)
+  cucumber (>= 0.9.4)
+  kramdown (>= 0.12.0)
   log4r (>= 1.1.9)
   rake (>= 0.8.7)
-  rdiscount (>= 1.6.5)
   rspec (= 1.3.1)
   win32-autogui!
   win32-clipboard (>= 0.5.2)
-  win32-process (>= 0.6.2)
+  win32-process (>= 0.6.4)
   windows-api (>= 0.4.0)
-  windows-pr (>= 1.0.9)
-  yard (>= 0.6.1)
+  windows-pr (>= 1.1.2)
+  yard (>= 0.6.2)

data/HISTORY.markdown

@@ -6,6 +6,13 @@ Most recent changes are at the top
 Changes
 -------
 
+### 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
+
 ### 0.3.0 - 11/08/2010 ###
 
 * Added Log4R logging
@@ -14,7 +21,8 @@ Changes
 ### 0.2.1 - 11/05/2010 ###
 
 * Added missing "require 'timeout'", fixes issue #1
-* Replaced missing '@calculator' tag required to close down the calculator after running cucumber features
+* Replaced missing '@calculator' tag required to close down the calculator
+  after running cucumber features
 
 ### 0.2.0 - 11/04/2010 ###
 

data/README.markdown

@@ -13,14 +13,29 @@ and [Cucumber](http://github.com/aslakhellesoy/cucumber).  Examples of
 using both these tools are provided with this gem.
 
 
-Quick Start
------------
-See [examples/skeleton/README.markdown](examples/skeleton/README.markdown) for 
-a template of the file structure needed for jump-starting GUI testing with 
-the Win32-autogui RubyGem.
+Quick Start Options
+-------------------
+See [examples/skeleton/README.markdown](examples/skeleton/README.markdown)
+for a template of the file structure needed for jump-starting GUI testing
+with the Win32-autogui RubyGem.
 
 Read our introduction blog posting here: <http://www.gearheadforhire.com/articles/ruby/win32-autogui/using-ruby-to-drive-windows-applications>
 
+Run Win32-autogui's internal specs and example programs.
+
+    gem install win32-autogui
+    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
+    bundle install
+
+    # run the calculator specs and features
+    rake
+
+    # run the example quicknote specs
+    cd examples\quicknote
+    rake
 
 
 Example Usage: Driving Calc.exe
@@ -184,7 +199,12 @@ focus with set_focus."
 System Requirements
 -------------------
 
-Windows OS, version 2000 or higher, testing was done via Cygwin <http://www.cygwin.com/>
+Windows OS, version 2000 or higher 
+
+Testing was done on the following Ruby platforms:
+
+* ruby 1.8.7 (2008-08-11 patchlevel 72) [i386-cygwin]
+* ruby 1.8.7 (2010-08-16 patchlevel 302) [i386-mingw32]
 
 
 Dependencies
@@ -224,6 +244,7 @@ Win32-autogui development was jump-started by cloning [BasicGem](http://github.c
 * Cucumber for functional testing <http://github.com/aslakhellesoy/cucumber>
 * Aruba for CLI testing <http://github.com/aslakhellesoy/aruba>
 * YARD for documentation generation <http://github.com/lsegal/yard>
+* Kramdown for documentation markup processing <https://github.com/gettalong/kramdown>
 
 ### Rake tasks ###
 

data/Rakefile

@@ -6,6 +6,16 @@
 require 'rubygems'
 require 'bundler/setup' 
 
+# TODO: remove this once issue corrected
+# Bundler broken up to 1.0.7 on Windows
+module Bundler
+  class GemHelper
+    def self.install_tasks(opts = nil)
+      dir = caller.find{|c| /Rakefile:/}[/^(.*?)\/Rakefile:/, 1]
+      self.new(dir, opts && opts[:name]).install
+    end
+  end
+end
 Bundler::GemHelper.install_tasks
 
 def gemspec
@@ -41,8 +51,7 @@ namespace :doc do
   require 'yard/rake/yardoc_task'
 
   YARD::Rake::YardocTask.new(:generate) do |yt|
-    yt.options = ['--markup-provider', 'rdiscount', 
-                  '--output-dir', doc_destination
+    yt.options = ['--output-dir', doc_destination
                  ] +
                  gemspec.rdoc_options - ['--line-numbers', '--inline-source']
   end
@@ -51,5 +60,10 @@ 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')
+  end
 
 end

data/TODO.markdown

@@ -7,4 +7,6 @@ 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) "rake release" broken on Windows, create patch to fix Bundler.  For now, 'git tag v0.3.0 && rake build && gem push 
+* (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.3.0
+0.4.0

data/examples/quicknote/lib/quicknote.rb

@@ -24,28 +24,28 @@ def status_bar
     main_window.children.find {|w| w.window_class == 'TStatusBar'}
   end
 
-  def dialog_about
-    Autogui::EnumerateDesktopWindows.new.find do |w| 
-      w.title.match(/About QuickNote/) && (w.pid == pid)
+  def dialog_about(options={})
+    Autogui::EnumerateDesktopWindows.new(options).find do |w| 
+      w.title.match(/^About QuickNote/) && (w.pid == pid)
     end
   end
 
-  def splash
-    Autogui::EnumerateDesktopWindows.new.find do |w| 
-      w.title.match(/FormSplash/) && (w.pid == pid)
+  def splash(options={})
+    Autogui::EnumerateDesktopWindows.new(options).find do |w| 
+      w.title.match(/^FormSplash/) && (w.pid == pid)
     end
   end
 
-  def message_dialog_confirm
-    Autogui::EnumerateDesktopWindows.new.find do |w| 
-      w.title.match(/Confirm/) && (w.pid == pid)
+  def message_dialog_confirm(options={})
+    Autogui::EnumerateDesktopWindows.new(options).find do |w| 
+      w.title.match(/^Confirm/) && (w.pid == pid)
     end
   end
 
   # Title and class are the same as dialog_overwrite_confirm
   # Use child windows to differentiate
-  def dialog_overwrite_confirm
-    Autogui::EnumerateDesktopWindows.new.find do |w| 
+  def dialog_overwrite_confirm(options={})
+    Autogui::EnumerateDesktopWindows.new(options).find do |w| 
       w.title.match(/^Text File Save$/) && 
         (w.pid == pid) && 
         (w.window_class == "#32770") &&
@@ -54,23 +54,23 @@ def dialog_overwrite_confirm
   end
 
   # Title and class are the same as dialog_overwrite_confirm
-  def file_save_as_dialog
-    Autogui::EnumerateDesktopWindows.new.find do |w| 
-      w.title.match(/Text File Save/) && 
+  def file_save_as_dialog(options={})
+    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:/))
     end
   end
 
-  def file_open_dialog
-    Autogui::EnumerateDesktopWindows.new.find do |w| 
-      w.title.match(/Text File Open/) && (w.pid == pid)
+  def file_open_dialog(options={})
+    Autogui::EnumerateDesktopWindows.new(options).find do |w| 
+      w.title.match(/^Text File Open/) && (w.pid == pid)
     end
   end
 
-  def error_dialog
-    Autogui::EnumerateDesktopWindows.new.find do |w| 
+  def error_dialog(options={})
+    Autogui::EnumerateDesktopWindows.new(options).find do |w| 
       w.title.match(/^QuickNote$/) && (w.pid == pid) && (w.window_class == "#32770")
     end
   end

data/examples/quicknote/spec/quicknote/form_main_spec.rb

@@ -159,7 +159,7 @@
 
     it "should do nothing unless modified text" do
       append_to_file(@filename, "sneak in extra content that shouldn't be here")
-      contents = get_file_content(@filename)
+      contents = get_file_contents(@filename)
       contents.should match(/extra content/)
       @application.file_save
       contents.should match(/extra content/)
@@ -177,7 +177,7 @@
         type_in("foobar")
         @application.edit_window.text.should == "foobar" + "original content"
         @application.file_save
-        get_file_content(@filename).should == "foobar" + "original content"
+        get_file_contents(@filename).should == "foobar" + "original content"
       end
     end
 
@@ -249,9 +249,9 @@
       @application.main_window.title.downcase.should == "QuickNote - #{fullpath(@saveas_filename)}".downcase
     end
     it "should save the text" do
-      get_file_content(@saveas_filename).should == ''
+      get_file_contents(@saveas_filename).should == ''
       @application.file_save_as(fullpath(@saveas_filename), :overwrite => true)
-      get_file_content(@saveas_filename).should match(/original content/)
+      get_file_contents(@saveas_filename).should match(/original content/)
     end
   end
 

data/examples/quicknote/spec/spec_helper.rb

@@ -15,15 +15,22 @@
 require 'spec/autorun'
 require 'aruba/api'
 
-# aruba helper, returns full path to files in the aruba tmp folder
+# aruba helpers
+#
+# @return full path to files in the aruba tmp folder
 def fullpath(filename)
   path = File.expand_path(File.join(current_dir, filename))
-  path = `cygpath -w #{path}`.chomp if path.match(/^\/cygdrive/)  # cygwin?
+  if path.match(/^\/cygdrive/)
+    # match /cygdrive/c/path/to and return c:\\path\\to
+    path = `cygpath -w #{path}`.chomp
+  elsif path.match(/.\:/)
+    # match c:/path/to and return c:\\path\\to
+    path = path.gsub(/\//, '\\')
+  end
   path
 end
-
-# return the contents of "filename" in the aruba tmp folder
-def get_file_content(filename)
+# @return the contents of "filename" in the aruba tmp folder
+def get_file_contents(filename)
   in_current_dir do
     IO.read(filename)
   end

data/examples/skeleton/HISTORY.markdown

@@ -0,0 +1,11 @@
+History
+=======
+Most recent changes are at the top
+
+
+Changes
+-------
+
+### 0.1.0 - 11/04/2010 ###
+
+* Initial release

data/examples/skeleton/features/step_definitions/application_steps.rb

@@ -1,23 +1,37 @@
 require 'myapp'
 
 include Autogui::Input
+include Autogui::Logging
 
 After('@application') do
-  if @application
-    @application.close(:wait_for_close => true) if @application.running?
+  if @application && @application.running?
+    @application.dialog_tips.close if @application.dialog_tips
+    @application.dialog_wizard.close if @application.dialog_wizard
+    begin
+      @application.close(:wait_for_close => true) if @application.running?
+    rescue
+      @application.kill
+      raise
+    end
+  end
+end
+
+Given /^the application is running$/ do 
+  unless @application && @application.running?
+    @application = Myapp.new
     @application.should be_running
   end
 end
 
-Before('@applicaton') do
-  @application = Myapp.new
-  @application.should_not be_running
+When /^I start the application with parameters "([^"]*)"$/ do |parameters|
+  @application = Myapp.new  :parameters => parameters
+  @application.should be_running
+end
 
-  # debug
-  puts "application:"
-  puts @application.inspect
-  puts "application.combined_text"
-  puts @application.combined_text
+When /^I start the application$/ do
+  data_folder = cygpath_to_windows_path(File.expand_path(current_dir))
+  @application = Myapp.new  :parameters => "--nosplash  --data_folder:#{data_folder}"
+  @application.should be_running
 end
 
 When /^I type in "([^"]*)"$/ do |string|