page_object_wrapper 1.3.7 → 1.4.0

data/README.md

@@ -42,49 +42,87 @@ optional arguments are enclosed with [ ]
 
 ### Examples
 
-#### definition example
+#### definition examples
+##### define a page object with url and some elements
+    PageObjectWrapper.define_page :some_test_page do
+      locator 'http://www.cs.tut.fi/~jkorpela/www/testel.html' # url
+      
+      text_field(:tf) do # defines a text_field
+        locator :id => 'f1' # element locator (can be Hash or String)
+        menu :user_defined, 'some food' # input data with type :user_defined for this element
+      end
 
-    PageObjectWrapper.define_page(:some_test_page) do
-      #locator 'http://www.cs.tut.fi/~jkorpela/www/testel.html'
-      locator 'file://'+Dir.pwd+'/good_pages/some_test_page.html'
-      uniq_h1 :text => 'Testing display of HTML elements'
+      select(:s1) do # select list
+        locator :id => 'f10'
+        menu :fresh_food, 'one'
+        menu :missing_food, 'three'
+      end
+
+      table(:table_with_header) do # table with predifined header
+        locator :summary => 'Each row names a Nordic country and specifies its total area and land area, in square kilometers'
+        header [:country, :total_area, :land_area] # header will be used later inside #select_from_xxx calls
+      end
+    end
+
+##### elements can be included into element\_sets
+    PageObjectWrapper.define_page :some_test_page do
+      locator 'http://www.cs.tut.fi/~jkorpela/www/testel.html'
 
-      elements_set(:test_elements) do
+      elements_set :test_elements do
         text_field(:tf) do
           locator :id => 'f1'
           menu :user_defined, 'some food'
         end
 
-        textarea(:ta) do
+        textarea :ta do
           locator :id => 'f2'
         end
         
-        select(:s1) do
+        select :s1 do
           locator :id => 'f10'
           menu :fresh_food, 'one'
           menu :missing_food, 'three'
         end
+      end
+    end
 
-        select(:s2) do
-          locator "form(:action => 'http://www.cs.tut.fi/cgi-bin/run/~jkorpela/echo.cgi').select(:id => 'f11')"
-          menu :fresh_food, 'one'
-        end
+##### each element can be marked as required 
+    PageObjectWrapper.define_page :some_test_page do
+      locator 'http://www.cs.tut.fi/~jkorpela/www/testel.html'
 
-        checkbox(:cb){ locator :id => 'f5' }
-        radio(:rb){ locator :id => 'f3' }
+      text_field :tf do
+        locator :id => 'f1'
+        menu :user_defined, 'some food'
+        required true # will be checked for presence upon page load
       end
+    end
 
-      action(:press_cool_button, :test_page_with_table) do
-        button(:name => 'foo').when_present.click
+*if all pages are similar through out the web app, it's possible to additionaly set a number of uniq elements   
+which will be checked for presence as well*
+
+    PageObjectWrapper.define_page :some_test_page_similar_to_previous do
+      locator 'http://www.cs.tut.fi/~jkorpela/www/testel.html'
+
+      text_field :tf do
+        locator :id => 'f1'
+        menu :user_defined, 'some food'
+        required true # will be checked for presence upon page load
       end
+    end
 
-      action(:fill_textarea, :some_test_page) do |fill_with|
-        data = (fill_with.nil?)? 'Default data' : fill_with
-        textarea(:id => 'f2').set data
+##### it's possible to define action and its aliases inside pages
+*actions are being executed in browser context
+
+    PageObjectWrapper.define_page :some_test_page do
+      locator 'http://www.cs.tut.fi/~jkorpela/www/testel.html'
+      uniq_h1 :text => 'Testing display of HTML elements'
+
+      action(:press_cool_button, :test_page_with_table) do # this action returns :test_page_with_table object after execution
+        button(:name => 'foo').when_present.click
       end
 
-      action :fill_textarea_with_returned_value do |fill_with|
-        data = (fill_with.nil?)? 'Default data' : fill_with
+      action :fill_textarea_with_returned_value do |fill_with|  # this action returns 'data' 
+        data = (fill_with.nil?)? 'Default data' : fill_with     # (because returned page object is not specified)
         textarea(:id => 'f2').set data
         data
       end 
@@ -95,21 +133,10 @@ optional arguments are enclosed with [ ]
       table(:table_without_header) do
         locator :summary => 'Each row names a Nordic country and specifies its total area and land area, in square kilometers'
       end
-
-      table(:table_with_header) do
-        locator :summary => 'Each row names a Nordic country and specifies its total area and land area, in square kilometers'
-        header [:country, :total_area, :land_area]
-      end
-
-      pagination(:some_pagination) do
-        locator :xpath => ''
-      end
-
-      validator(:textarea_value) do |expected|
-        textarea(:id => 'f2').value == expected
-      end
     end
 
+##### other definition examples can be found inside 'good\_pages', 'bad\_pages' folders
+
 here we have defined a page object with locator (url) = 'http://www.cs.tut.fi/~jkorpela/www/testel.html'  
 - uniq\_xxx is used to define a uniq element on that page, which uniquely identifies the page from other pages  
 - uniq\_xxx is being checked when openning the page with PageObjectWrapper.open\_page and when running an page\_object.action  
@@ -167,7 +194,7 @@ Defined elements can be accessed with their labels.
 
 #### feed\_xxx 
 *parameters*  
-:fresh\_food, :missing\_food  
+menu type, specified inside page\_object (optional)
 *returns*  
 current\_page  
   
@@ -222,10 +249,6 @@ next\_page from xxx action
 *preconditions*  
 **tp** is a :some\_test\_page object opened in the browser
 
-    it "executes fire_block in Watir::Browser context":
-      tp = PageObjectWrapper.open_page(:some_test_page)
-      tp.fire_fill_textarea
-
     it "can be invoked with parameters":
       tp = PageObjectWrapper.current_page
       tp.fire_fill_textarea('User defined data')
@@ -236,13 +259,6 @@ next\_page from xxx action
         data = tp.fire_fill_textarea_with_returned_value('data to fill with')
         tp.validate_textarea_value(data).should be(true)
 
-    context "next_page not nil":
-      it "returns next_page":
-        tp = PageObjectWrapper.current_page
-        np = tp.fire_press_cool_button
-        np.should be_a(PageObject)
-        np.label_value.should eq(:test_page_with_table)
-
     context "xxx is alias":
       it "executes corresponding action":
         tp = PageObjectWrapper.open_page(:some_test_page)
@@ -253,18 +269,13 @@ next\_page from xxx action
 optional arguments defined inside action  
 *returns*  
 anything block inside xxx validator returns
-it's expected that validator returns true | false
   
 *preconditions*  
 **tp** is a :some\_test\_page object opened in the browser
 
       tp = PageObjectWrapper.open_page(:some_test_page)
-      tp.fire_fill_textarea
-      tp.validate_textarea_value('Default data').should be(true)
-
-      tp = PageObjectWrapper.current_page
-      tp.fire_fill_textarea('User defined data')
-      tp.validate_textarea_value('User defined data').should be(true)
+      tp.fire_fill_textarea data
+      tp.validate_textarea_value.should eq data
 
 #### select\_from\_xxx  
 *parameters*  
@@ -274,7 +285,7 @@ Watir::TableCell if next\_page not specified
 next\_page if it is specified  
   
 *preconditions*  
