mohawk 0.1.4 → 0.2

data/.gitmodules

@@ -1,3 +1,3 @@
-[submodule "mohawk-testing-app"]
-	path = mohawk-testing-app
-	url = git://github.com/leviwilson/mohawk-testing-app.git
+[submodule "mohawk-testing-app"]
+	path = mohawk-testing-app
+	url = git://github.com/leviwilson/mohawk-testing-app.git

data/Changelog

@@ -1,6 +1,11 @@
-===	Version 0.1.4
+===	Version 0.2 / 2014-05-09
+*	Enhancements
+	*	Swapped out the underlying driver to use the uia gem
+
+===	Version 0.1.4 / 2014-02-05
 *	Enhancements
 	*	make it more explicit if you want to add a row to the selection
+	*	added another adapter that uses the uia gem
 
 ===	Version 0.1.0 / 2013-10-03
 *	Enhancments

data/Rakefile

@@ -1,3 +1,4 @@
+require 'bundler/setup'
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 require 'rubygems'
@@ -11,8 +12,6 @@ RSpec::Core::RakeTask.new(:spec) do |spec|
 end
 task :spec
 
-Cucumber::Rake::Task.new(:features) do |t|
-  t.profile = 'default'
-end
+Cucumber::Rake::Task.new(:features)
 
 task :default => :spec

data/cucumber.yml

@@ -1 +1 @@
-default: --no-source --color --format pretty
+default: --no-source --color --format pretty

data/features/combo_box.feature

@@ -8,6 +8,10 @@ Feature:  Working with combo boxes
     When I select the value "Orange" from the "fruits" combo box
     Then the "Orange" option should be selected in the "fruits" combo box
 
+  Scenario: Selecting items by regex
+    When I select the regex value "[Or]an" from the "fruits" combo box
+    Then the "Orange" option should be selected in the "fruits" combo box
+
   Scenario: Selecting multiple items
     Given we toggle the multi-select button
     When I select indexes "0, 1, 2" from the "fruits_list" combo box
@@ -34,3 +38,7 @@ Feature:  Working with combo boxes
       | Coconut       |
       | Orange        |
       | Passion Fruit |
+
+  Scenario: Interacting with ListBox controls
+    When I select the value "Orange" from the "fruits_list" combo box
+    Then the application should know that "Orange" was selected

data/features/menu.feature

@@ -1,5 +1,13 @@
 Feature:  Working with menu items
 
+Scenario: Selecting a menu item by text
+  When I select the menu item by text
+  Then I should see the "About" window
+
 Scenario: Selecting an item from the menu
   When I select the menu item in the path "File | Roundabout Way | To | About"
   Then I should see the "About" window
+
+Scenario: Clicking an item from the menu
+  When I click the menu item in the path "File | Roundabout Way | To | About"
+  Then I should see the "About" window

data/features/step_definitions/button_steps.rb

@@ -3,7 +3,7 @@ When /^I click the "(.*?)" button$/ do |name|
 end
 
 Then /^I should see the "(.*?)" window$/ do |window_title|
-  RAutomation::Window.new(:title => window_title).wait_until_exists
+  Mohawk::Waiter.wait_until { Uia.find_element title: window_title }
 end
 
 When /^I look at the value of the "(.*?)" control$/ do |name|

data/features/step_definitions/combo_box_steps.rb

@@ -10,6 +10,10 @@ When /^I select the value "(.*?)" from the "(.*?)" combo box$/ do |index, name|
   on(MainScreen).send "#{name.to_field}=", index
 end
 
+When(/^I select the regex value "([^"]*)" from the "([^"]*)" combo box$/) do |regex, name|
+  on(MainScreen).send "#{name.to_field}=", /#{regex}/
+end
+
 When(/^I clear the item at index "([^"]*)" from the "([^"]*)" combo box$/) do |which, name|
   on(MainScreen).send("clear_#{name.to_field}", which.to_i)
 end
@@ -19,7 +23,11 @@ When(/^I clear item "([^"]*)" from the "([^"]*)" combo box$/) do |which, name|
 end
 
 Then /^the "(.*?)" option(s)? should be selected in the "(.*?)" combo box$/ do |value, has_multiple, name|
-  on(MainScreen).send("#{name.to_field}_selections").should eq(value.split(', '))
+  if has_multiple
+    on(MainScreen).send("#{name.to_field}_selections").should eq(value.split(', '))
+  else
+    on(MainScreen).send("#{name.to_field}").should eq(value)
+  end
 end
 
 When /^I look at the options for the "(.*?)" combo box"$/ do |name|
@@ -34,3 +42,7 @@ end
 Given(/^we toggle the multi-select button$/) do
   on(MainScreen).toggle_multi
 end
+
+Then(/^the application should know that "([^"]*)" was selected$/) do |expected_value|
+  on(MainScreen).fruits_label.should eq(expected_value)
+end

