domkey 0.2.0 → 0.3.0

data/spec/select_list_spec.rb

@@ -0,0 +1,212 @@
+require 'spec_helper'
+
+describe Domkey::View::SelectList do
+
+  class SelectListExampleView
+
+    include Domkey::View
+
+    def multilist
+      SelectList.new -> { select_list(id: 'multiselect') }
+    end
+
+    def singlelist
+      SelectList.new -> { select_list(id: 'fruit_list') }
+    end
+
+  end
+
+  context "Multi" do
+
+    before :all do
+      view    = SelectListExampleView.new
+      @widget = view.multilist
+    end
+
+    before :each do
+      goto_html("test.html")
+    end
+
+    it 'initial value on the test page' do
+      @widget.value.should eql ["English", "Norwegian"]
+    end
+
+    it 'initial value by keys on the test page' do
+      # array
+      @widget.value([:index, :text, :value]).should eql [{:index=>1, :text=>"English", :value=>"2"}, {:index=>2, :text=>"Norwegian", :value=>"3"}]
+      # splat list
+      @widget.value(:index, :text).should eql [{:index=>1, :text=>"English"}, {:index=>2, :text=>"Norwegian"}]
+
+      # one element array
+      @widget.value([:index]).should eql [{:index=>1}, {:index=>2}]
+      # one elmenet splat list
+      @widget.value(:value).should eql [{:value=>"2"}, {:value=>"3"}]
+
+    end
+
+    it 'set string' do
+      @widget.set 'Polish'
+    end
+
+    it 'set array string or regexp' do
+      # texts are items visible to the user [text or label of select list option]
+      @widget.set ['Polish', 'Norwegian']
+      @widget.value.should eql ["Norwegian", "Polish"]
+    end
+
+    it 'set false clears all. value is empty array' do
+      @widget.set false
+      @widget.value.should eql []
+    end
+
+    it 'set empty array clears all. value is empty array' do
+      @widget.set []
+      @widget.value.should eql []
+    end
+
+    it 'set string clears all. sets one text item. value is one item' do
+      @widget.set 'Polish'
+      @widget.value.should eql ["Polish"]
+    end
+
+    it 'set string' do
+      @widget.set text: 'Polish'
+      @widget.value.should eql ["Polish"]
+    end
+
+    it 'set regexp' do
+      @widget.set text: /olish/
+      @widget.value.should eql ["Polish"]
+    end
+
+    it 'set by array of texts' do
+      @widget.set text: ['Polish', /orwegia/]
+      @widget.value.should eql ["Norwegian", "Polish"]
+    end
+
+    it 'set index by option position' do
+      @widget.set index: 1
+      @widget.value.should eql ['English']
+      @widget.value(:index, :value).should eql [{index: 1, value: '2'}]
+    end
+
+    it 'set index array of option positions' do
+      @widget.set index: [0, 2]
+      @widget.value.should eql ["Danish", "Norwegian"]
+    end
+
+    it 'set value attribute string' do
+      @widget.set value: '2'
+      @widget.value.should eql ['English']
+    end
+
+    it 'set value attribute array of strings' do
+      @widget.set value: ['2', '1']
+      @widget.value.should eql ["Danish", "English"]
+    end
+
+    it 'set by many qualifiers at once' do
+      @widget.set value: ['2', '1'],
+                  text:  'Swedish',
+                  index: 3
+      @widget.value.should eql ['Danish', 'English', 'Polish', 'Swedish']
+    end
+
+    it 'options' do
+      @widget.options.should eql [{:text=>"Danish", :value=>"1", :index=>0},
+                                  {:text=>"English", :value=>"2", :index=>1},
+                                  {:text=>"Norwegian", :value=>"3", :index=>2},
+                                  {:text=>"Polish", :value=>"", :index=>3},
+                                  {:text=>"Swedish", :value=>"Swedish", :index=>4}]
+    end
+
+    context "Single" do
+
+      before :all do
+        view    = SelectListExampleView.new
+        @widget = view.singlelist
+      end
+
+      before :each do
+        goto_html("test.html")
+      end
+
+      it 'initial value is text visible to the user' do
+        @widget.value.should eql ['Default']
+      end
+
+      it 'value keys' do
+        @widget.value([:index, :value, :text]).should eql [{index: 3, value: 'Default', text: 'Default'}]
+      end
+
+      it 'set string selects visible text. value is visible text to the user' do
+        @widget.set 'Tomato'
+        @widget.value.should eql ['Tomato']
+
+        @widget.set 'Other'
+        @widget.value.should eql ['Other']
+      end
+
+      it 'set array of text or label' do
+        @widget.set ['Other', 'Tomato'] #cycle on single select list
+        @widget.value.should eql ['Tomato'] # the last one set
+      end
+
+      it 'set by array of text' do
+        @widget.set text: ['Other', 'Tomato']
+        @widget.value.should eql ['Tomato']
+      end
+
+      it 'set false has no effect. value is selected item text' do
+        @widget.set false
+        @widget.value.should eql ['Default']
+      end
+
+      it 'set empty array has no effect. value is selected item text' do
+        @widget.set []
+        @widget.value.should eql ['Default']
+      end
+
+      it 'set index position' do
+        @widget.set index: 1
+        @widget.value.should eql ['Cucumber']
+      end
+
+      it 'set index array' do
+        @widget.set index: [0, 2]
+        @widget.value.should eql ['Other'] # the last one wins
+      end
+
+      it 'set value attribute string' do
+        @widget.set value: 'tomato'
+        @widget.value.should eql ['Tomato']
+      end
+
+      it 'set value attribute array of strings' do
+        @widget.set value: ['tomato', 'gurken']
+        @widget.value.should eql ['Cucumber']
+      end
+
+      it 'set by many qualifiers at once' do
+        @widget.set value: ['gurken'],
+                    text:  'Tomato',
+                    index: 2
+        @widget.value.should eql ['Other']
+      end
+
+      it 'options' do
+
+        expected = [{:text=>"Tomato", :value=>"tomato", :index=>0},
+                    {:text=>"Cucumber", :value=>"gurken", :index=>1},
+                    {:text=>"Other", :value=>"", :index=>2},
+                    {:text=>"Default", :value=>"Default", :index=>3}]
+
+        @widget.options.should eql(expected)
+
+      end
+
+    end
+
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: domkey
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - rubytester
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-02 00:00:00.000000000 Z
+date: 2014-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
@@ -107,26 +107,30 @@ files:
 - lib/domkey/view/checkbox_group.rb
 - lib/domkey/view/label_mapper.rb
 - lib/domkey/view/labeled_group.rb
+- lib/domkey/view/option_selectable.rb
+- lib/domkey/view/option_selectable_group.rb
 - lib/domkey/view/page_object.rb
 - lib/domkey/view/page_object_collection.rb
 - lib/domkey/view/radio_group.rb
-- lib/domkey/view/watir_widget.rb
-- lib/domkey/view/widgetry_package.rb
+- lib/domkey/view/select_list.rb
+- lib/domkey/view/widgetry/dispatcher.rb
+- lib/domkey/view/widgetry/package.rb
 - spec/browser_spec.rb
 - spec/checkbox_group_spec.rb
 - spec/html/test.html
 - spec/labeled_group_spec.rb
+- spec/option_selectable_spec.rb
 - spec/page_object_collection_spec.rb
 - spec/page_object_decorators_spec.rb
 - spec/page_object_spec.rb
 - spec/page_spec.rb
 - spec/radio_group_spec.rb
+- spec/select_list_spec.rb
 - spec/selenium_webdriver_api_example.rb
 - spec/spec_helper.rb
 - spec/view_cargo_spec.rb
 - spec/view_dom_spec.rb
 - spec/view_doms_spec.rb
-- spec/watir_widget_select_spec.rb
 - spec/watirspec_pageobjects/watirspec_spec.rb
 homepage: ''
 licenses:
@@ -157,15 +161,16 @@ test_files:
 - spec/checkbox_group_spec.rb
 - spec/html/test.html
 - spec/labeled_group_spec.rb
+- spec/option_selectable_spec.rb
 - spec/page_object_collection_spec.rb
 - spec/page_object_decorators_spec.rb
 - spec/page_object_spec.rb
 - spec/page_spec.rb
 - spec/radio_group_spec.rb
+- spec/select_list_spec.rb
 - spec/selenium_webdriver_api_example.rb
 - spec/spec_helper.rb
 - spec/view_cargo_spec.rb
 - spec/view_dom_spec.rb
 - spec/view_doms_spec.rb
-- spec/watir_widget_select_spec.rb
 - spec/watirspec_pageobjects/watirspec_spec.rb

data/lib/domkey/view/watir_widget.rb

@@ -1,106 +0,0 @@
-module Domkey
-
-  module View
-
-    # @api private
-    class WatirWidget
-
-      def initialize(object)
-        @object           = object
-        object_class_name = @object.class.name.split('::').last
-        @set_method       = "set_%s" % object_class_name
-        @value_method     = "value_%s" % object_class_name
-        @options_method   = "options_%s" % object_class_name
-      end
-
-      def set value
-        return __send__(@set_method, value) if respond_to?(@set_method, true)
-        @object.set value
-      end
-
-      def value
-        return __send__(@value_method) if respond_to?(@value_method, true)
-        @object.value
-      end
-
-      def options
-        return __send__(@options_method) if respond_to?(@options_method, true)
-        opts = @object.options
-        opts.count == 0 ? [] : opts
-      end
-
-      private
-
-      def options_Select
-        @object.options.map do |o|
-          {text:  o.text,
-           value: o.value}
-        end
-      end
-
-      # for Watir::Select
-      # @param [String] text or label to be selected. Text visible to the user on the page
-      # @param [Array<String>] collection for multiselect to select
-      def set_Select value
-        @object.clear if @object.multiple?
-        set_Select_strategy value
-      end
-
-      def set_Select_strategy value
-        case value
-        when String
-          @object.select value
-        when Array
-          value.each { |v| set_Select_strategy v }
-        when Hash
-          value.each_pair do |how, what|
-
-            #-- select by option position: can be one or many index: 0, index: [0,1,2,3]
-            if how == :index
-              case what
-              when Fixnum
-                @object.options[what].select
-              when Array
-                what.each do |i|
-                  @object.options[i].select
-                end
-              end
-            end
-
-            #-- select by option value: attribute (invisible to the user)
-            if how == :value
-              case what
-              when String
-                @object.select_value what
-              when Array
-                what.each { |v| @object.select_value v }
-              end
-            end
-
-            #-- select by text visible to the user. This is the same as default set 'Text' behavior
-            if how == :text
-              case what
-              when String
-                set_Select_strategy what
-              when Array
-                what.each { |v| set_Select_strategy v }
-              end
-            end
-
-          end
-
-        end
-
-      end
-
-      # @return [String] text or label from Select, not actual 'value' attribute?
-      # @return [Array<String>] collection for multiselect list
-      # @return [False] when nothing selected in multiselect list
-      def value_Select
-        @object.selected_options.map { |o| o.text }
-      end
-
-
-    end
-  end
-end

data/lib/domkey/view/widgetry_package.rb

@@ -1,48 +0,0 @@
-module Domkey
-
-  module View
-
-    module WidgetryPackage
-
-      attr_accessor :package, :container
-
-      # initialize PageObject or PageObjectCollection
-      # for PageObject expects WebdriverElement a single element definition i.e text_field, checkbox
-      # for PageObjectCollection expects WebdriverElement a collection definition i.e. text_fields, checkboxes
-      # @param package [Proc(WebdriverElement)]
-      # @param package [PageObject]
-      # @param package [Hash{Symbol => Proc(WebdriverElement)]
-      # @param package [Hash{Symbol => PageObject]
-      def initialize package, container=lambda { Domkey.browser }
-        @container = container
-        @package   = initialize_this package
-      end
-
-      # access widgetry of watir elements composing this page object
-      # @param [Symbol] (false)
-      # @return [Hash{Symbol => WebdriverElement}]
-      # @return [WebdriverElement]
-      def element(key=false)
-        return instantiator unless package.respond_to?(:each_pair)
-        return package.fetch(key).element if key
-        Hash[package.map { |key, package| [key, package.element] }]
-      end
-
-      private
-
-      # talks to the browser
-      # returns runtime element in a specified container
-      # @return [WebdriverElement]
-      def instantiator
-        container_instantiator.instance_exec(&package)
-      end
-
-      # talks to the browser
-      # returns runtime container element in a browser/driver
-      # @return [WebdriverElement]
-      def container_instantiator
-        container.respond_to?(:call) ? container.call : container.send(:instantiator)
-      end
-    end
-  end
-end

data/spec/watir_widget_select_spec.rb

@@ -1,176 +0,0 @@
-require 'spec_helper'
-
-describe Domkey::View::WatirWidget do
-
-  context Watir::Select do
-
-    context "Multi" do
-
-      before :all do
-        @object = Domkey.browser.select(id: 'multiselect')
-        @widget = Domkey::View::WatirWidget.new(@object)
-      end
-
-      before :each do
-        goto_html("test.html")
-      end
-
-      it 'initial value on the test page' do
-        @widget.value.should eql ["English", "Norwegian"]
-      end
-
-      it 'set array of strings clears all. sets text items provided. value is array of visible texts' do
-        # texts are items visible to the user [text or label of select list option]
-        @widget.set ['Polish', 'Norwegian']
-        @widget.value.should eql ["Norwegian", "Polish"]
-      end
-
-      it 'set false clears all. value is empty array' do
-        @widget.set false
-        @widget.value.should eql []
-      end
-
-      it 'set empty array clears all. value is empty array' do
-        @widget.set []
-        @widget.value.should eql []
-      end
-
-      it 'set string clears all. sets one text item. value is one item' do
-        @widget.set 'Polish'
-        @widget.value.should eql ["Polish"]
-      end
-
-      it 'set by text' do
-        @widget.set text: 'Polish'
-        @widget.value.should eql ["Polish"]
-      end
-
-      it 'set by array of texts' do
-        # client would not usually do this.
-        # Client would simply call set ['Polish', 'Norwegian']
-        # becuase text: qualifer is a default way of setting select list by visible text
-        @widget.set text: ['Polish', 'Norwegian']
-        @widget.value.should eql ["Norwegian", "Polish"]
-      end
-
-      it 'set index by option position' do
-        @widget.set index: 1
-        @widget.value.should eql ['English']
-      end
-
-      it 'set index array of option positions' do
-        @widget.set index: [0, 2]
-        @widget.value.should eql ["Danish", "Norwegian"]
-      end
-
-      it 'set value attribute string' do
-        @widget.set value: '2'
-        @widget.value.should eql ['English']
-      end
-
-      it 'set value attribute array of strings' do
-        @widget.set value: ['2', '1']
-        @widget.value.should eql ["Danish", "English"]
-      end
-
-      it 'set by many qualifiers at once' do
-        @widget.set value: ['2', '1'],
-                    text:  'Swedish',
-                    index: 3
-        @widget.value.should eql ['Danish', 'English', 'Polish', 'Swedish']
-      end
-
-      it 'options' do
-        @widget.options.should eql [{:text=>"Danish", :value=>"1"},
-                                    {:text=>"English", :value=>"2"},
-                                    {:text=>"Norwegian", :value=>"3"},
-                                    {:text=>"Polish", :value=>""},
-                                    {:text=>"Swedish", :value=>"Swedish"}]
-      end
-
-    end
-
-    context "Single" do
-
-      before :all do
-        object  = Domkey.browser.select(id: 'fruit_list')
-        @widget = Domkey::View::WatirWidget.new(object)
-      end
-
-      before :each do
-        goto_html("test.html")
-      end
-
-      it 'initial value on the test page visible text to the user' do
-        @widget.value.should eql ['Default']
-      end
-
-      it 'set string selects visible text. value is visible text to the user' do
-        # option text
-        @widget.set 'Tomato'
-        @widget.value.should eql ['Tomato'] # not value attribute, visible text [text, label]
-
-        # option label attribute text
-        @widget.set 'Other'
-        @widget.value.should eql ['Other']
-      end
-
-      it 'set array of text or label' do
-        @widget.set ['Other', 'Tomato'] #cycle on single select list
-        @widget.value.should eql ['Tomato'] # the last one set
-      end
-
-      it 'set by array of text' do
-        @widget.set text: ['Other', 'Tomato']
-        @widget.value.should eql ['Tomato']
-      end
-
-      it 'set false has no effect. value is selected item text' do
-        @widget.set false
-        @widget.value.should eql ['Default']
-      end
-
-      it 'set empty array has no effect. value is selected item text' do
-        @widget.set []
-        @widget.value.should eql ['Default']
-      end
-
-      it 'set index position' do
-        @widget.set index: 1
-        @widget.value.should eql ['Cucumber']
-      end
-
-      it 'set index array' do
-        @widget.set index: [0, 2]
-        @widget.value.should eql ['Other'] # the last one wins
-      end
-
-      it 'set value attribute string' do
-        @widget.set value: 'tomato'
-        @widget.value.should eql ['Tomato']
-      end
-
-      it 'set value attribute array of strings' do
-        @widget.set value: ['tomato', 'gurken']
-        @widget.value.should eql ['Cucumber']
-      end
-
-      it 'set by many qualifiers at once' do
-        @widget.set value: ['gurken'],
-                    text:  'Tomato',
-                    index: 2
-        @widget.value.should eql ['Other']
-      end
-
-      it 'options' do
-        @widget.options.should eql [{:text=>"Tomato", :value=>"tomato"},
-                                    {:text=>"Cucumber", :value=>"gurken"},
-                                    {:text=>"Other", :value=>""},
-                                    {:text=>"Default", :value=>"Default"}]
-      end
-
-    end
-
-  end
-
-end