-**tp** is a :some\_test\_page object opened in the browser  
+**tp** is a :some\_test\_page object opened in the browser (url = (https://raw.github.com/evgeniy-khatko/page_object_wrapper/master/img/scheme.png))
 its syntax is close to SQL *'select column1 from page\_object.some\_table where column2 = string\_or\_regexp'*     
       page\_object.select\_from\_xxx( :column1, :column2 => 'string\_or\_regexp' )    
 correct arguments are:  
@@ -343,6 +354,7 @@ correct arguments are:
           gp = PageObjectWrapper.open_page(:google_pagination)
           gp.pagination_open(n).should be_a PageObject
           gp.validate_current_number?(n).should be_true
+
 ## Contributing
 
 1. Fork it

data/bad_pages/bad_page.rb

@@ -7,6 +7,10 @@ PageObjectWrapper.define_page('some_page_with_lost_of_errors') do
   elements_set('some elements_set label') do
   end
 
+  text_field :bad_required_flad do
+    required 'a string'
+  end
+
   elements_set(:bad_elements) do
     element('') do
       menu :fresh_food, Array.new

data/good_pages/google_wrong_uniq_page.rb

@@ -1,4 +1,4 @@
 PageObjectWrapper.define_page(:wrong_google_page) do
   locator 'google.com'
-  uniq_element :id => 'foobar'
+  uniq_text_field :id => 'foobar'
 end

data/good_pages/required_missing_page.rb

@@ -0,0 +1,9 @@
+PageObjectWrapper.define_page(:required_missing) do
+  locator 'file://'+Dir.pwd+'/good_pages/some_test_page.html'
+
+  text_field(:tf) do
+    locator :id => 'foobar'
+    required true
+  end
+
+end

data/good_pages/some_test_page.rb

@@ -3,7 +3,36 @@ PageObjectWrapper.define_page(:some_test_page) do
   locator 'file://'+Dir.pwd+'/good_pages/some_test_page.html'
   uniq_h1 :text => 'Testing display of HTML elements'
 
+  text_field(:tf_standalone) do
+    locator :id => 'f1'
+    menu :loud, 'tf food'
+  end
+
+  button(:standalone_cool_button_with_default_press_action) do
+    locator :name => 'foo'
+    menu :loud, 'try to feed me!'
+  end
+
+  button(:standalone_cool_button) do
+    locator :name => 'foo'
+    press_action :click
+  end
+
+  button(:invalid_press_action_button) do
+    locator :name => 'foo'
+    press_action :press
+  end
+
+  button(:invalid_button) do
+    locator :name => 'bar'
+  end
+
   elements_set(:test_elements) do
+
+    button(:cool_button) do
+      locator :name => 'foo'
+    end
+
     text_field(:tf) do
       locator :id => 'f1'
       menu :loud, 'tf food'

data/good_pages/uniq_missing_page.rb

@@ -0,0 +1,4 @@
+PageObjectWrapper.define_page(:uniq_missing) do
+  locator 'file://'+Dir.pwd+'/good_pages/some_test_page.html'
+  uniq_text_field :id => 'foobar' 
+end

data/lib/page_object_wrapper.rb

@@ -32,6 +32,10 @@ module PageObjectWrapper
     PageObject.current_page
   end
 
+  def self.current_page? label
+    PageObject.current_page? label
+  end
+
   def self.load(path_to_pages='.')
     processed = 0
     Dir.glob("#{path_to_pages}/*_page.rb"){|fn|

data/lib/page_object_wrapper/Element.rb

@@ -6,6 +6,8 @@ class Element < DslElementWithLocator
     super label
     @type = type
     @menu = Hash.new
+    @press_action = :click
+    @required = false
   end
 
   def menu food_type, value
@@ -15,4 +17,20 @@ class Element < DslElementWithLocator
   def menu_value
     @menu
   end
+
+  def press_action action
+    @press_action = action
+  end
+
+  def press_action_value
+    @press_action
+  end
+
+  def required flag
+    @required = flag
+  end
+
+  def required_value
+    @required
+  end
 end

data/lib/page_object_wrapper/Exceptions.rb

@@ -8,4 +8,5 @@ module PageObjectWrapper
   class DynamicUrl < StandardError; end
   class InvalidPagination < StandardError; end
   class OutOfBoundsSubpage < StandardError; end
+  class InvalidElement < StandardError; end
 end

data/lib/page_object_wrapper/PageObject.rb

@@ -10,6 +10,7 @@ require 'Alias'
 require 'Validator'
 require 'Table'
 require 'Pagination'
+require 'Element'
 require 'known_elements'
 
 class PageObject < DslElementWithLocator
@@ -18,19 +19,18 @@ class PageObject < DslElementWithLocator
   @@pages = []
   @@current_page = nil
 
-  UNIQ_ELEMENT_WAIT_PERIOD = 10
+  REQUIRED_ELEMENT_WAIT_PERIOD = 10
   FEED_ALL = Regexp.new(/^feed_all$/)
-  FEED_SET = Regexp.new(/^feed_([\w_]+)$/)
+  FEED = Regexp.new(/^feed_([\w_]+)$/)
   FIRE_ACTION = Regexp.new(/^fire_([\w_]+)$/)
   SELECT_FROM = Regexp.new(/^select_from_([\w_]+)$/)
   PAGINATION_EACH = Regexp.new(/^([\w_]+)_each$/)
   PAGINATION_OPEN = Regexp.new(/^([\w_]+)_open$/)
   VALIDATE = Regexp.new(/^validate_([\w_\?]+)$/)
+  PRESS = Regexp.new(/^press_([\w_\?]+)$/)
     
   def initialize(label)
     super label
-    @uniq_element_type = nil
-    @uniq_element_hash = {}
     @esets = []
     @elements = []
     @actions = []
@@ -40,28 +40,42 @@ class PageObject < DslElementWithLocator
     @paginations = []
   end
 
+  KNOWN_ELEMENTS.each{|m|
+    PageObject.send :define_method, m do |l, &b|
+      e = Element.new(l, m.to_sym)
+      e.instance_eval(&b)
+      @elements << e
+    end
+  }
+
   # lazy evaluated calls of real watir elements are handled by :method_missing
   def method_missing(method_name, *args, &block)
     case 
       when KNOWN_ELEMENTS.include?(method_name.to_s.gsub(/^uniq_/,''))
         # page_object.uniq_xxx(hash)
-        @uniq_element_type = method_name.to_s.gsub(/^uniq_/,'').to_sym
-        @uniq_element_hash = args[0]
+        meth = method_name.to_s.gsub(/^uniq_/,'')
+        e = Element.new(method_name.to_sym, meth)
+        e.instance_eval { locator(args[0]); required(true) }
+        @elements << e
       when has_eset?(method_name)
         # page_object.some_elements_set
         eset = eset_for(method_name)
-        return_array_of_watir_elements(eset)
+        PageObject.return_array_of_watir_elements(eset)
       when has_element?(method_name)
         # page_object.some_element
         element = element_for(method_name)
-        return_watir_element(element)
+        PageObject.return_watir_element element
       when FEED_ALL.match(method_name)
         # page_object.feed_all(:fresh_food)
         feed_elements(@elements, *args)
-      when (FEED_SET.match(method_name) and has_eset?($1))
+      when (FEED.match(method_name) and has_eset?($1))
         # page_object.feed_some_elements_set(:fresh_food)
         eset = eset_for($1)
         feed_elements(eset.elements, *args)
+      when (FEED.match(method_name) and has_element?($1))
+        # page_object.feed_some_element(:fresh_food)
+        e = element_for($1)
+        feed_elements([e], *args)
       when (FIRE_ACTION.match(method_name) and has_action?($1))
         # page_object.fire_some_action
         a = action_for($1)
@@ -86,6 +100,10 @@ class PageObject < DslElementWithLocator
         # page_object.open_padination(1)
         pagination = pagination_for($1)
         open_subpage(pagination, *args)
+      when (PRESS.match(method_name) and has_element?($1))
+        # page_object.press_element
+        element = element_for($1)
+        press(element)
       else
         super
     end
@@ -107,9 +125,12 @@ class PageObject < DslElementWithLocator
       when FEED_ALL.match(method_name)
         # page_object.feed_all(:fresh_food)
         true
-      when (FEED_SET.match(method_name) and has_eset?($1))
+      when (FEED.match(method_name) and has_eset?($1))
         # page_object.feed_some_elements_set(:fresh_food)
         true
+      when (FEED.match(method_name) and has_element?($1))
+        # page_object.feed_some_element(:fresh_food)
+        true
       when (FIRE_ACTION.match(method_name) and has_action?($1))
         # page_object.fire_some_action
         true
@@ -128,6 +149,9 @@ class PageObject < DslElementWithLocator
       when (PAGINATION_OPEN.match(method_name) and has_pagination?($1))
         # page_object.open_padination(1)
         true
+      when (PRESS.match(method_name) and has_element?($1))
+        # page_object.press_element
+        true
       else
         super
     end
@@ -155,17 +179,22 @@ class PageObject < DslElementWithLocator
     raise PageObjectWrapper::BrowserNotFound if @@browser.nil?
     raise PageObjectWrapper::UnknownPageObject, label if not @@pages.collect(&:label_value).include?(label)
     page_object = PageObject.find_page_object(label)
-    if not page_object.uniq_element_type.nil?
+    page_object.elements.select{ |e| e.required_value == true }.each{ |required_element|
       begin
-        watir_uniq_element = @@browser.send page_object.uniq_element_type, page_object.uniq_element_hash
-        watir_uniq_element.wait_until_present UNIQ_ELEMENT_WAIT_PERIOD
+        watir_element = return_watir_element required_element
+        watir_element.wait_until_present REQUIRED_ELEMENT_WAIT_PERIOD
       rescue Watir::Wait::TimeoutError => e
-        raise PageObjectWrapper::UnmappedPageObject, "#{label} <=> #{@@browser.url} (#{e.message})" if not watir_uniq_element.present?
+        raise PageObjectWrapper::UnmappedPageObject, "#{label} <=> #{@@browser.url} (#{e.message})" if not watir_element.present?
       end
-    end
+    }
     @@current_page = page_object
   end
 
+  def self.current_page? label
+    self.map_current_page label
+    true
+  end
+
   def self.current_page
     @@current_page
   end
@@ -242,15 +271,19 @@ class PageObject < DslElementWithLocator
       eset_output << "\tlabel #{eset.label_value.inspect} not a Symbol\n" if not eset.label_value.is_a?(Symbol)
       eset_output.unshift "elements_set(#{eset.label_value.inspect}):\n" if not eset_output.empty?
       output += eset_output
-      eset.elements.each{|e|
-        element_output = []
-        element_output << "\t\telement #{e.label_value.inspect} already defined\n" if labeled(eset.elements).count(e.label_value) > 1
-        element_output << "\t\tlabel #{e.label_value.inspect} not a Symbol\n" if not e.label_value.is_a?(Symbol)
-        element_output << "\t\tlocator #{e.locator_value.inspect} not a meaningful Hash or String\n" if (not e.locator_value.is_a?(Hash) and not e.locator_value.is_a?(String)) or e.locator_value.empty?
-        element_output << "\t\tmenu #{e.menu_value.inspect} not properly defined (must be { :food_type => 'a string' | true | false })\n" if (e.menu_value.keys.collect(&:class).uniq != [Symbol]) or not (e.menu_value.values.collect(&:class).uniq - [String, TrueClass, FalseClass]).empty?
-        element_output.unshift "\telement(#{e.label_value.inspect}):\n" if not element_output.empty?
-        output += element_output       
-      }
+    }
+    @elements.each{|e|
+      element_output = []
+      element_output << "\telement #{e.label_value.inspect} already defined\n" if labeled(@elements).count(e.label_value) > 1
+      element_output << "\tlabel #{e.label_value.inspect} not a Symbol\n" if not e.label_value.is_a?(Symbol)
+      element_output << "\tlocator #{e.locator_value.inspect} not a meaningful Hash or String\n" if (not e.locator_value.is_a?(Hash) and not e.locator_value.is_a?(String)) \
+                                                                                                    or e.locator_value.empty?
+      element_output << "\tmenu #{e.menu_value.inspect} not properly defined (must be { :food_type => 'a string' | true | false })\n" if (not e.menu_value.empty?) and \
+                                                                                                                                        ((e.menu_value.keys.collect(&:class).uniq != [Symbol]) \
+                                                                                                                                         or not (e.menu_value.values.collect(&:class).uniq - [String, TrueClass, FalseClass]).empty?)
+      element_output << "\trequired flag #{e.required_value.inspect} not a true | false\n" if not [true, false].include? e.required_value
+      element_output.unshift "element(#{e.label_value.inspect}):\n" if not element_output.empty?
+      output += element_output       
     }
     @actions.each{|a|
       action_output = []
@@ -286,9 +319,6 @@ class PageObject < DslElementWithLocator
     }
     @tables.each{|t|
       table_output = []
-      table_output << "\ttable #{t.label_value.inspect} already defined\n" if labeled(@tables).count(t.label_value) > 1
-      table_output << "\tlabel #{t.label_value.inspect} not a Symbol\n" if not t.label_value.is_a?(Symbol)
-      table_output << "\tlocator #{t.locator_value.inspect} not a meaningful Hash or String\n" if (not t.locator_value.is_a?(Hash) and not t.locator_value.is_a?(String)) or t.locator_value.empty?
       table_output << "\theader #{t.header_value.inspect} not a meaningful Array\n" if not t.header_value.is_a?(Array) or t.header_value.empty?
       table_output.unshift "table(#{t.label_value.inspect}):\n" if not table_output.empty?
       output += table_output
@@ -314,7 +344,7 @@ private
     p
   end
   
-  def return_watir_element(e)
+  def self.return_watir_element(e)
     el = nil
     if e.locator_value.is_a? Hash
       el = @@browser.send e.type, e.locator_value
@@ -324,7 +354,7 @@ private
     el
   end
 
-  def return_array_of_watir_elements(eset)
+  def self.return_array_of_watir_elements(eset)
     eset.elements.collect{|e| return_watir_element(e)}
   end
 
@@ -349,7 +379,7 @@ private
       else
         food = e.menu_value[menu_name].to_s
       end
-      watir_element = return_watir_element(e)
+      watir_element = PageObject.return_watir_element e
       case watir_element
         when Watir::CheckBox
           watir_element.when_present.set eval(food) if ["true", "false"].include? food
@@ -361,7 +391,9 @@ private
           if watir_element.respond_to?(:set)
             watir_element.when_present.set food if food!=''
           else
-            raise PageObjectWrapper::UnableToFeedObject, to_tree(@@current_page, e) + ' check element type'
+            # this is an element which does not support input (e.g. button) => skipping it
+            next
+            #raise PageObjectWrapper::UnableToFeedObject, to_tree(@@current_page, e) + ' check element type'
           end
         end
     }
@@ -487,6 +519,16 @@ private
     self
   end
 
+  def press e
+    raise PageObjectWrapper::BrowserNotFound if @@browser.nil? or not @@browser.exist?
+    watir_element = PageObject.return_watir_element e
+    raise PageObjectWrapper::InvalidElement, "Element #{e.locator_value} not found in #{@@current_page}"\
+      if not watir_element.present?
+    raise PageObjectWrapper::InvalidElement, "Element #{e.locator_value} does not respond to #{e.press_action_value}"\
+      if not watir_element.respond_to? e.press_action_value
+    watir_element.when_present.send e.press_action_value 
+    watir_element
+  end
 
   def labeled(ary)
     ary.collect(&:label_value)

data/lib/page_object_wrapper/Pagination.rb

@@ -5,6 +5,7 @@ class Pagination < DslElement
     super label
     @locator = nil
     @finds = nil
+    @menu = Hash.new
   end
 
   def locator hash, finds
@@ -19,5 +20,5 @@ class Pagination < DslElement
   def finds_value
     @finds
   end
-end
 
+end

data/lib/page_object_wrapper/Table.rb

@@ -1,5 +1,5 @@
 require 'Dsl'
-class Table < DslElementWithLocator
+class Table < Element
   attr_reader :type
   dsl_attr_accessor :header
   DEFAULT_HEADER_COLLUMNS_NUMBER = 100 
@@ -7,11 +7,9 @@ class Table < DslElementWithLocator
   
 
   def initialize(label)
-    super label
+    super label, 'table'
     h = []
     DEFAULT_HEADER_COLLUMNS_NUMBER.times { |i| h << (DEFAULT_HEADER_COLLUMNS_PREFIX+i.to_s).to_sym }
     @header = h
-    @type = 'table'
   end
 end
-

data/lib/page_object_wrapper/known_elements.rb

@@ -8,7 +8,7 @@ KNOWN_ELEMENTS = [
   'cites', 'code', 'codes', 'col', 'colgroup', 'colgroups', 
   'cols', 'command', 'commands', 'datalist', 'datalists', 
   'dd', 'dds', 'del', 'dels', 'details', 'dfn', 'dfns', 'div', 
-  'divs', 'dl', 'dls', 'dt', 'dts', 'element', 'elements', 
+  'divs', 'dl', 'dls', 'dt', 'dts', 'element',
   'em', 'embed', 'embeds', 'ems', 'fieldset', 'fieldsets', 'figcaption', 
   'figcaptions', 'figure', 'figures', 'file_field', 'file_fields', 'font', 
   'fonts', 'footer', 'footers', 'form', 'forms', 'frame', 'frames', 
@@ -24,7 +24,7 @@ KNOWN_ELEMENTS = [
   'ps', 'q', 'qs', 'radio', 'radios', 'rp', 'rps', 'rt', 'rts', 'rubies', 'ruby', 's', 
   'samp', 'samps', 'script', 'scripts', 'section', 'sections', 'select', 'selects', 'small', 
   'smalls', 'source', 'sources', 'span', 'spans', 'ss', 'strong', 'strongs', 'style', 'styles', 
-  'sub', 'subs', 'summaries', 'summary', 'sup', 'sups', 'table', 'tables', 'tbody', 'tbodys', 'td', 
+  'sub', 'subs', 'summaries', 'summary', 'sup', 'sups', 'tbody', 'tbodys', 'td', 
   'tds', 'text_field', 'text_fields', 'textarea', 'textareas', 'tfoot', 'tfoots', 'th', 'thead', 
   'theads', 'ths', 'time', 'times', 'title', 'titles', 'tr', 'track', 'tracks', 'trs', 'ul', 
   'uls', 'var', 'vars', 'video', 'videos', 'wbr', 'wbrs'

data/lib/page_object_wrapper/version.rb

@@ -1,3 +1,3 @@
 module PageObjectWrapper
-  VERSION = "1.3.7"
+  VERSION = "1.4.0"
 end

data/spec/define_page_object_spec.rb

@@ -1,5 +1,6 @@
 require 'spec_helper'
 require 'shared_examples'
+require 'known_elements'
 
 describe "define_page_object" do
   let!(:page_object){
@@ -21,8 +22,17 @@ describe "define_page_object" do
     end
 
     describe "page_object uniq_element" do
-      its(:uniq_element_type) { should eq :h1 }
-      its(:uniq_element_hash) { should == {:text => 'Testing display of HTML elements'} }
+      specify { subject.elements.collect(&:label_value).should include(:uniq_h1) }
+      let(:uniq_element){ subject.elements[subject.elements.collect(&:label_value).index(:uniq_h1)] }
+      specify { uniq_element.required_value.should be_true }
+    end
+
+    describe "page_object element" do      
+      it "can contain known elements" do
+        KNOWN_ELEMENTS.each{ |known|
+          subject.should respond_to known
+        }
+      end
     end
 
     specify { subject.esets.collect(&:label_value).should include(:test_elements)}
@@ -47,8 +57,42 @@ describe "define_page_object" do
     specify { subject.paginations.collect(&:label_value).should include(:some_pagination)}
     it { should respond_to(:some_pagination_each) }
     it { should respond_to(:some_pagination_open) }
+
+    specify { subject.elements.collect(&:label_value).should include(:tf_standalone)}
+    it { should respond_to(:feed_tf_standalone) }
+    it { should respond_to(:press_tf_standalone) }
+
+    specify { subject.elements.collect(&:label_value).should include(:standalone_cool_button)}
+    it { should respond_to(:press_standalone_cool_button) }
+    it { should respond_to(:feed_standalone_cool_button) }
   end
 
+  context "element outside elements_set" do
+    subject { page_object.elements[page_object.elements.collect(&:label_value).index(:tf_standalone)] }
+    
+    it { should be_a(Element) }
+
+    describe "element label" do
+      it_should_behave_like "a label"
+    end
+    
+    describe "element locator" do
+      it_should_behave_like "a locator"
+      its(:locator_value) { should be_a Hash }
+    end
+
+    describe "element menu" do
+      it { should respond_to(:menu) }
+      it { should respond_to(:menu_value) }
+
+      its(:menu_value) { should be_a Hash}
+
+      describe "user defined menu" do
+        its(:menu_value){ should have_key :loud }
+        its(:menu_value){ should have_value 'tf food'}
+      end
+    end
+  end
 
   context "elements_set" do
     subject { page_object.esets[page_object.esets.collect(&:label_value).index(:test_elements)] }
@@ -60,7 +104,7 @@ describe "define_page_object" do
     end
   end
 
-  context "element" do
+  context "element inside elements_set" do
     subject { page_object.elements[page_object.elements.collect(&:label_value).index(:tf)] }
     
     it { should be_a(Element) }

data/spec/feed_xxx_spec.rb

@@ -24,12 +24,19 @@ describe "page_object.feed_xxx" do
     end
 
     it "returns current page object" do
+      @tp.feed_tf_standalone(:quite).should be_a PageObject
       @tp.feed_test_elements(:quite).should be_a PageObject
+      @tp.feed_all(:quite).should be_a PageObject
     end
 
-    context "menu not specified" do
-      it "does nothing" do
-        @tp.feed_test_elements
+    describe "feed_standalone_element" do 
+      it "does nothing if menu not spesified" do
+        @tp.feed_tf_standalone
+        @b.text_field(:id => 'f1').value.should eq 'Default text.'
+      end
+
+      it "does nothing if element does not support :select or :set methods" do
+        @tp.feed_standalone_cool_button(:loud)
         @b.text_field(:id => 'f1').value.should eq 'Default text.'
         @b.textarea(:id => 'f2').value.should eq "Default text.\n"
         @b.radio(:id => 'f3').should_not be_set
@@ -39,9 +46,46 @@ describe "page_object.feed_xxx" do
         @b.select(:id => 'f10').value.should eq 'two (default)'
         @b.select(:id => 'f11').value.should eq 'two (default)'
       end
+
+      it "FEEDS elements which has provided menu" do
+        @tp.feed_tf_standalone(:loud)
+        @b.text_field(:id => 'f1').value.should eq 'tf food'
+      end    
+
+      it "feeds ONLY elements which has provided menu" do
+        @tp.feed_tf_standalone(:quite)
+        @b.text_field(:id => 'f1').value.should eq 'Default text.'
+        @b.textarea(:id => 'f2').value.should eq "Default text.\n"
+        @b.radio(:id => 'f4').should be_set
+        @b.checkbox(:id => 'f6').should be_set
+        @b.select(:id => 'f11').value.should eq 'two (default)'
+      end    
+
+      it "overrides defined menu when passing arguments" do
+        @tp.feed_tf_standalone(:loud, :tf_standalone => 'cheef menu')
+        @b.text_field(:id => 'f1').value.should eq 'cheef menu'
+      end
+
+      it "can be used without providing a menu" do
+        @tp.feed_tf_standalone(:tf_standalone => 'cheef menu')
+        @b.text_field(:id => 'f1').value.should eq 'cheef menu'
+      end
     end
 
-    describe "basic usage" do 
+    describe "feed_elements_set" do 
+      it "does nothing if menu not spesified" do
+        @tp.feed_test_elements
+        @tp.feed_all
+        @b.text_field(:id => 'f1').value.should eq 'Default text.'
+        @b.textarea(:id => 'f2').value.should eq "Default text.\n"
+        @b.radio(:id => 'f3').should_not be_set
+        @b.radio(:id => 'f4').should be_set
+        @b.checkbox(:id => 'f5').should_not be_set
+        @b.checkbox(:id => 'f6').should be_set
+        @b.select(:id => 'f10').value.should eq 'two (default)'
+        @b.select(:id => 'f11').value.should eq 'two (default)'
+      end
+
       it "FEEDS elements which has provided menu" do
         @tp.feed_test_elements(:loud)
         @b.text_field(:id => 'f1').value.should eq 'tf food'
@@ -79,5 +123,56 @@ describe "page_object.feed_xxx" do
         @b.select(:id => 'f11').value.should eq 'three'
       end
     end
+
+    describe "feed_all" do 
+      it "does nothing if menu not spesified" do
+        @tp.feed_all
+        @b.text_field(:id => 'f1').value.should eq 'Default text.'
+        @b.textarea(:id => 'f2').value.should eq "Default text.\n"
+        @b.radio(:id => 'f3').should_not be_set
+        @b.radio(:id => 'f4').should be_set
+        @b.checkbox(:id => 'f5').should_not be_set
+        @b.checkbox(:id => 'f6').should be_set
+        @b.select(:id => 'f10').value.should eq 'two (default)'
+        @b.select(:id => 'f11').value.should eq 'two (default)'
+      end
+
+      it "FEEDS elements which has provided menu" do
+        @tp.feed_all(:loud)
+        @b.text_field(:id => 'f1').value.should eq 'tf food'
+        @b.textarea(:id => 'f2').value.should eq "ta food"
+        @b.radio(:id => 'f3').should be_set
+        @b.radio(:id => 'f4').should_not be_set
+        @b.checkbox(:id => 'f5').should be_set
+        @b.checkbox(:id => 'f6').should_not be_set
+        @b.select(:id => 'f10').value.should eq 'one'
+        @b.select(:id => 'f11').value.should eq 'one'
+      end    
+
+      it "feeds ONLY elements which has provided menu" do
+        @tp.feed_all(:quite)
+        @b.text_field(:id => 'f1').value.should eq 'Default text.'
+        @b.textarea(:id => 'f2').value.should eq "Default text.\n"
+        @b.radio(:id => 'f4').should be_set
+        @b.checkbox(:id => 'f6').should be_set
+        @b.select(:id => 'f11').value.should eq 'two (default)'
+      end    
+
+      it "overrides defined menu when passing arguments" do
+        @tp.feed_all(:loud, :tf => 'cheef menu', :rb1 => false, :rb2 => true, :cb2 => true, :s2 => 'three')
+        @b.text_field(:id => 'f1').value.should eq 'cheef menu'
+        @b.radio(:id => 'f4').should be_set
+        @b.checkbox(:id => 'f6').should be_set
+        @b.select(:id => 'f11').value.should eq 'three'
+      end
+
+      it "can be used without providing a menu" do
+        @tp.feed_all(:tf => 'cheef menu', :rb2 => true, :cb2 => true, :s2 => 'three')
+        @b.text_field(:id => 'f1').value.should eq 'cheef menu'
+        @b.radio(:id => 'f4').should be_set
+        @b.checkbox(:id => 'f6').should be_set
+        @b.select(:id => 'f11').value.should eq 'three'
+      end
+    end
   end
 end

data/spec/load_spec.rb

@@ -10,26 +10,35 @@ describe "PageObjectWrapper.load" do
       begin
         PageObjectWrapper.load(File.dirname(__FILE__)+'/../bad_pages')
       rescue Exception => e
-#        puts '=============='
-#        puts e.message
-#        puts '=============='
+      #  puts '=============='
+      #  puts e.message
+      #  puts '=============='
         e.should be_a(PageObjectWrapper::Load)
         e.message.should == 'page_object("some_page_with_lost_of_errors"):
 	label "some_page_with_lost_of_errors" not a Symbol
 	locator "" not a meaningful String
 elements_set("some elements_set label"):
 	label "some elements_set label" not a Symbol
-	element(""):
-		label "" not a Symbol
-		locator nil not a meaningful Hash or String
-		menu {:fresh_food=>[]} not properly defined (must be { :food_type => \'a string\' | true | false })
-	element(:e):
-		element :e already defined
-		menu {"a string"=>"another string"} not properly defined (must be { :food_type => \'a string\' | true | false })
-	element(:e):
-		element :e already defined
-		locator {} not a meaningful Hash or String
-		menu {} not properly defined (must be { :food_type => \'a string\' | true | false })
+element(:bad_required_flad):
+	locator nil not a meaningful Hash or String
+	required flag "a string" not a true | false
+element(""):
+	element "" already defined
+	label "" not a Symbol
+	locator nil not a meaningful Hash or String
+	menu {:fresh_food=>[]} not properly defined (must be { :food_type => \'a string\' | true | false })
+element(:e):
+	element :e already defined
+	menu {"a string"=>"another string"} not properly defined (must be { :food_type => \'a string\' | true | false })
+element(:e):
+	element :e already defined
+	locator {} not a meaningful Hash or String
+element(""):
+	element "" already defined
+	label "" not a Symbol
+	locator nil not a meaningful Hash or String
+element(:some_table):
+	locator nil not a meaningful Hash or String
 action(""):
 	label "" not a Symbol
 	next_page "a string" not a Symbol
@@ -41,11 +50,7 @@ alias(""):
 	action "unknown action" not known Action
 validator(""):
 	label "" not a Symbol
-table(""):
-	label "" not a Symbol
-	locator nil not a meaningful Hash or String
 table(:some_table):
-	locator nil not a meaningful Hash or String
 	header [] not a meaningful Array
 pagination(""):
 	label "" not a Symbol

data/spec/press_xxx_spec.rb

@@ -0,0 +1,61 @@
+require 'spec_helper'
+
+describe "page_object.press_xxx" do
+  context "browser is closed" do
+    it "raises PageObjectWrapper::BrowserNotFound" do
+      tp = PageObjectWrapper.receive_page(:some_test_page)
+      expect{ tp.press_standalone_cool_button }.to raise_error(PageObjectWrapper::BrowserNotFound)
+    end
+  end
+
+  context "browser is opened" do
+    before(:all){
+      @b = Watir::Browser.new
+      PageObjectWrapper.use_browser @b
+    }
+    before(:each){ @tp = PageObjectWrapper.open_page(:some_test_page) }
+    after(:all){ PageObjectWrapper.browser.quit }
+    let(:tp){ PageObjectWrapper.current_page }
+
+    context "xxx not found among current_page elements" do
+      it "raises NoMethodError" do
+        expect{ tp.press_nonexistent_element }.to raise_error(NoMethodError)
+      end
+    end
+
+    context "element does not respond to user action" do
+      it "raises InvalidElement error" do
+        expect{ tp.press_invalid_press_action_button }.to raise_error(PageObjectWrapper::InvalidElement)
+      end
+    end
+
+    context "element does not present" do
+      it "raises InvalidElement error" do
+        expect{ tp.press_invalid_button }.to raise_error(PageObjectWrapper::InvalidElement)
+      end
+    end
+
+    context "basic usage" do
+
+      it "returns pressed watir element" do
+        tp.press_cool_button.should be_a Watir::Button
+      end
+
+      it "really presses the element" do
+        tp.press_standalone_cool_button_with_default_press_action
+        PageObjectWrapper.current_page?(:test_page_with_table).should be_true
+      end
+
+      it "presses with user defined action" do
+        tp.press_standalone_cool_button
+        PageObjectWrapper.current_page?(:test_page_with_table).should be_true
+      end
+
+      it "presses element inside an elements_set" do
+        tp.press_cool_button
+        PageObjectWrapper.current_page?(:test_page_with_table).should be_true
+      end
+    end
+  end
+end
+

data/spec/required_elements_spec.rb

@@ -0,0 +1,65 @@
+require 'spec_helper'
+
+describe "page_object required elements" do
+  describe "required elements are checked during .open_page" do
+    
+    context "browser is closed" do
+      it "raises PageObjectWrapper::BrowserNotFound" do
+        tp = PageObjectWrapper.receive_page(:some_test_page)
+        expect{ PageObjectWrapper.open_page :some_test_page }.to raise_error(PageObjectWrapper::BrowserNotFound)
+      end
+    end
+
+    context "browser is opened" do
+      before(:all){
+        @b = Watir::Browser.new
+        PageObjectWrapper.use_browser @b
+      }
+
+      after(:all){ PageObjectWrapper.browser.quit }
+
+      context "one of required elements not found" do
+        it "raises UnmappedPageObject error" do
+          expect{ PageObjectWrapper.open_page :required_missing }.to raise_error(PageObjectWrapper::UnmappedPageObject)
+        end
+      end
+
+      context "one of uniq elements not found" do
+        it "raises UnmappedPageObject error" do
+          expect{ PageObjectWrapper.open_page :uniq_missing }.to raise_error(PageObjectWrapper::UnmappedPageObject)
+        end
+      end
+    end
+  end
+
+  describe "required elements are checked during .current_page?" do
+    context "browser is closed" do
+      it "raises PageObjectWrapper::BrowserNotFound" do
+        tp = PageObjectWrapper.receive_page(:some_test_page)
+        expect{ PageObjectWrapper.current_page? :some_test_page }.to raise_error(Watir::Exception::Error)
+      end
+    end
+
+    context "browser is opened" do
+      before(:all){
+        @b = Watir::Browser.new
+        PageObjectWrapper.use_browser @b
+      }
+
+      after(:all){ PageObjectWrapper.browser.quit }
+      before(:all){ PageObjectWrapper.open_page :some_test_page }
+
+      context "one of required elements not found" do
+        it "raises UnmappedPageObject error" do
+          expect{ PageObjectWrapper.current_page? :required_missing }.to raise_error(PageObjectWrapper::UnmappedPageObject)
+        end
+      end
+
+      context "one of uniq elements not found" do
+        it "raises UnmappedPageObject error" do
+          expect{ PageObjectWrapper.current_page? :uniq_missing }.to raise_error(PageObjectWrapper::UnmappedPageObject)
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: page_object_wrapper
 version: !ruby/object:Gem::Version
-  version: 1.3.7
+  version: 1.4.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-10 00:00:00.000000000 Z
+date: 2013-03-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &20221960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,15 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *20221960
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &20221520 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -37,15 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *20221520
 - !ruby/object:Gem::Dependency
   name: babosa
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &20220960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -53,15 +43,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *20220960
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &20220180 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -69,15 +54,10 @@ dependencies:
         version: 2.0.0
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 2.0.0
+  version_requirements: *20220180
 - !ruby/object:Gem::Dependency
   name: debugger
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &20219440 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -85,12 +65,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *20219440
 description: Wraps watir-webdriver with convenient testing interface, based on PageObjects
   automation testing pattern. Simplifies resulting automated test understanding.
 email:
@@ -111,9 +86,11 @@ files:
 - good_pages/google_wrong_uniq_page.rb
 - good_pages/goole_as_page.rb
 - good_pages/pagination_example_page.rb
+- good_pages/required_missing_page.rb
 - good_pages/some_test_page.html
 - good_pages/some_test_page.rb
 - good_pages/test_table_page.rb
+- good_pages/uniq_missing_page.rb
 - img/scheme.png
 - lib/page_object_wrapper.rb
 - lib/page_object_wrapper/Action.rb
@@ -136,6 +113,8 @@ files:
 - spec/load_spec.rb
 - spec/menu_xxx_spec.rb
 - spec/open_page_spec.rb
+- spec/press_xxx_spec.rb
+- spec/required_elements_spec.rb
 - spec/select_from_xxx_spec.rb
 - spec/shared_examples.rb
 - spec/spec_helper.rb
@@ -163,7 +142,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.25
+rubygems_version: 1.8.15
 signing_key: 
 specification_version: 3
 summary: Wraps watir-webdriver with convenient testing interface.
@@ -175,6 +154,8 @@ test_files:
 - spec/load_spec.rb
 - spec/menu_xxx_spec.rb
 - spec/open_page_spec.rb
+- spec/press_xxx_spec.rb
+- spec/required_elements_spec.rb
 - spec/select_from_xxx_spec.rb
 - spec/shared_examples.rb
 - spec/spec_helper.rb