page_object_wrapper 1.4.0 → 1.4.1

data/README.md

@@ -103,6 +103,8 @@ 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'
 
+      uniq_h1 :text => 'Testing display of HTML elements'
+
       text_field :tf do
         locator :id => 'f1'
         menu :user_defined, 'some food'
@@ -111,7 +113,7 @@ which will be checked for presence as well*
     end
 
 ##### it's possible to define action and its aliases inside pages
-*actions are being executed in browser context
+*actions are being executed in browser context*
 
     PageObjectWrapper.define_page :some_test_page do
       locator 'http://www.cs.tut.fi/~jkorpela/www/testel.html'
@@ -135,16 +137,9 @@ which will be checked for presence as well*
       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  
-- all defined elements have labels
-- action and action\_alias defined with labels and next\_pages
-- validator defined with label
+### other definition examples can be found inside 'good\_pages', 'bad\_pages' folders
 
-#### openning the page
+#### PageObjectWrapper.open\_page - opens page with specified label
 *preconditions*  
 There is a directory, where we've defined a page\_object inside a \*\_page.rb file
 
@@ -172,7 +167,7 @@ There is a directory, where we've defined a page\_object inside a \*\_page.rb fi
         PageObjectWrapper.define_page(:google){ locator 'www.google.com/:some_param' }  
         PageObjectWrapper.open_page(:google, :some_param => 'advanced_search') # => 'http://google.com/advanced_search'  
 
-#### page\_object.xxx 
+#### page\_object.xxx - returns corresponding Watir element defined inside page\_object
 *parameters*  
 no  
 *returns*  
@@ -192,7 +187,7 @@ Defined elements can be accessed with their labels.
 
 
 
-#### feed\_xxx 
+#### feed\_xxx - inserts data inside an element, an elements\_set or all elements of the page
 *parameters*  
 menu type, specified inside page\_object (optional)
 *returns*  
@@ -228,7 +223,7 @@ current\_page
           browser.text_field(:id => 'f1').value.should eq 'cheef menu'
           ....
 
-#### xxx\_menu  
+#### xxx\_menu - returns corresponding data, defined inside xxx element
 *parameters*  
 :food\_type  
 *returns*  
@@ -240,7 +235,7 @@ food value for this type which is defined in page\_object
     tp.tf_menu(:loud) # => 'tf food' 
     tp.rb1_menu(:loud) # => 'true' # pay attention that String is being returned (not true, TrueClass)
 
-#### fire\_xxx 
+#### fire\_xxx - executes action with label xxx
 *parameters*  
 optional arguments defined inside action  
 *returns*  
@@ -264,7 +259,7 @@ next\_page from xxx action
         tp = PageObjectWrapper.open_page(:some_test_page)
         tp.fire_fill_textarea_alias
 
-#### validate\_xxx 
+#### validate\_xxx - executes validator with label xxx
 *parameters*  
 optional arguments defined inside action  
 *returns*  
@@ -277,7 +272,7 @@ anything block inside xxx validator returns
       tp.fire_fill_textarea data
       tp.validate_textarea_value.should eq data
 
-#### select\_from\_xxx  
+#### select\_from\_xxx - tries to select data from table with label xxx
 *parameters*  
 :column\_1, :column\_2 => search\_value, :optional\_next\_page  
 *returns*  
@@ -285,12 +280,12 @@ 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 (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'*     
+**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)   
+*Method's syntax is close to SQL:*  
       page\_object.select\_from\_xxx( :column1, :column2 => 'string\_or\_regexp' )    
-correct arguments are:  
-:column1 is a column value from which you want to receive   
-:column2 is a column which is used to get specific row   
+*correct arguments are:*  
+:column1 *is a column value from which you want to receive   
+:column2 *is a column which is used to get specific row   
 
     context "where == nil":
       it "returns last row value from provided column":
@@ -334,7 +329,7 @@ correct arguments are:
           it "returns nil":
             tp.select_from_table_with_header(:country, {:row => 123}, :some_test_page).should eq nil
 
-#### each\_xxx
+#### each\_xxx - alternately opens each pagination subpage
       context "correct parameters ( limit = 3 )":
         it "opens browser on subeach page and yields corresponding page_object":
           gp = PageObjectWrapper.open_page(:google_pagination)
@@ -344,7 +339,7 @@ correct arguments are:
             subpage.should be_a PageObject 
             subpage.validate_current_number?(counter).should be_true
           }
-#### open\_xxx
+#### open\_xxx - opens pagination subpage number N
       context "correct parameters":
         it "opens browser on provided subpage returns corresponding page_object":
           n = 10

data/good_pages/some_test_page.html

@@ -1,4 +1,5 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+      element_output << "\tlabel #{e.label_value.inspect} not a Symbol\n" if not e.label_value.is_a?(Symbol)
         "http://www.w3.org/TR/html4/strict.dtd">
 <html lang="en-US">
 

data/lib/page_object_wrapper/PageObject.rb

@@ -75,7 +75,11 @@ class PageObject < DslElementWithLocator
       when (FEED.match(method_name) and has_element?($1))
         # page_object.feed_some_element(:fresh_food)
         e = element_for($1)
-        feed_elements([e], *args)
+        if [true, false].include? args[0] or args[0].is_a? String 
+          feed_field(e, args[0])
+        else
+          feed_elements([e], *args)
+        end
       when (FIRE_ACTION.match(method_name) and has_action?($1))
         # page_object.fire_some_action
         a = action_for($1)
@@ -359,6 +363,7 @@ private
   end
 
   def feed_elements(elements, *args)
+    raise PageObjectWrapper::BrowserNotFound if @@browser.nil? or not @@browser.exist?
     menu_name, cheef_menu = nil, nil
     
     if args[0].is_a? Symbol
@@ -367,7 +372,6 @@ private
     elsif args[0].is_a? Hash
       cheef_menu = args[0]
     end
-    raise PageObjectWrapper::BrowserNotFound if @@browser.nil? or not @@browser.exist?
     if not cheef_menu.nil?
       raise ArgumentError, "#{cheef_menu.inspect} not meaningful Hash" if not cheef_menu.is_a? Hash or cheef_menu.empty?
     end
@@ -400,6 +404,23 @@ private
     self
   end
 
+  def feed_field(e, value)
+    watir_element = PageObject.return_watir_element e
+    case watir_element
+    when Watir::CheckBox
+        watir_element.when_present.set value if [true, false].include? value
+    when Watir::Radio
+        watir_element.when_present.set if value==true          
+    when Watir::Select
+        watir_element.select value if watir_element.include? value
+    else
+      if watir_element.respond_to?(:set)
+        watir_element.when_present.set value 
+      end
+    end
+  end
+
+
   def fire_action(a, *args)
     raise PageObjectWrapper::BrowserNotFound if @@browser.nil? or not @@browser.exist?
     block = (a.is_a? Action)? a.fire_block_value : action_for(a.action_value).fire_block_value

data/lib/page_object_wrapper/version.rb

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

data/spec/feed_xxx_spec.rb

@@ -52,6 +52,28 @@ describe "page_object.feed_xxx" do
         @b.text_field(:id => 'f1').value.should eq 'tf food'
       end    
 
+      it "FEEDS text_field with String value" do
+        @tp.feed_tf_standalone("whible")
+        @b.text_field(:id => 'f1').value.should eq 'whible'
+      end    
+
+      it "FEEDS checkbox with true value" do
+        @tp.feed_cb1(true)
+        @b.checkbox(:id => 'f5').should be_set
+      end    
+
+      it "FEEDS radio with true" do
+        @tp.feed_rb1(true)
+        @b.radio(:id => 'f3').should be_set
+      end    
+
+      it "FEEDS select list if provided value exists in it" do
+        @tp.feed_s1("whible")
+        @b.select(:id => 'f10').value.should eq "two (default)"
+        @tp.feed_s1("one")
+        @b.select(:id => 'f10').value.should eq "one"
+      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.'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: page_object_wrapper
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.4.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-14 00:00:00.000000000 Z
+date: 2013-03-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
-  requirement: &20221960 !ruby/object:Gem::Requirement
+  requirement: &11441860 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *20221960
+  version_requirements: *11441860
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &20221520 !ruby/object:Gem::Requirement
+  requirement: &11441080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *20221520
+  version_requirements: *11441080
 - !ruby/object:Gem::Dependency
   name: babosa
-  requirement: &20220960 !ruby/object:Gem::Requirement
+  requirement: &11440240 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *20220960
+  version_requirements: *11440240
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &20220180 !ruby/object:Gem::Requirement
+  requirement: &11439500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: 2.0.0
   type: :development
   prerelease: false
-  version_requirements: *20220180
+  version_requirements: *11439500
 - !ruby/object:Gem::Dependency
   name: debugger
-  requirement: &20219440 !ruby/object:Gem::Requirement
+  requirement: &11438680 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,7 +65,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *20219440
+  version_requirements: *11438680
 description: Wraps watir-webdriver with convenient testing interface, based on PageObjects
   automation testing pattern. Simplifies resulting automated test understanding.
 email: