rautomation 0.7.0 → 0.7.1

data/History.rdoc

@@ -1,4 +1,12 @@
-== Version 0.7.0 / 2012-xx-xx
+== 0.7.1 / 2012-02-26
+
+=== Win32 adapter
+
+  * add Window#dimensions to get coordinates of the window
+  * add Window#move to move/resize the window
+  * fix Window#child not to raise any exceptions for cases where window isn't technically a child
+
+== Version 0.7.0 / 2012-02-23
 
 === All adapters
 

data/VERSION

@@ -1 +1 @@
-0.7.0
+0.7.1

data/lib/rautomation/adapter/win_32/functions.rb

@@ -12,6 +12,10 @@ module RAutomation
         callback :enum_callback, [:long, :pointer], :bool
 
         # user32
+        attach_function :_get_window_rect, :GetWindowRect,
+                        [:long, :pointer], :bool
+        attach_function :_move_window, :MoveWindow,
+                        [:long, :int, :int, :int, :int, :bool], :bool
         attach_function :enum_windows, :EnumWindows,
                         [:enum_callback, :pointer], :long
         attach_function :enum_child_windows, :EnumChildWindows,
@@ -98,6 +102,16 @@ module RAutomation
 
           alias_method :control_title, :window_title
 
+          def move_window(hwnd, x, y, width, height)
+            _move_window(hwnd, x, y, width, height, true)
+          end
+
+          def window_rect(hwnd)
+            x = FFI::MemoryPointer.new(:long, 4)
+            _get_window_rect(hwnd, x)
+            x.read_array_of_long(4)
+          end
+
           def window_text(hwnd)
             found_text = []
             window_callback = FFI::Function.new(:bool, [:long, :pointer], {:convention => :stdcall}) do |child_hwnd, _|
@@ -170,12 +184,9 @@ module RAutomation
           alias_method :activate_control, :activate_window
 
           def control_hwnd(window_hwnd, locators)
-            hwnd = find_hwnd(locators, window_hwnd) do |hwnd|
+            find_hwnd(locators, window_hwnd) do |hwnd|
               locators_match?(locators, control_properties(hwnd, locators))
             end
-
-            raise UnknownElementException, "Element with #{locators.inspect} does not exist" if hwnd == 0 || hwnd.nil?
-            hwnd
           end
 
           alias_method :child_hwnd, :control_hwnd

data/lib/rautomation/adapter/win_32/window.rb

@@ -11,10 +11,10 @@ module RAutomation
         class << self
           def oleacc_module_handle
             @oleacc_module_handle ||= begin
-                                        oleacc = Functions.load_library "oleacc.dll"
-                                        Functions.co_initialize nil                                        
-                                        oleacc
-                                      end
+              oleacc = Functions.load_library "oleacc.dll"
+              Functions.co_initialize nil
+              oleacc
+            end
           end
         end
 
@@ -119,12 +119,34 @@ module RAutomation
           sleep 1
         end
 
+        # Moves/resizes the window. 
+        # @note All coordinates are optional and if not specified current coordinates will be used
+        # @param [Hash] coords for specifying the coordinates.
+        # @option coords [Fixnum] :left Window coordinate from the left side of screen
+        # @option coords [Fixnum] :top Window coordinate from the top of the screen
+        # @option coords [Fixnum] :width Width of window
+        # @option coords [Fixnum] :height Height of window
+        def move(coords={})
+          @container.wait_until_present
+          rect = dimensions.merge(coords)
+          Functions.move_window(hwnd, rect[:left], rect[:top], rect[:width], rect[:height])
+          sleep 1
+        end
+
+        # @return [Hash] Hash[:left, :top, :width, :height] with window coordinates
+        def dimensions
+          @container.wait_until_present
+          left, top, right, bottom = Functions.window_rect(hwnd)
+          {:left => left, :top => top, :width => right - left, :height => bottom - top}
+        end
+
+
         # Activates the window and sends keys to it.
         #
         # @example
         #   RAutomation::Window.new(:title => //).send_keys "hello!"
         #   RAutomation::Window.new(:title => //).send_keys [:control, "a"], "world!"
-        # Refer to Keys#KEYS for all the special keycodes.
+        # Refer to {Keys::KEYS} for all the special keycodes.
         # @see RAutomation::Window#send_keys
         def send_keys(args)
           Keys.encode(args).each do |arg|

data/spec/adapter/win_32/window_spec.rb

@@ -1,8 +1,9 @@
 require "spec_helper"
 
 describe "Win32::Window", :if => SpecHelper.adapter == :win_32 do
+  let(:window) {RAutomation::Window.new(:title => /MainFormWindow/i)}
+
   it "#child" do
-    window = RAutomation::Window.new(:title => /MainFormWindow/i)
     window.should exist
 
     # buttons are windows too. so let's find the button for now
@@ -11,38 +12,58 @@ describe "Win32::Window", :if => SpecHelper.adapter == :win_32 do
     child.title.should == "&About"
   end
 
-  it "send tab keystrokes to move focus between elements" do
-    window = RAutomation::Window.new(:title => /MainFormWindow/i)
-    window.button(:value => "&About").focus
-    window.button(:value => "&About").should be_focused
+  context "#send_keys" do
+    it "send tab keystrokes to move focus between elements" do
+      window.button(:value => "&About").focus
+      window.button(:value => "&About").should be_focused
 
-    window.send_keys(:tab, :tab, :tab)
-    button = window.button(:value => "Close")
-    button.should exist
-    button.should be_focused
-  end
+      window.send_keys(:tab, :tab, :tab)
+      button = window.button(:value => "Close")
+      button.should exist
+      button.should be_focused
+    end
 
-  it "#send_keys" do
-    window = RAutomation::Window.new(:title => /MainFormWindow/i)
-    text_field = window.text_field(:index => 1)
-    text_field.focus
-    window.send_keys "abc123ABChiHI!"
-    text_field.value.should == "abc123ABChiHI!"
+    it "send arbitrary characters and control keys" do
+      text_field = window.text_field(:index => 1)
+      text_field.focus
+      window.send_keys "abc123ABChiHI!"
+      text_field.value.should == "abc123ABChiHI!"
 
-    window.send_keys :space, "X"
-    text_field.value.should == "abc123ABChiHI! X"
+      window.send_keys :space, "X"
+      text_field.value.should == "abc123ABChiHI! X"
 
-    window.send_keys [:control, "a"], :backspace
-    text_field.value.should be_empty
+      window.send_keys [:control, "a"], :backspace
+      text_field.value.should be_empty
+    end
   end
 
   it "#control" do
-    window = RAutomation::Window.new(:title => /MainFormWindow/i)
     window.control(:value => "&About").should exist
   end
 
-  it "has controls" do
-    window = RAutomation::Window.new(:title => /MainFormWindow/i)
+  it "#controls" do
     window.controls(:class => /button/i).size.should == 12
   end
+
+  context "#move" do
+    it "width=500, height=400, left=10, top=0" do
+      window.move :width => 500, :height => 400, :left => 10, :top => 0
+      coords = window.dimensions
+      coords[:width].should == 500
+      coords[:height].should == 400
+      coords[:left].should == 10
+      coords[:top].should == 0
+    end
+
+    it "uses default dimensions if not specified" do
+      coords = window.dimensions
+      window.move :width => 253, :left => 26
+
+      new_coords = window.dimensions
+      new_coords[:width].should == 253
+      new_coords[:left].should == 26
+      new_coords[:top].should == coords[:top]
+      new_coords[:height].should == coords[:height]
+    end
+  end
 end

data/spec/spec_helper.rb

@@ -2,9 +2,6 @@ $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
 require 'rautomation'
 require 'rspec'
 
-#require 'simplecov'
-#SimpleCov.start
-
 module SpecHelper
   # @private
   def adapter

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rautomation
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-02-23 00:00:00.000000000 Z
+date: 2012-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &26885976 !ruby/object:Gem::Requirement
+  requirement: &25954488 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,7 +21,7 @@ dependencies:
         version: '2.3'
   type: :development
   prerelease: false
-  version_requirements: *26885976
+  version_requirements: *25954488
 description: ! "RAutomation is a small and easy to use library for helping out to
   automate windows and their controls\nfor automated testing.\n\nRAutomation provides:\n*
   Easy to use and user-friendly API (inspired by Watir http://www.watir.com)\n* Cross-platform