mohawk 0.1.0 → 0.1.4

data/Changelog

@@ -1,3 +1,7 @@
+===	Version 0.1.4
+*	Enhancements
+	*	make it more explicit if you want to add a row to the selection
+
 ===	Version 0.1.0 / 2013-10-03
 *	Enhancments
 	*	added multi-select support to tables and select lists

data/README.md

@@ -51,6 +51,48 @@ on(LoginScreen) do |screen|
 end
 ```
 
+## Accessors
+### Window
+#### window
+The `window` accessor defines how to locate the top-level window that you would like to use for your screen. Valid locators are dictated by the [RAutomation::Window](https://github.com/jarmo/RAutomation/blob/master/lib/rautomation/adapter/ms_uia/window.rb) class.
+
+#### parent
+There are times where you need to define the root parent window for your screen, but it happens to be within a child window of a top-level window. The `parent` accessor allows you to specify further within `window`, and that will be used as the root of all other searches.
+
+### Controls
+Control accessors are used to define various controls within your page object. Valid locators are dictated by the [RAutomation::Control](https://github.com/jarmo/RAutomation/blob/master/lib/rautomation/adapter/ms_uia/control.rb) class.
+
+#### text
+The `text` accessor is used to define an edit text control within your screen. Given `text(:user_name, id: 'txtUserName')`, you will get the following methods:
+
+*  `:user_name` - gets the value
+*  `:user_name=` - sets the value
+*  `:clear_user_name` - clears the value
+*  `:enter_user_name` - types the given value (useful for masked text fields)
+*  `:user_name_view` - the raw RAutomation view
+
+#### button
+The `button` accessor is used to define a button control within your screen. Given `button(:ok, value: 'OK')`, you will get the following methods:
+
+*  `:ok` - clicks the button
+*  `:ok_value` - returns the text value of the button
+*  `:ok_view` - the raw RAutomation view
+
+#### combo_box
+##### aliases
+*  `:combobox`
+*  `:dropdown` / `:drop_down`
+*  `:select_list`
+
+The `combo_box` accessor is used to define a control that implements the `SelectList` pattern, such as a `ComboBox`, `ListBox`, etc. Given `combo_box(:city, id: 'cbCities')`, you will get the following methods:
+
+*  `:city` - returns the currently selected item
+*  `:clear_city` - clears the item by either index, value or `RegEx`
+*  `:city_selections` - returns the currently selected options
+*  `:city=` / `:select_city` - sets the selected item by index, value or `RegEx`
+*  `:city_options` - returns the list of available options
+*  `:city_view` - the raw RAutomation view
+
 ## Contributing
 
 1. Fork it

data/features/step_definitions/table_steps.rb

@@ -20,7 +20,7 @@ end
 When(/^we add rows "([^"]*)" to the selection$/) do |which_rows|
   on(DataEntryForm) do |screen|
     which_rows.split(', ').map(&:to_i).each do |row|
-      screen.people = row
+      screen.add_people row
     end
   end
 end

data/lib/mohawk/accessors/table.rb

@@ -13,6 +13,14 @@ module Mohawk
         find_row_with(which_item).select
       end
 
+      def add(which_item)
+        find_row_with(which_item).add_to_selection
+      end
+
+      def clear_all
+        view.selected_rows.each(&:clear)
+      end
+
       def clear(which_item)
         find_row_with(which_item).clear
       end
@@ -50,7 +58,7 @@ module Mohawk
       end
 
       def find_by_value(which_item)
-        view.row(text: which_item)
+        find { |r| r.row.value == which_item }
       end
 
       def find_by_hash(row_info)

data/lib/mohawk/accessors/table_row.rb

@@ -15,6 +15,11 @@ module Mohawk
       end
 
       def select
+        UiaDll::table_single_select(@table.view.search_information, row.row)
+        self
+      end
+
+      def add_to_selection
         row.select
         self
       end

data/lib/mohawk/accessors.rb

@@ -250,6 +250,9 @@ module Mohawk
       define_method("#{name}=") do |which_item|
         adapter.table(locator).select which_item
       end
+      define_method("add_#{name}") do |hash_info|
+        adapter.table(locator).add hash_info
+      end
       define_method("select_#{name}") do |hash_info|
         adapter.table(locator).select hash_info
       end

data/lib/mohawk/version.rb

@@ -1,3 +1,3 @@
 module Mohawk
-  VERSION = "0.1.0"
+  VERSION = "0.1.4"
 end

data/mohawk.gemspec

@@ -18,10 +18,11 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
 
-  gem.add_dependency 'rautomation', '~> 0.13'
+  gem.add_dependency 'rautomation', '~> 0.14'
   gem.add_dependency 'require_all'
   gem.add_dependency 'page_navigation', '>= 0.7'
   gem.add_dependency 'childprocess', '~> 0.3.9'
+  gem.add_dependency 'ffi', '1.9.0'
 
   gem.add_development_dependency 'cucumber'
   gem.add_development_dependency 'rspec', '>= 2.12.0'

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

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe Mohawk::Accessors::TableRow do
+  let(:table) { double('RAutomation Table') }
+  let(:adapter) { double('mohawk adapter') }
+  let(:mohawk_table) { Mohawk::Accessors::Table.new(adapter, value: 'whatever') }
+  let(:stubber) do
+    TableStubber.stub(table)
+    .with_headers('Name', 'Age')
+    .and_row('Levi', '33')
+  end
+
+  subject { Mohawk::Accessors::TableRow.new(mohawk_table, 0) }
+
+  before(:each) do
+    adapter.stub_chain(:window, :table).and_return(table)
+  end
+
+  it '#add_to_selection' do
+    stubber.rows[0].should_receive(:select)
+    subject.add_to_selection
+  end
+
+  it '#select' do
+    stubber.should_singly_select_row(0)
+    subject.select
+  end
+end

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

@@ -32,17 +32,18 @@ describe Mohawk::Accessors::Table do
       stubber = TableStubber.stub(table)
         .with_headers('Name')
         .and_row('First Person')
-        .and_row('Secont Person')
+        .and_row('Second Person')
 
-      stubber.rows[1].should_receive(:select)
+      stubber.should_singly_select_row 1
       screen.top = 1
     end
 
     it 'can select a row by value' do
-      row = double('row')
-      table.should_receive(:row).with(text: 'John Elway').and_return(row)
-      row.should_receive(:select)
+      stubber = TableStubber.stub(table)
+        .with_headers('Name')
+        .and_row('John Elway')
 
+      stubber.should_singly_select_row 0
       screen.top = 'John Elway'
     end
 
@@ -55,10 +56,10 @@ describe Mohawk::Accessors::Table do
     end
 
     it 'can clear a row by value' do
-      row = double('row')
-      table.should_receive(:row).with(text: 'John Elway').and_return(row)
-      row.should_receive(:clear)
+      stubber = TableStubber.stub(table)
+      .with_headers('Name').and_row('John Elway')
 
+      stubber.rows[0].should_receive(:clear)
       screen.clear_top('John Elway')
     end
 
@@ -102,12 +103,22 @@ describe Mohawk::Accessors::Table do
     end
 
     context 'selecting a row by hash' do
+      it 'singly selects the row' do
+        stubber = TableStubber.stub(table)
+        .with_headers('name', 'age')
+        .and_row('Levi', '33')
+        .and_row('John', '54')
+
+        stubber.should_singly_select_row(1)
+        screen.select_top(:age => 54)
+      end
+
       it 'returns the row that it selected' do
         stubber = TableStubber.stub(table)
         .with_headers('name', 'age')
         .and_row('Levi', '33')
 
-        stubber.rows[0].should_receive(:select)
+        stubber.should_singly_select_row(0)
         screen.select_top(:age => 33).name.should eq('Levi')
       end
 
@@ -118,7 +129,7 @@ describe Mohawk::Accessors::Table do
 
         Mohawk::Accessors::Table.any_instance.should_receive(:find_row_with).with(:age => 33).and_call_original
 
-        stubber.rows[0].should_receive(:select)
+        stubber.should_singly_select_row(0)
         screen.select_top :age => 33
       end
     end
@@ -145,6 +156,27 @@ describe Mohawk::Accessors::Table do
       end
     end
 
+    context 'adding a row to the selection' do
+      let(:stubber) do
+        TableStubber.stub(table)
+          .with_headers('name')
+          .and_row('Levi')
+          .and_row('John')
+      end
+
+      it 'returns the row that is added' do
+        stubber.rows[1].should_receive(:select)
+        screen.add_top(name: 'John').name.should eq('John')
+      end
+
+      it 'uses the find_row semantics' do
+        Mohawk::Accessors::Table.any_instance.should_receive(:find_row_with).with(name: 'Levi').and_call_original
+
+        stubber.rows[0].should_receive(:select)
+        screen.add_top name: 'Levi'
+      end
+    end
+
     it 'has rows' do
       TableStubber.stub(table)
         .with_headers('Column')
@@ -179,7 +211,7 @@ describe Mohawk::Accessors::Table do
       end
 
       it 'can be selected' do
-        table_stubber.rows[0].should_receive(:select)
+        table_stubber.should_singly_select_row(0)
         screen.top[0].select
       end
 

data/spec/table_stubber.rb

@@ -1,7 +1,7 @@
 require 'securerandom'
 
 class TableStubber
-  include RSpec::Mocks::ExampleMethods
+  include RSpec::Mocks::ExampleMethods, RAutomation::Adapter::MsUia
 
   attr_reader :table, :rows
 
@@ -9,6 +9,7 @@ class TableStubber
     @table = table
     @id = SecureRandom.base64
     @table.stub(:search_information).and_return(@id)
+    @table.stub(:selected_rows).and_return []
     @rows = []
   end
 
@@ -26,6 +27,10 @@ class TableStubber
     self
   end
 
+  def should_singly_select_row(which)
+    UiaDll.should_receive(:table_single_select).with(@id, which)
+  end
+
   private
   def add_row
     row = double("table #{@id}, row #{rows.count}")
@@ -44,6 +49,7 @@ class TableStubber
       cell.stub(:text).and_return(value)
       cells << cell
     end
+    row.stub(:value).and_return(values.first)
     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.1.0
+  version: 0.1.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-03 00:00:00.000000000 Z
+date: 2014-02-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rautomation
@@ -18,7 +18,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '0.14'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '0.14'
 - !ruby/object:Gem::Dependency
   name: require_all
   requirement: !ruby/object:Gem::Requirement
@@ -75,6 +75,22 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.3.9
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.9.0
 - !ruby/object:Gem::Dependency
   name: cucumber
   requirement: !ruby/object:Gem::Requirement
@@ -335,6 +351,7 @@ files:
 - spec/lib/mohawk/accessors/menu_spec.rb
 - spec/lib/mohawk/accessors/radio_spec.rb
 - spec/lib/mohawk/accessors/spinner_spec.rb
+- spec/lib/mohawk/accessors/table_row_spec.rb
 - spec/lib/mohawk/accessors/table_spec.rb
 - spec/lib/mohawk/accessors/tabs_spec.rb
 - spec/lib/mohawk/accessors/text_spec.rb
@@ -445,6 +462,7 @@ test_files:
 - spec/lib/mohawk/accessors/menu_spec.rb
 - spec/lib/mohawk/accessors/radio_spec.rb
 - spec/lib/mohawk/accessors/spinner_spec.rb
+- spec/lib/mohawk/accessors/table_row_spec.rb
 - spec/lib/mohawk/accessors/table_spec.rb
 - spec/lib/mohawk/accessors/tabs_spec.rb
 - spec/lib/mohawk/accessors/text_spec.rb