mohawk 0.0.4 → 0.0.5

data/Changelog

@@ -1,3 +1,10 @@
+=== Version 0.0.5 / 2013-07-23
+*	Enhancements
+	*	can tell a screen to only consider child controls when searching (can
+	boost speed, especially on windows with data grid views)
+	*   added a simplified way to start and stop an application
+	*   added the ability to select a table row based on a hash
+
 === Version 0.0.4 / 2013-05-24
 *	Enhancements
 	*	sped up table access when there are many rows

data/LICENSE.txt

@@ -1,22 +1,20 @@
-Copyright (c) 2012 Levi Wilson
+The MIT License (MIT)
 
-MIT License
+Copyright (c) 2013 Levi Wilson
 
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
 
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/features/control.feature

@@ -3,3 +3,7 @@ Feature:  Working with controls
   Scenario: Getting and setting the value of value controls
     When I set the "value control field" to the value "12/25/2012"
     Then the value of the "value control field" control should be "12/25/2012 12:00:00 AM"
+
+  Scenario: Clicking controls
+    When I click the control identified by "about_control"
+    Then the "About" screen should be shown

data/features/mohawk.feature

@@ -19,3 +19,7 @@ Scenario: Waiting for a particular control
 Scenario: Specifying a parent container
   When we are using the "ScreenWithContainer"
   Then our parent is the container, not the main window
+
+Scenario: Forcing the search scope to children only
+  When we tell the screen to limit searches to children only
+  Then we notice a performance increase, especially when data grid views are involved

data/features/step_definitions/control_steps.rb

@@ -1,3 +1,11 @@
 Then /^the value of the "([^"]*)" control should be "(.*?)"$/ do |which, what|
   on(MainScreen).send("#{which.to_method}_value").should eq(what)
+end
+
+When(/^I click the control identified by "([^"]*)"$/) do |what|
+  on(MainScreen).send("click_#{what}")
+end
+
+Then(/^the "([^"]*)" screen should be shown$/) do |screen|
+  on(AboutScreen).should be_active
 end

data/features/step_definitions/mohawk_steps.rb

@@ -21,4 +21,15 @@ end
 Then /^our parent is the container, not the main window$/ do
   @screen.adapter.window.title.should_not match(/MainForm/)
   @screen.up_view.control_name.should eq('Forward')
+end
+
+When(/^we tell the screen to limit searches to children only$/) do
+  on(MainScreen).data_grid
+  on(ScreenScopedToChildren).should be_active
+end
+
+Then(/^we notice a performance increase, especially when data grid views are involved$/) do
+  start = Time.now
+  on(ScreenScopedToChildren).close
+  (Time.now - start).should be < 2
 end

data/features/step_definitions/navigation_steps.rb

@@ -7,7 +7,7 @@ Then /^we should still arrive at our destination$/ do
 end
 
 When /^we give extra navigational information to a screen$/ do
-  @which_screen = on(MainScreen, :pid => @process.pid)
+  @which_screen = on(MainScreen, :pid => Mohawk.app.pid)
 end
                                                                    
 Then /^it should listen to every word that we say$/ do

data/features/step_definitions/table_steps.rb

@@ -17,6 +17,10 @@ When /^we select the table row with the value "([^"]*)"$/ do |row_value|
   on(DataEntryForm).people = row_value
 end
 
+When(/^we select the table row with the following information:$/) do |table|
+  on(DataEntryForm).select_people table.hashes.first
+end
+
 When /^we select the "(.*?)"th table row$/ do |index|
   on(DataEntryForm).people[index.to_i].select
 end
@@ -50,4 +54,5 @@ end
 
 Then(/^accessing the values in row "([^"]*)" should be snappy$/) do |which_row|
   Timeout.timeout(5.0) { on(DataEntryForm).people[which_row.to_i].cells.should_not be_empty }
-end
+end
+

data/features/support/env.rb

@@ -8,6 +8,8 @@ World(Mohawk::Navigation)
 
 require_rel 'screens'
 
+Mohawk.app_path = 'features/support/WindowsForms.exe'
+
 Mohawk::Navigation.routes = {
   :default => [
     [MainScreen, :about],
@@ -18,11 +20,9 @@ Mohawk::Navigation.routes = {
 }
 
 Before do
-  @process = ChildProcess.build('features\\support\\WindowsForms.exe')
-  @process.start
-  RAutomation::WaitHelper.wait_until {RAutomation::Window.new(:pid => @process.pid).present?}
+  Mohawk.start
 end
 
 After do
-  @process.stop
+  Mohawk.stop
 end

data/features/support/screens/main_screen.rb

@@ -6,6 +6,8 @@ class MainScreen
   text(:masked_text_field, :id => "maskedTextBox")
   button(:data_entry_form_button, :value => "Data Entry Form")
   button(:about, :value => "About")
+  control(:about_control, :value => 'About')
+  button(:data_grid, :value => "Data Grid View")
   combo_box(:fruits, :id => "FruitsComboBox")
   checkbox(:first_checkbox, :id =>  "checkBox")
   radio(:first_radio, :id => "radioButton1")

data/features/support/screens/screen_scoped_to_children.rb

@@ -0,0 +1,6 @@
+class ScreenScopedToChildren
+  include Mohawk
+  window(:title => /DataGridViewForm/, :children_only => true)
+
+  button(:close, :value => 'Close')
+end

data/features/table.feature

@@ -1,41 +1,47 @@
 Feature:  Working with tables
 
-Background:
-  Given we are observing the people table
-
-Scenario: Selecting a row by index
-  When we select the table row with index "1"
-  Then the row with index "1" should be selected
-
-Scenario: Selecting a row by value
-  When we select the table row with the value "Anna Doe"
-  Then the row with index "1" should be selected
-
-Scenario: Selecting a row from a child item
-  When we select the "1"th table row
-  Then the row with index "1" should be selected
-
-Scenario: Rows have cells
-  Then the row with index "0" should look like the following:
-    | Name      | Date of Birth | State |
-    | John Doe  | 12/15/1967    | FL    |
-
-Scenario: Retrieving the row values
-  Then the table row information should look like the following:
-    | text      | row |
-    | John Doe  | 0   | 
-    | Anna Doe  | 1   |
-
-Scenario: Retrieving the headers
-  Then the table headers are "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"
-
-Scenario: Working with lots of records counts
-  When there are a lot of records in a table
-  Then the table count responds in a reasonable amount of time
-
-Scenario: Working with a row when there are a lot of records
-  When there are a lot of records in a table
-  Then accessing the values in row "12" should be snappy
+  Background:
+    Given we are observing the people table
+
+  Scenario: Selecting a row by index
+    When we select the table row with index "1"
+    Then the row with index "1" should be selected
+
+  Scenario: Selecting a row by value
+    When we select the table row with the value "Anna Doe"
+    Then the row with index "1" should be selected
+
+  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      |
+    Then the row with index "1" should be selected
+
+  Scenario: Selecting a row from a child item
+    When we select the "1"th table row
+    Then the row with index "1" should be selected
+
+  Scenario: Rows have cells
+    Then the row with index "0" should look like the following:
+      | Name     | Date of Birth | State |
+      | John Doe | 12/15/1967    | FL    |
+
+  Scenario: Retrieving the row values
+    Then the table row information should look like the following:
+      | text     | row |
+      | John Doe | 0   |
+      | Anna Doe | 1   |
+
+  Scenario: Retrieving the headers
+    Then the table headers are "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"
+
+  Scenario: Working with lots of records counts
+    When there are a lot of records in a table
+    Then the table count responds in a reasonable amount of time
+
+  Scenario: Working with a row when there are a lot of records
+    When there are a lot of records in a table
+    Then accessing the values in row "12" should be snappy

data/lib/mohawk/accessors/control.rb

@@ -15,8 +15,9 @@ module Mohawk
         @view.set value
       end
 
-      def click
-        @view.click
+      def click(&block)
+        @view.click &block if block
+        @view.click { true } unless block
       end
     end
   end

data/lib/mohawk/accessors/table.rb

@@ -10,7 +10,18 @@ module Mohawk
       end
 
       def select(which_item)
-        view.select which_item
+        case which_item
+          when Hash
+            find_row_with(which_item).select
+          else
+            select_by_value(which_item)
+        end
+      end
+
+      def find_row_with(row_info)
+        found_row = find { |r| r.all_match? row_info }
+        raise "A row with #{row_info} was not found" unless found_row
+        found_row
       end
 
       def headers
@@ -26,6 +37,11 @@ module Mohawk
           yield TableRow.new(self, row)
         end
       end
+
+      private
+      def select_by_value(which_item)
+        view.select which_item
+      end
     end
   end
 end

data/lib/mohawk/accessors/table_row.rb

@@ -22,6 +22,12 @@ module Mohawk
         row.cells.map &:text
       end
 
+      def all_match?(hash)
+        hash.all? do |key, value|
+          send(key) == "#{value}"
+        end
+      end
+
       def value_from_header(name)
         which_column = header_methods.index(name)
         raise ArgumentError, "#{name} column does not exist in #{header_methods}" if which_column.nil?

data/lib/mohawk/accessors.rb

@@ -223,7 +223,7 @@ module Mohawk
     #
     # @example
     #   table(:some_table, :id => "tableId")
-    #   # will generate 'some_table', 'some_table=', 'some_table_headers'
+    #   # will generate 'some_table', 'some_table=', 'some_table_headers', 'select_some_table'
     #   # and 'some_table_view' methods to get an Enumerable of table rows,
     #   # select a table item, return all of the headers and get the raw view
     #
@@ -241,6 +241,9 @@ module Mohawk
       define_method("#{name}=") do |which_item|
         adapter.table(locator).select which_item
       end
+      define_method("select_#{name}") do |hash_info|
+        adapter.table(locator).select hash_info
+      end
       define_method("#{name}_headers") do
         adapter.table(locator).headers
       end
@@ -292,8 +295,8 @@ module Mohawk
       define_method("#{name}=") do |value|
         adapter.value_control(locator).set value
       end
-      define_method("click_#{name}") do
-        adapter.value_control(locator).click
+      define_method("click_#{name}") do |&block|
+        adapter.value_control(locator).click &block
       end
       define_method("#{name}_view") do
         adapter.value_control(locator).view

data/lib/mohawk/adapters/uia_adapter.rb

@@ -2,6 +2,7 @@ module Mohawk
   module Adapters
     class UiaAdapter
       def initialize(locator, container=nil)
+        @only_search_children = locator.delete(:children_only)
         @window = RAutomation::Window.new(locator.merge(:adapter => :ms_uia))
         @container = container
       end
@@ -19,56 +20,63 @@ module Mohawk
 
       def combo(locator)
         @combos ||= {}
-        @combos[locator] ||= Mohawk::Accessors::Combo.new(self, locator)
+        @combos[locator] ||= Mohawk::Accessors::Combo.new(self, merge(locator))
       end
 
+
       def checkbox(locator)
         @checkbox ||= {}
-        @checkbox[locator] ||= Mohawk::Accessors::CheckBox.new(self, locator)
+        @checkbox[locator] ||= Mohawk::Accessors::CheckBox.new(self, merge(locator))
       end
 
       def text(locator)
         @text_fields ||= {}
-        @text_fields[locator] ||= Mohawk::Accessors::Text.new(self, locator)
+        @text_fields[locator] ||= Mohawk::Accessors::Text.new(self, merge(locator))
       end
 
       def button(locator)
         @buttons ||= {}
-        @buttons[locator] ||= Mohawk::Accessors::Button.new(self, locator)
+        @buttons[locator] ||= Mohawk::Accessors::Button.new(self, merge(locator))
       end
 
       def radio(locator)
         @radios ||= {}
-        @radios[locator] ||= Mohawk::Accessors::Radio.new(self, locator)
+        @radios[locator] ||= Mohawk::Accessors::Radio.new(self, merge(locator))
       end
 	  
       def label(locator)
         @labels ||= {}
-        @labels[locator] ||= Mohawk::Accessors::Label.new(self, locator)
+        @labels[locator] ||= Mohawk::Accessors::Label.new(self, merge(locator))
       end
 
       def link(locator)
         @links ||= {}
-        @links[locator] ||= Mohawk::Accessors::Link.new(self, locator)
+        @links[locator] ||= Mohawk::Accessors::Link.new(self, merge(locator))
       end
 
       def menu_item(locator)
-        Mohawk::Accessors::MenuItem.new(self, locator)
+        Mohawk::Accessors::MenuItem.new(self, merge(locator))
       end
 
       def table(locator)
         @tables ||= {}
-        @tables[locator] ||= Mohawk::Accessors::Table.new(self, locator)
+        @tables[locator] ||= Mohawk::Accessors::Table.new(self, merge(locator))
       end
 
       def tree_view(locator)
         @trees ||= {}
-        @trees[locator] ||= Mohawk::Accessors::TreeView.new(self, locator)
+        @trees[locator] ||= Mohawk::Accessors::TreeView.new(self, merge(locator))
       end
 
       def value_control(locator)
         @controls ||= {}
-        @controls[locator] ||= Mohawk::Accessors::Control.new(self, locator)
+        @controls[locator] ||= Mohawk::Accessors::Control.new(self, merge(locator))
+      end
+
+      private
+      def merge(locator)
+        locator = locator.merge(:children_only => true) if @only_search_children
+        locator
       end
     end
   end

data/lib/mohawk/version.rb

@@ -1,3 +1,3 @@
 module Mohawk
-  VERSION = "0.0.4"
+  VERSION = "0.0.5"
 end

data/lib/mohawk.rb

@@ -1,4 +1,5 @@
 require "rautomation"
+require 'childprocess'
 require "mohawk/version"
 require "require_all"
 require "mohawk/accessors"
@@ -9,13 +10,43 @@ require "mohawk/core_ext/string"
 require_rel "mohawk/accessors"
 
 module Mohawk
+  include RAutomation::WaitHelper
+  extend RAutomation::WaitHelper
 
-  attr_reader :adapter
+  class InvalidApplicationPath < StandardError
+    def initialize(message='You must set the Mohawk.app_path to start an application')
+      super
+    end
+  end
 
   def self.included(cls)
     cls.extend Mohawk::Accessors
   end
 
+  attr_reader :adapter
+
+  def self.start
+    raise InvalidApplicationPath.new unless @app_path
+    @app = ChildProcess.build(@app_path).start
+
+    app_window = RAutomation::Window.new :pid => @app.pid
+    wait_until { app_window.present? }
+  end
+
+  def self.stop
+    raise 'An application was never started' unless @app
+    @app.stop unless @app.exited?
+    @app = nil
+  end
+
+  def self.app
+    @app
+  end
+
+  def self.app_path=(path)
+    @app_path = path
+  end
+
   def initialize(extra={})
     locator = [which_window.merge(extra)]
     locator << parent_container if respond_to?(:parent_container)
@@ -56,19 +87,12 @@ module Mohawk
   def wait_for_control(locator)
     control = adapter.window.control(locator)
     begin
-      RAutomation::WaitHelper.wait_until { control.exist? }
+      wait_until { control.exist? }
     rescue
       raise "A control with #{locator} was not found"
     end
   end
 
-  #
-  # Waits until the block returns true
-  #
-  def wait_until(timeout=RAutomation::Window.wait_timeout, &block)
-    RAutomation::WaitHelper.wait_until timeout, &block
-  end
-
   #
   # Indicates if the window has text or not
   #

data/mohawk.gemspec

@@ -11,15 +11,17 @@ Gem::Specification.new do |gem|
   gem.description   = %q{High level wrapper around windows applications}
   gem.summary       = %q{High level wrapper around windows applications}
   gem.homepage      = "http://github.com/leviwilson/mohawk"
+  gem.license       = 'MIT'
 
   gem.files         = `git ls-files`.split($/)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
 
-  gem.add_dependency 'rautomation', '>= 0.9.2'
+  gem.add_dependency 'rautomation', '~> 0.9.3'
   gem.add_dependency 'require_all'
   gem.add_dependency 'page_navigation', '>= 0.7'
+  gem.add_dependency 'childprocess', '~> 0.3.9'
 
   gem.add_development_dependency 'cucumber'
   gem.add_development_dependency 'rspec', '>= 2.12.0'

data/spec/lib/mohawk/accessors/control_spec.rb

@@ -28,10 +28,19 @@ describe Mohawk::Accessors::Control do
   end
 
   it "can click the control" do
-    control.should_receive(:click)
+    control.should_receive(:click).and_yield
     screen.click_control_yourself
   end
 
+  it "can give a custom block to the click method" do
+    control.should_receive(:click).and_yield
+    result = false
+    screen.click_control_yourself do
+      result = true
+    end
+    result.should be_true
+  end
+
   it "can work with the raw view" do
     screen.control_yourself_view.should be(control)
   end

data/spec/lib/mohawk/accessors/table_spec.rb

@@ -4,122 +4,142 @@ class TableScreen
   include Mohawk
   window(:id => nil)
 
-  table(:top, :id => "tableId")
+  table(:top, :id => 'tableId')
 
   # aliases
-  table(:my_default, :id => "defaultAliasId")
-  listview(:my_listview, :id => "listviewAliasId")
-  list_view(:my_list_view, :id => "list_viewAliasId")
+  table(:my_default, :id => 'defaultAliasId')
+  listview(:my_listview, :id => 'listviewAliasId')
+  list_view(:my_list_view, :id => 'list_viewAliasId')
 end
 
-class FakeTableRow
-  attr_reader :text, :row
-  def initialize(text, row)
-    @text = text
-    @row = row
-  end
-end
+include RAutomation::Adapter::MsUia
 
 describe Mohawk::Accessors::Table do
   let(:screen) { TableScreen.new }
-  let(:window) { double("RAutomation Window") }
-  let(:table) { double("Table") }
+  let(:window) { double('RAutomation Window') }
+  let(:table) { double('Table') }
 
   before(:each) do
     RAutomation::Window.stub(:new).and_return(window)
   end
 
-  context "working with table controls" do
+  context 'working with table controls' do
     before(:each) do
-      window.should_receive(:table).with(:id => "tableId").and_return(table)
+      window.should_receive(:table).with(:id => 'tableId').and_return(table)
     end
 
-    it "can select a row by index" do
+    it 'can select a row by index' do
       table.should_receive(:select).with(1)
       screen.top = 1
     end
 
-    it "can select a row by value" do
-      table.should_receive(:select).with "John Elway"
-      screen.top = "John Elway"
+    it 'can select a row by value' do
+      table.should_receive(:select).with 'John Elway'
+      screen.top = 'John Elway'
+    end
+
+    context 'selecting a row by hash' do
+      it 'selects the row if all values match' do
+        TableStubber.stub(table)
+          .with_headers('Column One', 'Column Two', 'Column Three')
+          .and_row('first', 'something', 'foo')
+          .and_row('second', 'another', 'bar')
+
+        table.should_receive(:select).with(1)
+        screen.select_top :column_one => 'second', :column_three => 'bar'
+      end
+
+      it 'can handle non-string values' do
+        TableStubber.stub(table)
+          .with_headers('name', 'age')
+          .and_row('Levi', '33')
+
+        table.should_receive(:select).with(0)
+        screen.select_top :age => 33
+      end
+
+      it 'raises if no row is found' do
+        TableStubber.stub(table)
+        .with_headers('Column One', 'Column Two', 'Column Three')
+        .and_row('first', 'something', 'foo')
+
+        lambda { screen.select_top :column_one => 'not found' }.should raise_error "A row with {:column_one=>\"not found\"} was not found"
+      end
+
     end
 
-    it "has rows" do
-      first_row = FakeTableRow.new "First Row", 0
-      second_row = FakeTableRow.new "Second Row", 1
-      expected_rows = [first_row, second_row].map {|r| {:text => r.text, :row => r.row} }
-      table.should_receive(:row_count).and_return(2)
-      RAutomation::Adapter::MsUia::Row.should_receive(:new).with(table, :index => 0).and_return(first_row)
-      RAutomation::Adapter::MsUia::Row.should_receive(:new).with(table, :index => 1).and_return(second_row)
-      screen.top.map(&:to_hash).should eq(expected_rows)
+    it 'has rows' do
+      TableStubber.stub(table)
+        .with_headers('Column')
+        .and_row('First Row')
+        .and_row('Second Row')
+
+      screen.top.map(&:column).should eq(['First Row', 'Second Row'])
     end
 
-    it "has headers" do
-      expected_headers = ["first header", "second header"]
-      table.should_receive(:search_information).and_return(1234)
-      RAutomation::Adapter::MsUia::UiaDll.should_receive(:table_headers).with(1234).and_return(expected_headers)
-      screen.top_headers.should eq(expected_headers)
+    it 'has headers' do
+      TableStubber.stub(table).with_headers('first header', 'second header')
+      screen.top_headers.should eq(['first header', 'second header'])
     end
 
-    it "can return the raw view" do
+    it 'can return the raw view' do
       screen.top_view.should_not be_nil
     end
 
     describe Mohawk::Accessors::TableRow do
-      let(:table_row) { double("RAutomation TableRow") }
-
       before(:each) do
-        RAutomation::Adapter::MsUia::Row.should_receive(:new).with(table, :index => 0).and_return(table_row)
-        table_row.stub(:row).and_return 0
+        TableStubber.stub(table).with_headers('column').and_row('first row')
       end
 
-      it "can get an individual row" do
+      it 'can get an individual row' do
         screen.top[0].should_not be_nil
       end
 
-      it "knows if it is selected" do
+      it 'knows if it is selected' do
         table.should_receive(:selected?).with(0).and_return(true)
         screen.top[0].should be_selected
       end
 
-      it "can be selected" do
+      it 'can be selected' do
         table.should_receive(:select).with(0)
         screen.top[0].select
       end
 
-      it "has cells" do
-        expected_cells = [FakeTableRow.new("Item 1", 0), FakeTableRow.new("Item 2", 1)]
-        table_row.should_receive(:cells).and_return(expected_cells)
-        screen.top[0].cells.should eq expected_cells.map &:text
+      it 'has cells' do
+        TableStubber.stub(table)
+          .with_headers('first', 'second')
+          .and_row('Cell 1', 'Cell 2')
+
+        screen.top[0].cells.should eq(['Cell 1', 'Cell 2'])
       end
 
-      it "can get cell values by header name" do
-        RAutomation::Adapter::MsUia::UiaDll.should_receive(:table_headers).and_return(["First Header", "Second Header"])
-        table.should_receive(:search_information)
+      it 'can get cell values by header name' do
+        TableStubber.stub(table)
+          .with_headers('First Header', 'Second Header')
+          .and_row('Item 1', 'Item 2')
 
-        expected_cell = double('RAutomation Cell')
-        expected_cell.should_receive(:text).and_return('Item 2')
-        RAutomation::Adapter::MsUia::Cell.should_receive(:new).with(table_row, :index => 1).and_return(expected_cell)
-        screen.top[0].second_header.should eq("Item 2")
+        screen.top[0].second_header.should eq('Item 2')
       end
 
-      it "clearly lets you know if a header is not there" do
-        RAutomation::Adapter::MsUia::UiaDll.should_receive(:table_headers).and_return(["First Header", "Second Header"])
-        table.should_receive(:search_information)
-        lambda { screen.top[0].does_not_exist }.should raise_error ArgumentError, "does_not_exist column does not exist in [:first_header, :second_header]"
+      it 'clearly lets you know if a header is not there' do
+        TableStubber.stub(table)
+          .with_headers('First Header', 'Second Header')
+          .and_row('Item 1', 'Item 2')
+
+        lambda { screen.top[0].does_not_exist }.should raise_error ArgumentError, 'does_not_exist column does not exist in [:first_header, :second_header]'
       end
     end
   end
 
-  context "aliases for table" do
-    let(:null_table) { double("Null ComboBox Field").as_null_object }
-    let(:table_aliases) { ["default", "listview", "list_view"] }
+  context 'aliases for table' do
+    let(:null_table) { double('Null ComboBox Field').as_null_object }
+    let(:table_aliases) { ['default', 'listview', 'list_view'] }
 
     def expected_alias(id)
       window.should_receive(:table).with(:id => "#{id}AliasId").ordered.and_return(null_table)
     end
 
-    it "has many aliases" do
+    it 'has many aliases' do
       table_aliases.each do |which_alias|
         expected_alias which_alias
       end

data/spec/lib/mohawk/adapters/uia_adapter_spec.rb

@@ -2,7 +2,7 @@ require 'spec_helper'
 
 class AnyScreen
   include Mohawk
-  window(:title => /Some Title/)
+  window(:title => /Some Title/, :children_only => true)
 end
 
 RSpec::Matchers.define(:use_the_cached) do |control_type, the_alias=nil|
@@ -13,12 +13,33 @@ RSpec::Matchers.define(:use_the_cached) do |control_type, the_alias=nil|
   end
 end
 
+RSpec::Matchers.define(:only_search_children_for_a) do |control_type, the_alias=nil|
+  match do |screen|
+    screen.adapter.window.should_receive(the_alias || control_type).with(:id => 'id', :children_only => true).and_return(double('child control'))
+    screen.adapter.send(control_type, :id => 'id')
+    true
+  end
+end
+
 describe Mohawk::Adapters::UiaAdapter do
   subject(:screen) { AnyScreen.new }
 
   let(:window) { double('RAutomation Window') }
   before(:each) { RAutomation::Window.stub(:new).and_return(window) }
 
+  context 'limiting searches to children only' do
+    it { should only_search_children_for_a(:combo, :select_list) }
+    it { should only_search_children_for_a(:checkbox) }
+    it { should only_search_children_for_a(:text, :text_field) }
+    it { should only_search_children_for_a(:button) }
+    it { should only_search_children_for_a(:radio) }
+    it { should only_search_children_for_a(:label) }
+    it { should only_search_children_for_a(:link, :label) }
+    it { should only_search_children_for_a(:table) }
+    it { should only_search_children_for_a(:tree_view, :select_list) }
+    it { should only_search_children_for_a(:value_control) }
+  end
+
   context 'caching controls' do
     it { should use_the_cached(:combo, :select_list) }
     it { should use_the_cached(:checkbox) }

data/spec/lib/mohawk_spec.rb

@@ -11,6 +11,11 @@ describe Mohawk do
   let(:screen) { TestScreen.new }
   let(:window) { double('RAutomation Window') }
 
+  before(:each) do
+    Mohawk.app_path = nil
+    Mohawk.instance_variable_set(:@app, nil)
+  end
+
   it "uses the uia adapter by default" do
     RAutomation::Window.should_receive(:new).with(:title => "Some Window Title", :adapter => :ms_uia).and_return(window)
     TestScreen.new
@@ -21,6 +26,64 @@ describe Mohawk do
     TestScreen.new :extra => 'test'
   end
 
+  context 'launching an application' do
+    let(:process) { double('ChildProcess::Process') }
+
+    before(:each) do
+      process.stub(:start).and_return(process)
+      [:exited?, :stop, :pid].each &process.method(:stub)
+      ChildProcess.stub(:build).with('./the/app/path.exe').and_return(process)
+
+      RAutomation::Window.stub(:new).and_return(window)
+      window.stub(:present?).and_return(true)
+
+      Mohawk.app_path = './the/app/path.exe'
+    end
+
+    it 'requires a path' do
+      Mohawk.app_path = nil
+      lambda { Mohawk.start }.should raise_error(Mohawk::InvalidApplicationPath, 'You must set the Mohawk.app_path to start an application')
+    end
+
+    it 'can start an application' do
+      process.should_receive(:start)
+      Mohawk.start
+    end
+
+    it 'waits on the application' do
+      process.should_receive(:pid).and_return(123)
+      RAutomation::Window.should_receive(:new).with(:pid => 123).and_return(window)
+      window.should_receive(:present?).and_return(false, false, true)
+
+      Mohawk.start
+    end
+
+    it 'can stop an application' do
+      process.should_receive(:stop)
+      Mohawk.start
+
+      Mohawk.stop
+    end
+
+    it 'knows if a process was never started' do
+      lambda { Mohawk.stop }.should raise_error('An application was never started')
+    end
+
+    it 'does nothing if the process has exited' do
+      process.should_receive(:exited?).and_return(true)
+      process.should_not_receive(:stop)
+      Mohawk.start
+
+      Mohawk.stop
+    end
+
+    it 'has a clean slate if the application has been stopped' do
+      Mohawk.start
+      Mohawk.stop
+      Mohawk.app.should be_nil
+    end
+  end
+
   context "using the UI Automation adapter" do
     before(:each) do
       RAutomation::Window.stub(:new).and_return(window)
@@ -60,7 +123,7 @@ describe Mohawk do
     end
 
     it "tells you what you were waiting for if it fails" do
-      RAutomation::WaitHelper.should_receive(:wait_until).and_raise("you should have caught me")
+      screen.should_receive(:wait_until).and_raise("you should have caught me")
       locator = {:id => "whatever", :index => 0}
       window.should_receive(:control).with(locator)
       lambda { screen.wait_for_control(:id => "whatever", :index => 0) }.should raise_error(Exception, "A control with #{locator} was not found")

data/spec/spec_helper.rb

@@ -5,5 +5,6 @@ require 'rspec'
 require 'ffi_stub'
 require 'mohawk'
 require 'coveralls'
+require_rel 'table_stubber'
 
 Coveralls.wear!

data/spec/table_stubber.rb

@@ -0,0 +1,49 @@
+require 'securerandom'
+
+class TableStubber
+  include RSpec::Mocks::ExampleMethods
+
+  attr_reader :table, :rows
+
+  def initialize(table)
+    @table = table
+    @id = SecureRandom.base64
+    @table.stub(:search_information).and_return(@id)
+    @rows = []
+  end
+
+  def self.stub(table)
+    TableStubber.new(table)
+  end
+
+  def with_headers(*headers)
+    UiaDll.stub(:table_headers).with(@id).and_return(headers.map(&:to_s))
+    self
+  end
+
+  def and_row(*values)
+    stub_cells_for(add_row, values)
+    self
+  end
+
+  private
+  def add_row
+    row = double("table #{@id}, row #{rows.count}")
+    row.stub(:row).and_return(rows.count)
+    Row.stub(:new).with(table, :index => rows.count).and_return(row)
+    rows << row
+    table.stub(:row_count).and_return(rows.count)
+    row
+  end
+
+  def stub_cells_for(row, values)
+    cells = []
+    values.each_with_index do |value, index|
+      cell = double("Cell at #{row.row}, #{index}")
+      Cell.stub(:new).with(row, :index => index).and_return(cell)
+      cell.stub(:text).and_return(value)
+      cells << cell
+    end
+    row.stub(:cells).and_return(cells)
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mohawk
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
   prerelease: 
 platform: ruby
 authors:
@@ -9,24 +9,24 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-24 00:00:00.000000000 Z
+date: 2013-07-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rautomation
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: 0.9.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: 0.9.3
 - !ruby/object:Gem::Dependency
   name: require_all
   requirement: !ruby/object:Gem::Requirement
@@ -59,6 +59,22 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: childprocess
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.9
 - !ruby/object:Gem::Dependency
   name: cucumber
   requirement: !ruby/object:Gem::Requirement
@@ -274,6 +290,7 @@ files:
 - features/support/screens/about_screen.rb
 - features/support/screens/data_entry_form.rb
 - features/support/screens/main_screen.rb
+- features/support/screens/screen_scoped_to_children.rb
 - features/support/screens/screen_with_container.rb
 - features/support/string.rb
 - features/table.feature
@@ -314,8 +331,10 @@ files:
 - spec/lib/mohawk_spec.rb
 - spec/lib/navigation_spec.rb
 - spec/spec_helper.rb
+- spec/table_stubber.rb
 homepage: http://github.com/leviwilson/mohawk
-licenses: []
+licenses:
+- MIT
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -393,6 +412,7 @@ test_files:
 - features/support/screens/about_screen.rb
 - features/support/screens/data_entry_form.rb
 - features/support/screens/main_screen.rb
+- features/support/screens/screen_scoped_to_children.rb
 - features/support/screens/screen_with_container.rb
 - features/support/string.rb
 - features/table.feature
@@ -414,4 +434,5 @@ test_files:
 - spec/lib/mohawk_spec.rb
 - spec/lib/navigation_spec.rb
 - spec/spec_helper.rb
+- spec/table_stubber.rb
 has_rdoc: