domkey 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0468e0993e03c228863792b2979fc0518aea17db
-  data.tar.gz: d36475ac117f17891905d01328dadca7bc08fe90
+  metadata.gz: e93f5beddbdb0fad6ae8e499a06a46dc177c23b3
+  data.tar.gz: 4a77a3c0434d61e3ce656babba4abfdfe2eb9853
 SHA512:
-  metadata.gz: ef11d67c2261cc2e7f4228bbe1f2466a1d82f4ebb8eedd895850c9e48d109080506ae91f6a40055184308e04f24395aedc5c81d0f48d5d7ba866d23b78a4e45d
-  data.tar.gz: 5b613799843aedb4959c422fe4dfcf91c28740903c78e4e86dc4b40e971ff803a77567df785e066ae702069bcc5becdb56246c98a7feba1012bc0e96b8cf49e4
+  metadata.gz: 3cc26e517caf10802fc411947b2de31ea5dc2ca06d6b4467fd8a4a81bc5f21ce7443f5dc17baac0836a84a193f630f028fae9375b550837660d6c5fe490ca1ab
+  data.tar.gz: 88deffe102eb2fa60e364cf7a59bdbd07b81997a54dda072d56653702f757909622fe77c9e3ffe55f8194136f18d915899fac384988fb019fa62e392a2b3ac41

data/lib/domkey/version.rb

@@ -1,3 +1,3 @@
 module Domkey
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

data/lib/domkey/view.rb

@@ -3,7 +3,7 @@ require 'domkey/view/page_object_collection'
 require 'domkey/view/radio_group'
 require 'domkey/view/checkbox_group'
 require 'domkey/view/select_list'
-require 'domkey/view/cargo'
+require 'domkey/view/binder'
 
 module Domkey
 
@@ -25,10 +25,10 @@ module Domkey
         end
       end
 
-      # build Cargo with model and view
-      # @return [Domkey::View::Cargo]
-      def cargo model, browser: nil
-        Cargo.new model: model, view: self.new(browser)
+      # build Binder with model and view
+      # @return [Domkey::View::Binder]
+      def binder model, browser: nil
+        Binder.new model: model, view: self.new(browser)
       end
 
     end
@@ -52,7 +52,7 @@ module Domkey
     end
 
     def set value
-      Cargo.new(model: value, view: self).set
+      Binder.new(model: value, view: self).set
     end
 
     # @param [Hash{Symbol => Object}] view data where Symbol is semantic descriptor for a pageobject in the view
@@ -71,7 +71,7 @@ module Domkey
               when Hash
                 value
               end
-      Cargo.new(model: value, view: self).value
+      Binder.new(model: value, view: self).value
     end
 
   end

data/lib/domkey/view/{cargo.rb → binder.rb}

@@ -2,11 +2,11 @@ module Domkey
 
   module View
 
-    # Data shipping between Model and View
+    # Data transfer facilitator for the view
     # Sends data to view. Grabs data from view
-    #
-    # For specialized transfer object a client would sublcass this Cargo,
-    # by default View.cargo factory method is provided for regular data transfer object
+    # Data is a model of the view
+    # For specialized transfer object a client would sublcass this Binder,
+    # by default View.binder factory method is provided for regular data transfer object
     #
     # @usage
     #
@@ -20,21 +20,21 @@ module Domkey
     #        end
     #      end
     #
-    #      model      = {city: 'Austin', fruit: 'tomato'}
-    #      cargo = MyView.cargo model
-    #      cargo.set #=> sets view.city with model[:city] and view.fruit with model[:fruit]
-    #      cargo.value #=> returns {city: 'Austing', fruit: 'tomato'}
+    #      model  = {city: 'Austin', fruit: 'tomato'}
+    #      binder = MyView.binder model
+    #      binder.set #=> sets view.city with model[:city] and view.fruit with view_model[:fruit]
+    #      binder.value #=> returns {city: 'Austing', fruit: 'tomato'}
     #
-    #      class MyCargo < Domkey::View::Cargo
+    #      class MyBinder < Domkey::View::Binder
     #
     #      end
     #
     #      model = {city: 'Mordor'}
     #      view  = MyView.new
-    #      cargo = MyCargo.new view: view, model: model
-    #      cargo.set
+    #      binder = MyBinder.new view: view, model: model
+    #      binder.set
     #
-    class Cargo
+    class Binder
 
       attr_accessor :view, :model
 

data/lib/domkey/view/option_selectable.rb

@@ -4,7 +4,7 @@ module Domkey
 
       # clears all options and sets only the desired value(s)
       # @param [String, Regexp] sets default designated option by String or Regexp
-      # @param [Array<String, Regexp>] sets each String, Regexp
+      # @param [Array<String, Regexp>] set more than one option by default strategy
       # @param [False] unselects all options
       # @param [Hash{how => value}] selects by how strategy where how is a symbol :label, :index, :text, :value
       # Clients need to implement individual strategy for each 'how' => 'value' pair based on what it means to be selected by what
@@ -13,17 +13,17 @@ module Domkey
         set_strategy value
       end
 
-      # @param [] opts. Represents a qualifier of what types of options to return. defaults to empty
-      # @return [Array<String>] when opts param emtpy returns array of default strings implemented by client
-      # @param [Symbol,Array<Symbol>] symbols represents what option selector to return
-      # @return [Array<Hash{what => value}] where what is a symbol for option selector, :index, :value, :text, :label
+      # @param opts [Symbol, Array<Symbol>] defaults to empty []. Represents a qualifier how to present selected options.
+      # @return [Array<String>] When opts param empty? array of default strings implemented by client as a presentation of options selected
+      # @param opts [Symbol,Array<Symbol>] ask for representation of options by 'what'
+      # @return [Array<Hash{what => value}] Whe opts is a list of symbols :index, :value, :text, :label corresponding to 'what' key
       def value *opts
         opts = opts.flatten
         return value_by_default if (opts.empty? || opts.find { |e| e.kind_of?(String) })
         value_by_options opts
       end
 
-      # similar strategy to value but returns all options and not only selected ones
+      # @see +value+ returns all options and not only selected ones
       def options *opts
         opts = opts.flatten
         return options_by_default if opts.empty?
@@ -55,19 +55,15 @@ module Domkey
       # strategy for selecting OptionSelectable object
       def set_strategy value
         case value
-        when String
-          set_by_string(value)
-        when Regexp
-          set_by_regexp(value)
+        when String, Regexp
+          set_by_value(value)
         when Array
           value.each { |v| set_strategy(v) }
         when Hash
           value.each_pair do |how, value|
             case how
-            when :label
+            when :label, :text
               set_by_label(value)
-            when :text
-              set_strategy(value)
             when :index
               set_by_index(value)
             when :value
@@ -77,26 +73,21 @@ module Domkey
         end
       end
 
-      def set_by_string value
-        fail Exception::NotImplementedError, "Subclass responsible for implementing"
-      end
-
-      def set_by_regexp value
+      # default strategy. set by value attribute
+      def set_by_value value
         fail Exception::NotImplementedError, "Subclass responsible for implementing"
       end
 
+      # by visible text, label of the control
       def set_by_label value
         fail Exception::NotImplementedError, "Subclass responsible for implementing"
       end
 
+      # set by position in an index of options
       def set_by_index value
         fail Exception::NotImplementedError, "Subclass responsible for implementing"
       end
 
-      def set_by_value value
-        fail Exception::NotImplementedError, "Subclass responsible for implementing"
-      end
-
     end
   end
 end

data/lib/domkey/view/option_selectable_group.rb

@@ -10,26 +10,25 @@ module Domkey
       include OptionSelectable
 
       def set_by_index value
-        [*value].each do |i|
-          self[i.to_i].set(true)
-        end
+        [*value].each { |i| self[i.to_i].set(true) }
       end
 
       def set_by_label value
         to_labeled.__send__(:set_strategy, value)
       end
 
-      def set_by_regexp value
-        o = find { |o| o.value.match(value) }
-        o ? o.element.set : fail(Exception::NotFoundError, "Element not found with value: #{v.inspect}")
-      end
-
-      def set_by_string value
-        o = find { |o| o.value == value }
+      def set_by_value value
+        o = case value
+            when String
+              find { |o| o.value == value }
+            when Regexp
+              find { |o| o.value.match(value) }
+            else
+              false
+            end
         o ? o.element.set : fail(Exception::NotFoundError, "Element not found with value: #{v.inspect}")
       end
 
-
       def value_by_default
         validate_scope
         find_all { |e| e.element.set? }.map { |e| e.value }

data/lib/domkey/view/page_object.rb

@@ -77,6 +77,23 @@ module Domkey
         Hash[package.map { |key, pageobject| [key, pageobject.options] }]
       end
 
+
+      # @api private
+      # delegate to element when element responds to message
+      def method_missing(message, *args, &block)
+        if respond_to_missing?(message, false)
+          element.__send__(message, *args, &block)
+        else
+          super
+        end
+      end
+
+      # @api private
+      # ruturn true when element.respond_to? message so we can delegate with confidence
+      def respond_to_missing?(message, include_private = false)
+        element.respond_to?(message) ? true : false
+      end
+
       private
 
       # wrap instantiator with strategy for setting and getting value for underlying object

data/lib/domkey/view/select_list.rb

@@ -7,32 +7,19 @@ module Domkey
 
       include OptionSelectable
 
-      def set_by_string value
-        element.select value
-      end
-
-      def set_by_regexp value
-        element.select value
-      end
-
+      # by position in options array
       def set_by_index value
-        case value
-        when Fixnum
-          element.options[value].select
-        when Array
-          value.each do |i|
-            element.options[i].select
-          end
-        end
+        [*value].each { |i| element.options[i].select }
       end
 
+      # by value attribute of the option
       def set_by_value value
-        case value
-        when String
-          element.select_value value
-        when Array
-          value.each { |v| element.select_value v }
-        end
+        [*value].each { |v| element.select_value(v) }
+      end
+
+      # by visible text for the option (visible to the user)
+      def set_by_label value
+        [*value].each { |v| element.select(v) }
       end
 
       def value_by_options opts
@@ -42,21 +29,20 @@ module Domkey
       end
 
       def value_by_default
-        element.selected_options.map { |e| e.text }
+        element.selected_options.map { |e| e.value }
+      end
+
+      def options_by_default
+        element.options.map { |e| e.value }
       end
 
-      # iffy
-      def options
+      def options_by opts
         element.options.map do |o|
-          {text:  o.text,
-           value: o.value,
-           index: o.index}
+          Hash[opts.map { |opt| [opt, o.send(opt)] }]
         end
       end
 
 
-      private
-
       def before_set
         element.clear if element.multiple?
       end

data/spec/{view_cargo_spec.rb → binder_spec.rb}

@@ -1,6 +1,6 @@
 require 'spec_helper'
 
-describe Domkey::View::Cargo do
+describe Domkey::View::Binder do
 
   class AddressView
     include Domkey::View
@@ -43,9 +43,9 @@ describe Domkey::View::Cargo do
     model = {city:   'Austin',
              street: 'Lamar'}
 
-    cargo = Domkey::View::Cargo.new model: model, view: AddressView.new
-    cargo.set
-    extracted = cargo.value
+    binder = Domkey::View::Binder.new model: model, view: AddressView.new
+    binder.set
+    extracted = binder.value
     extracted.should eql model
   end
 
@@ -56,9 +56,9 @@ describe Domkey::View::Cargo do
                         street: 'Austin'}
     }
 
-    cargo = Domkey::View::Cargo.new model: model, view: AddressView.new
-    cargo.set
-    extracted = cargo.value
+    binder = Domkey::View::Binder.new model: model, view: AddressView.new
+    binder.set
+    extracted = binder.value
     extracted.should eql model
   end
 
@@ -71,19 +71,19 @@ describe Domkey::View::Cargo do
                         delivery_date: {month: 'delivery thing'}}
     }
 
-    cargo = Domkey::View::Cargo.new model: model, view: AddressView.new
-    cargo.set
-    extracted = cargo.value
+    binder = Domkey::View::Binder.new model: model, view: AddressView.new
+    binder.set
+    extracted = binder.value
     extracted.should eql model
   end
 
-  it 'cargo' do
+  it 'binder' do
     model = {city: 'Mordor'}
 
     view  = AddressView.new
-    cargo = Domkey::View::Cargo.new view: view, model: model
-    cargo.set
-    scraped_model = cargo.value
+    binder = Domkey::View::Binder.new view: view, model: model
+    binder.set
+    scraped_model = binder.value
 
     scraped_model.should eql model
   end
@@ -91,14 +91,14 @@ describe Domkey::View::Cargo do
   it 'pageobject' do
 
     model               = {city: 'Austin', fruit: ['tomato', 'other']}
-    cargo               = AddressView.cargo model
+    binder               = AddressView.binder model
 
     # default values when page loads before setting the values
     default_page_values = {:city=>"id city class city", :fruit=>["other"]}
-    cargo.value.should eql default_page_values
-    cargo.set
+    binder.value.should eql default_page_values
+    binder.set
 
-    extracted_model = cargo.value
+    extracted_model = binder.value
     extracted_model.should eql model
 
   end

data/spec/option_selectable_spec.rb

@@ -10,48 +10,106 @@ describe Domkey::View::OptionSelectable do
     @widget = OptionSelectableFaker.new
   end
 
-  it 'set string' do
-    expect { @widget.set('fake') }.to raise_error(Domkey::Exception::NotImplementedError)
-  end
+  context 'set' do
+
+    it 'set string' do
+      expect(@widget).to receive(:set_by_value)
+      @widget.set('fake')
+    end
+
+    it 'set regex' do
+      expect(@widget).to receive(:set_by_value)
+      @widget.set(/fake/)
+    end
+
+    it 'set :value' do
+      expect(@widget).to receive(:set_by_value)
+      @widget.set(:value => 'fake')
+    end
+
+    it 'set :label' do
+      expect(@widget).to receive(:set_by_label)
+      @widget.set(:label => 'fake')
+    end
+
+    it 'set :text' do
+      expect(@widget).to receive(:set_by_label)
+      @widget.set(:text => 'fake')
+    end
+
+    it 'set :index' do
+      expect(@widget).to receive(:set_by_index)
+      @widget.set(:index => 3)
+    end
+
+    it 'string' do
+      expect { @widget.set('fake') }.to raise_error(Domkey::Exception::NotImplementedError)
+    end
+
+    it 'regex' do
+      expect { @widget.set(/fake/) }.to raise_error(Domkey::Exception::NotImplementedError)
+    end
+
+    it ':label' do
+      expect { @widget.set(:label => 'fake') }.to raise_error(Domkey::Exception::NotImplementedError)
+    end
+
+    it ':text' do
+      expect { @widget.set(:text => 'fake') }.to raise_error(Domkey::Exception::NotImplementedError)
+    end
+
+    it ':index' do
+      expect { @widget.set(:index => 3) }.to raise_error(Domkey::Exception::NotImplementedError)
+    end
+
+    it ':value' do
+      expect { @widget.set(:value => 'fake') }.to raise_error(Domkey::Exception::NotImplementedError)
+    end
 
-  it 'set regex' do
-    expect { @widget.set(/fake/) }.to raise_error(Domkey::Exception::NotImplementedError)
   end
 
-  it 'set :label' do
-    expect { @widget.set(:label => 'fake') }.to raise_error(Domkey::Exception::NotImplementedError)
-  end
+  context 'value' do
 
-  it 'set :text' do
-    expect { @widget.set(:text => 'fake') }.to raise_error(Domkey::Exception::NotImplementedError)
-  end
+    it 'value default' do
+      expect(@widget).to receive(:value_by_default)
+      @widget.value
+    end
 
-  it 'set :index' do
-    expect { @widget.set(:index => 3) }.to raise_error(Domkey::Exception::NotImplementedError)
-  end
+    it 'value option' do
+      expect(@widget).to receive(:value_by_options)
+      @widget.value(:foo)
+    end
 
-  it 'set :value' do
-    expect { @widget.set(:value => 'fake') }.to raise_error(Domkey::Exception::NotImplementedError)
-  end
+    it 'default' do
+      expect { @widget.value }.to raise_error(Domkey::Exception::NotImplementedError)
+    end
 
-  it 'value default' do
-    expect { @widget.value }.to raise_error(Domkey::Exception::NotImplementedError)
-  end
+    it 'option' do
+      expect { @widget.value(:foo) }.to raise_error(Domkey::Exception::NotImplementedError)
+    end
 
-  it 'value option' do
-    expect { @widget.value(:foo) }.to raise_error(Domkey::Exception::NotImplementedError)
-  end
 
-  it 'options default' do
-    expect { @widget.options }.to raise_error(Domkey::Exception::NotImplementedError)
   end
 
-  it 'options opt' do
-    expect { @widget.options(:foo) }.to raise_error(Domkey::Exception::NotImplementedError)
-  end
+  context 'options' do
 
-end
+    it 'options default' do
+      expect(@widget).to receive(:options_by_default)
+      @widget.options
+    end
 
+    it 'options opt' do
+      expect(@widget).to receive(:options_by)
+      @widget.options(:foo)
+    end
 
+    it 'default' do
+      expect { @widget.options }.to raise_error(Domkey::Exception::NotImplementedError)
+    end
 
+    it 'opts' do
+      expect { @widget.options(:foo) }.to raise_error(Domkey::Exception::NotImplementedError)
+    end
 
+  end
+end

data/spec/page_object_delegates_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+# methods each pageobject should have
+# set value options elements
+
+describe Domkey::View::PageObject do
+
+  before :all do
+    goto_html("test.html")
+  end
+
+  context 'delegate to element for missing methods' do
+    before :all do
+      @o = Domkey::View::PageObject.new -> { text_field(id: 'city1') }
+    end
+
+    it 'should delegate to element when element responds' do
+      @o.should respond_to(:id)
+      @o.id.should eql 'city1'
+
+      @o.should respond_to(:click)
+      @o.click
+    end
+
+    it 'should not delegate to element when element does not repsond' do
+      @o.should_not respond_to(:textaramabada)
+      expect { @o.textaramabada }.to raise_error(NoMethodError)
+    end
+  end
+end

data/spec/select_list_spec.rb

@@ -28,14 +28,14 @@ describe Domkey::View::SelectList do
     end
 
     it 'initial value on the test page' do
-      @widget.value.should eql ["English", "Norwegian"]
+      @widget.value.should eql ["2", "3"]
     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"}]
+      @widget.value(:index, :label).should eql [{:index=>1, :label=>"English"}, {:index=>2, :label=>"Norwegian"}]
 
       # one element array
       @widget.value([:index]).should eql [{:index=>1}, {:index=>2}]
@@ -44,14 +44,14 @@ describe Domkey::View::SelectList do
 
     end
 
-    it 'set string' do
-      @widget.set 'Polish'
+    it 'set value string' do
+      @widget.set '1'
+      @widget.value.should eql ['1']
     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"]
+    it 'set value array string' do
+      @widget.set ['1', '3']
+      @widget.value.should eql ['1', '3']
     end
 
     it 'set false clears all. value is empty array' do
@@ -64,149 +64,158 @@ describe Domkey::View::SelectList do
       @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"]
+      @widget.value.should eql [""] #option has no value attribute defined
     end
 
     it 'set regexp' do
-      @widget.set text: /olish/
-      @widget.value.should eql ["Polish"]
+      @widget.set /2/
+      @widget.value.should eql ["2"]
     end
 
     it 'set by array of texts' do
       @widget.set text: ['Polish', /orwegia/]
-      @widget.value.should eql ["Norwegian", "Polish"]
+      @widget.value.should eql ["3", ""]
     end
 
     it 'set index by option position' do
       @widget.set index: 1
-      @widget.value.should eql ['English']
+      @widget.value.should eql ['2']
       @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"]
+      @widget.value.should eql ["1", "3"]
     end
 
     it 'set value attribute string' do
       @widget.set value: '2'
-      @widget.value.should eql ['English']
+      @widget.value.should eql ['2']
     end
 
     it 'set value attribute array of strings' do
       @widget.set value: ['2', '1']
-      @widget.value.should eql ["Danish", "English"]
+      @widget.value.should eql ["1", "2"]
     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']
+      @widget.value.should eql ["1", "2", "", "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}]
+    it 'options by default' do
+      @widget.options.should eql ["1", "2", "3", "", "Swedish"]
     end
 
-    context "Single" do
+    it 'options by opts' do
 
-      before :all do
-        view    = SelectListExampleView.new
-        @widget = view.singlelist
-      end
+      expected = [{: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}]
 
-      before :each do
-        goto_html("test.html")
-      end
+      @widget.options(:text, :value, :index).should eql expected
+
+    end
+  end
+
+  context "Single" do
+
+    before :all do
+      view    = SelectListExampleView.new
+      @widget = view.singlelist
+    end
 
-      it 'initial value is text visible to the user' do
-        @widget.value.should eql ['Default']
-      end
+    before :each do
+      goto_html("test.html")
+    end
 
-      it 'value keys' do
-        @widget.value([:index, :value, :text]).should eql [{index: 3, value: 'Default', text: 'Default'}]
-      end
+    it 'initial value' do
+      @widget.value.should eql ['Default']
+    end
 
-      it 'set string selects visible text. value is visible text to the user' do
-        @widget.set 'Tomato'
-        @widget.value.should eql ['Tomato']
+    it 'value keys' do
+      @widget.value([:index, :value, :text]).should eql [{index: 3, value: 'Default', text: 'Default'}]
+    end
 
-        @widget.set 'Other'
-        @widget.value.should eql ['Other']
-      end
+    it 'set string selects value' do
+      @widget.set 'tomato'
+      @widget.value.should eql ['tomato']
 
-      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
+      @widget.set 'gurken'
+      @widget.value.should eql ['gurken']
+    end
 
-      it 'set by array of text' do
-        @widget.set text: ['Other', 'Tomato']
-        @widget.value.should eql ['Tomato']
-      end
+    it 'set when value not present should error' do
+      expect { @widget.set '' }.to raise_error(Watir::Exception::NoValueFoundException)
+      @widget.value.should eql ['Default'] #interesting quirk
+    end
 
-      it 'set false has no effect. value is selected item text' do
-        @widget.set false
-        @widget.value.should eql ['Default']
-      end
+    it 'set array of text' do
+      @widget.set ['gurken', 'tomato'] #cycle on single select list
+      @widget.value.should eql ['tomato'] # the last one set
+    end
 
-      it 'set empty array has no effect. value is selected item text' do
-        @widget.set []
-        @widget.value.should eql ['Default']
-      end
+    it 'set by array of text' do
+      @widget.set text: ['Other', 'Tomato']
+      @widget.value.should eql ['tomato']
+    end
 
-      it 'set index position' do
-        @widget.set index: 1
-        @widget.value.should eql ['Cucumber']
-      end
+    it 'set false has no effect. value is selected item text' do
+      @widget.set false
+      @widget.value.should eql ['Default']
+    end
 
-      it 'set index array' do
-        @widget.set index: [0, 2]
-        @widget.value.should eql ['Other'] # the last one wins
-      end
+    it 'set empty array has no effect. value is selected item text' do
+      @widget.set []
+      @widget.value.should eql ['Default']
+    end
 
-      it 'set value attribute string' do
-        @widget.set value: 'tomato'
-        @widget.value.should eql ['Tomato']
-      end
+    it 'set index position' do
+      @widget.set index: 1
+      @widget.value.should eql ['gurken']
+    end
 
-      it 'set value attribute array of strings' do
-        @widget.set value: ['tomato', 'gurken']
-        @widget.value.should eql ['Cucumber']
-      end
+    it 'set index array' do
+      @widget.set index: [2, 1]
+      @widget.value.should eql ['gurken'] # the last one wins
+    end
 
-      it 'set by many qualifiers at once' do
-        @widget.set value: ['gurken'],
-                    text:  'Tomato',
-                    index: 2
-        @widget.value.should eql ['Other']
-      end
+    it 'set value attribute string' do
+      @widget.set value: 'tomato'
+      @widget.value.should eql ['tomato']
+    end
 
-      it 'options' do
+    it 'set value attribute array of strings' do
+      @widget.set value: ['tomato', 'gurken']
+      @widget.value.should eql ['gurken']
+    end
 
-        expected = [{:text=>"Tomato", :value=>"tomato", :index=>0},
-                    {:text=>"Cucumber", :value=>"gurken", :index=>1},
-                    {:text=>"Other", :value=>"", :index=>2},
-                    {:text=>"Default", :value=>"Default", :index=>3}]
+    it 'set by many qualifiers at once' do
+      @widget.set value: ['gurken'],
+                  text:  'Tomato',
+                  index: 2
+      @widget.value.should eql ['']
+    end
 
-        @widget.options.should eql(expected)
+    it 'options default' do
 
-      end
+      @widget.options.should eql ['tomato', 'gurken', '', 'Default']
 
     end
 
-  end
+    it 'options by specifiers' 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}]
 
-end
+      @widget.options(:text, :value, :index).should eql expected
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: domkey
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - rubytester
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-06 00:00:00.000000000 Z
+date: 2014-04-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
@@ -103,7 +103,7 @@ files:
 - lib/domkey/exception.rb
 - lib/domkey/version.rb
 - lib/domkey/view.rb
-- lib/domkey/view/cargo.rb
+- lib/domkey/view/binder.rb
 - lib/domkey/view/checkbox_group.rb
 - lib/domkey/view/label_mapper.rb
 - lib/domkey/view/labeled_group.rb
@@ -115,6 +115,7 @@ files:
 - lib/domkey/view/select_list.rb
 - lib/domkey/view/widgetry/dispatcher.rb
 - lib/domkey/view/widgetry/package.rb
+- spec/binder_spec.rb
 - spec/browser_spec.rb
 - spec/checkbox_group_spec.rb
 - spec/html/test.html
@@ -122,13 +123,13 @@ files:
 - spec/option_selectable_spec.rb
 - spec/page_object_collection_spec.rb
 - spec/page_object_decorators_spec.rb
+- spec/page_object_delegates_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/watirspec_pageobjects/watirspec_spec.rb
@@ -157,6 +158,7 @@ signing_key:
 specification_version: 4
 summary: Domain Specifc PageObject for Selenium Watir-Webdriver
 test_files:
+- spec/binder_spec.rb
 - spec/browser_spec.rb
 - spec/checkbox_group_spec.rb
 - spec/html/test.html
@@ -164,13 +166,13 @@ test_files:
 - spec/option_selectable_spec.rb
 - spec/page_object_collection_spec.rb
 - spec/page_object_decorators_spec.rb
+- spec/page_object_delegates_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/watirspec_pageobjects/watirspec_spec.rb