data/features/step_definitions/control_steps.rb

@@ -7,5 +7,5 @@ When(/^I click the control identified by "([^"]*)"$/) do |what|
 end
 
 Then(/^the "([^"]*)" screen should be shown$/) do |screen|
-  on(AboutScreen).should be_active
+  on(AboutScreen).should be_present
 end

data/features/step_definitions/menu_steps.rb

@@ -1,5 +1,10 @@
-When /^I select the menu item in the path "(.*?)"$/ do |menu_path|        
+When(/^I select the menu item by text$/) do
+  on(MainScreen).menu_item_by_text
+end
+
+When /^I (select|click) the menu item in the path "(.*?)"$/ do |select_or_click, menu_path|
   menu_item_method = menu_path.gsub(/ (\| )?/, "_").downcase
+  menu_item_method.prepend('click_') if select_or_click == 'click'
   on(MainScreen).send menu_item_method
-end                                                                  
+end
 

data/features/support/screens/main_screen.rb

@@ -3,6 +3,7 @@ class MainScreen
   window(:title => /MainFormWindow/)
 
   text(:text_field, :id => "textField")
+  text(:text_box_field, :id => "multiLineTextField")
   text(:masked_text_field, :id => "maskedTextBox")
   button(:data_entry_form_button, :value => "Data Entry Form")
   button(:about, :value => "About")
@@ -16,8 +17,10 @@ class MainScreen
   checkbox(:first_checkbox, :id =>  "checkBox")
   radio(:first_radio, :id => "radioButton1")
   label(:label_control, :id => "label1")
+  label(:fruits_label, :id => 'fruitsLabel')
   link(:link_control, :id => "linkLabel1")
   menu_item(:file_roundabout_way_to_about, :path => ["File", "Roundabout Way", "To", "About"])
+  menu_item(:menu_item_by_text, text: 'About')
   tree_view(:tree_view, :id => "treeView")
   control(:value_control_field, :id => "automatableMonthCalendar1")
   spinner(:spinner, :id => 'numericUpDown1')

data/features/table.feature

@@ -13,14 +13,14 @@ Feature:  Working with tables
 
   Scenario: Selecting a row by matching cell information
     When we select the table row with the following information:
-      | name     | date_of_birth |
-      | Anna Doe | 3/4/1975      |
+      | full_name | date_of_birth |
+      | Anna Doe  | 3/4/1975      |
     Then the row with index "1" should be selected
 
   Scenario: Finding a row
     Then we can find the row with the following information:
-      | name     | date_of_birth | state |
-      | John Doe | 12/15/1967    | FL    |
+      | full_name | date_of_birth | state |
+      | John Doe  | 12/15/1967    | FL    |
 
   Scenario: Selecting a row from a child item
     When we select the "1"th table row
@@ -41,8 +41,8 @@ Feature:  Working with tables
   Scenario: Clearing a row by matching cell information
     Given we add rows "0, 1" to the selection
     When we clear the table row with the following information:
-      | name     | date_of_birth |
-      | Anna Doe | 3/4/1975      |
+      | full_name | date_of_birth |
+      | Anna Doe  | 3/4/1975      |
     Then the row with index "1" should not be selected
 
   Scenario: Rows have cells
@@ -57,7 +57,7 @@ Feature:  Working with tables
       | Anna Doe | 1   |
 
   Scenario: Retrieving the headers
-    Then the table headers are "Name, Date of birth, State"
+    Then the table headers are "Full Name, Date of birth, State"
 
   Scenario: Retrieving a row value by its header
     Then the "date_of_birth" for the row at index "1" is "3/4/1975"

data/features/text.feature

@@ -4,6 +4,10 @@ Scenario: Setting and getting text
   When I set the "text field" to the value "Some text"
   Then the "text field" should be "Some text"
 
+Scenario: Setting and getting text from a text box control
+  When I set the "text box field" to the value "Some text"
+  Then the "text box field" should be "Some text"
+
 Scenario: Clearing text
   When I set the "text field" to the value "Text to be cleared"
   And I clear the "text field"

data/lib/mohawk/accessors.rb

@@ -226,6 +226,9 @@ module Mohawk
       define_method("#{name}") do
         adapter.menu_item(locator).select
       end
+      define_method("click_#{name}") do
+        adapter.menu_item(locator).click
+      end
     end
 
     # Generates methods for working with table or list view controls

data/lib/mohawk/adapters/uia/button.rb

@@ -0,0 +1,14 @@
+module Mohawk
+  module Adapters
+    module UIA
+      class Button < Control
+        include Mohawk::Waiter
+        valid_patterns :invoke
+
+        def click
+          element.as(:invoke).invoke
+        end
+      end
+    end
+  end
+end

data/lib/mohawk/adapters/uia/checkbox.rb

@@ -0,0 +1,22 @@
+module Mohawk
+  module Adapters
+    module UIA
+      class CheckBox < Control
+        valid_patterns :toggle
+
+        def set_check(should_check)
+          toggle.toggle_state = should_check ? :on : :off
+        end
+
+        def checked?
+          toggle.toggle_state == :on
+        end
+
+        private
+        def toggle
+          element.as :toggle
+        end
+      end
+    end
+  end
+end

data/lib/mohawk/adapters/uia/control.rb

@@ -0,0 +1,83 @@
+module Mohawk
+  module Adapters
+    module UIA
+      class Control
+        include Mohawk::Waiter
+
+        class << self
+          attr_reader :patterns
+
+          def valid_patterns(*patterns)
+            @patterns = patterns
+          end
+        end
+
+        def initialize(adapter, locator)
+          @parent = adapter.window.element
+          @locator = locator
+        end
+
+        def click
+          element.click
+        end
+
+        def focus
+          element.focus
+        end
+
+        def exist?
+          locate_element != nil
+        end
+        alias_method :exists?, :exist?
+
+        def enabled?
+          exist? && element.enabled?
+        end
+
+        def disabled?
+          !enabled?
+        end
+
+        def visible?
+          exist? && element.visible?
+        end
+
+        def element
+          @element ||= wait_until  { locate_element }
+        end
+
+        def handle
+          element.handle
+        end
+
+        def value
+          element.name
+        end
+        alias_method :control_name, :value
+
+        def view
+          self
+        end
+
+        def method_missing(meth, *args, &block)
+          if element.respond_to? meth
+            element.send meth, *args, &block
+          else
+            super
+          end
+        end
+
+        private
+        def locate_element
+          scope = (@locator.delete(:children_only) && :children) || :descendants
+          locator = @locator.merge(scope: scope)
+
+          patterns = @locator.delete(:pattern) || self.class.patterns
+          locator.merge!(pattern: patterns) if patterns
+
+          @parent.find locator
+        end
+      end
+    end
+  end
+end

data/lib/mohawk/adapters/uia/element_locator.rb

@@ -0,0 +1,19 @@
+module Mohawk
+  module Adapters
+    module UIA
+      module ElementLocator
+        private
+        def find_element(value)
+          case value
+            when Regexp
+              all_items.find { |e| e.name =~ value }
+            when String
+              all_items.find { |e| e.name == value }
+            when Fixnum
+              all_items[value]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mohawk/adapters/uia/menu_item.rb

@@ -0,0 +1,48 @@
+module Mohawk
+  module Adapters
+    module UIA
+      class MenuItem < Control
+        class MenuItemNotFound < StandardError; end
+
+        def select
+          menu_item.as(:invoke).invoke
+        end
+
+        def click
+          menu_item.click_center
+        end
+
+        def exist?
+          !!menu_item
+        rescue MenuItemNotFound
+          false
+        end
+        alias_method :exists?, :exist?
+
+        private
+        def menu_item
+          current_item = @parent
+          path.each_with_index do |menu_item, index|
+            current_item = current_item.filter(control_type: :menu_item, name: menu_item).first
+            raise MenuItemNotFound, menu_item unless current_item
+            try_to_expand current_item unless index == path.count - 1
+          end
+          current_item
+        end
+
+        def path
+          [@locator[:path] || @locator[:text]].flatten
+        end
+
+        def try_to_expand(item)
+          case
+            when item.patterns.include?(:expand_collapse)
+              item.as(:expand_collapse).expand
+            else
+              item.as(:invoke).invoke
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mohawk/adapters/uia/radio.rb

@@ -0,0 +1,22 @@
+module Mohawk
+  module Adapters
+    module UIA
+      class Radio < Control
+        valid_patterns :selection_item
+
+        def set
+          selection_item.select
+        end
+
+        def set?
+          selection_item.selected?
+        end
+
+        private
+        def selection_item
+          element.as :selection_item
+        end
+      end
+    end
+  end
+end

data/lib/mohawk/adapters/uia/select_list.rb

@@ -0,0 +1,53 @@
+module Mohawk
+  module Adapters
+    module UIA
+      class SelectList < Control
+        include ElementLocator
+
+        def set(value)
+          which = find_element(value)
+          if select_list.multi_select?
+            which.add_to_selection
+          else
+            click_or_select which
+          end
+        end
+
+        def clear(value)
+          find_element(value).remove_from_selection
+        end
+
+        def value
+          values.first || ''
+        end
+
+        def values
+          selected_items.map &:name
+        end
+
+        def selected_items
+          select_list.selected_items
+        end
+
+        def options
+          all_items.map &:name
+        end
+
+        private
+        def select_list
+          element.as :selection
+        end
+
+        def all_items
+          select_list.selection_items
+        end
+
+        def click_or_select(item)
+          item.click
+        rescue
+          item.select
+        end
+      end
+    end
+  end
+end

data/lib/mohawk/adapters/uia/spinner.rb

@@ -0,0 +1,30 @@
+module Mohawk
+  module Adapters
+    module UIA
+      class Spinner < Control
+        valid_patterns :range_value
+
+        def value=(value)
+          spinner.value = value
+        end
+
+        def value
+          spinner.value
+        end
+
+        def increment
+          self.value = value + spinner.small_change
+        end
+
+        def decrement
+          self.value = value - spinner.small_change
+        end
+
+        private
+        def spinner
+          element.as :range_value
+        end
+      end
+    end
+  end
+end

data/lib/mohawk/adapters/uia/tab_control.rb

@@ -0,0 +1,26 @@
+module Mohawk
+  module Adapters
+    module UIA
+      class TabControl < Control
+        include ElementLocator
+
+        def selected_tab=(which)
+          find_element(which).select
+        end
+
+        def value
+          all_items.find(&:selected?).name
+        end
+
+        def items
+          all_items.map &:name
+        end
+
+        private
+        def all_items
+          element.filter(control_type: :tab_item).map {|e| e.as :selection_item }
+        end
+      end
+    end
+  end
+end

data/lib/mohawk/adapters/uia/table.rb

@@ -0,0 +1,62 @@
+module Mohawk
+  module Adapters
+    module UIA
+      class Table < Control
+        include ElementLocator, Enumerable
+        valid_patterns :table
+
+        def select(which)
+          find_row_with(which).select
+        end
+
+        def add(which)
+          find_row_with(which).add
+        end
+
+        def clear(which)
+          find_row_with(which).clear
+        end
+
+        def headers
+          element.headers.map &:name
+        end
+
+        def [](index)
+          row_at(index)
+        end
+
+        def each
+          all_items.each { |row| yield row }
+        end
+
+        def find_row_with(row_info)
+          found_row = case row_info
+                        when Hash
+                          find_by_hash(row_info)
+                        else
+                          find_element(row_info)
+                      end
+          raise "A row with #{row_info} was not found" unless found_row
+          found_row
+        end
+
+        def element
+          super.as(:table)
+        end
+
+        private
+        def find_by_hash(hash)
+          find { |r| r.all_match? hash }
+        end
+
+        def row_at(index)
+          TableRow.new self, index
+        end
+
+        def all_items
+          element.row_count.times.map { |index| TableRow.new self, index }
+        end
+      end
+    end
+  end
+end

data/lib/mohawk/adapters/uia/table_row.rb

@@ -0,0 +1,73 @@
+module Mohawk
+  module Adapters
+    module UIA
+      class TableRow
+        attr_reader :index
+
+        def initialize(table, index)
+          @table, @index = table, index
+        end
+
+        def name
+          element.name
+        end
+
+        def cells
+          element.items.map &:name
+        end
+
+        def select
+          selection_item.select
+          self
+        end
+
+        def add
+          selection_item.add_to_selection
+          self
+        end
+
+        def clear
+          selection_item.remove_from_selection
+          self
+        end
+
+        def selected?
+          selection_item.selected?
+        end
+
+        def all_match?(hash)
+          hash.all? do |key, value|
+            value_from_header(key) == "#{value}"
+          end
+        end
+
+        def to_hash
+          {text: element.name, row: index}
+        end
+
+        def method_missing(name, *args)
+          value_from_header name
+        end
+
+        def value_from_header(name)
+          which_column = header_methods.find_index {|h| h.to_s == name.to_s }
+          raise ArgumentError, "#{name} column does not exist in #{header_methods}" if which_column.nil?
+          cells[which_column]
+        end
+
+        private
+        def element
+          @element ||= @table.element.row_at(@index)
+        end
+
+        def selection_item
+          element.as :selection_item
+        end
+
+        def header_methods
+          @headers ||= @table.headers.map(&:to_method)
+        end
+      end
+    end
+  end
+end