selenium-webdriver-element-decorators 0.2.0 → 0.3.0

data/README.rdoc

@@ -1,6 +1,29 @@
-= selenium-webdriver-element-decorators
+= Selenium 2.0 (WebDriver) Element Decorators
 
-Description goes here.
+This package implements a set of decorator classes for WebElement's of Selenium 2.0 (WebDriver). They add specific behavoiur to various elements of web interface that allow to write more readable automation scripts. Decorators provide all the same methods as original WebElement, but adds several new methods to deal with forms, selects, checkboxes etc.
+
+== Sample
+
+    require ''
+
+    browser = Browser.new :firefox
+    browser.navigate.to 'http://www.htmlcodetutorial.com/forms/_INPUT_TYPE_PASSWORD.html'
+
+    form = browser.find_element(:id => 'content').find_element(:tag_name => 'form')
+    form.populate 'realname' => 'John Smith', 'mypassword' => 'qwerty'
+    form.submit
+
+    browser.navigate.to 'http://www.htmlcodetutorial.com/forms/_SELECT_MULTIPLE.html'
+    form = browser.find_element(:id => 'content').find_element(:tag_name => 'form')
+    select = form.find_element :name => 'toppings'
+    select.select_by_value ['greenpeppers', 'tomatoes']
+    form.submit
+
+== Why Decorators?
+
+Yes, it was possible to inject new methods right inside WebElement class. But decorator pattern looks more suitable because it allows to distinguish web elements of different kind. One may use is_a? method to check their type, and only specific methods are added to each decorator class. What would 'populate' method mean for a button, or 'append' method for an element other than text input field (or password, or text area)?
+
+Decorators reimplement 'find_element' and 'find_elements' methods. They make an attempt to recognize type of each found element and automatically decorate it according to its type.
 
 == Contributing to selenium-webdriver-element-decorators
  

data/lib/selenium/webdriver/elements.rb

@@ -1,3 +1,4 @@
+require 'selenium/webdriver'
 require 'selenium/webdriver/elements/element'
 require 'selenium/webdriver/elements/browser'
 require 'selenium/webdriver/elements/form'

data/lib/selenium/webdriver/elements/browser.rb

@@ -6,13 +6,11 @@ module Selenium
 
       class Browser < Element
 
-        def initialize element
-          if element.is_a?(Selenium::WebDriver::Driver) then
-            @element = element
-          elsif element.is_a?(Symbol) then
-            @element = Selenium::WebDriver.for element
+        def initialize *args
+          if args.length == 1 and args[1].is_a? Selenium::WebDriver::Driver
+            @element = args[1]
           else
-            raise TypeError.new "Can't create Browser decorator for #{element.inspect}"
+            @element = Selenium::WebDriver.for *args
           end
           @browser = @element
         end

data/lib/selenium/webdriver/elements/element.rb

@@ -59,9 +59,12 @@ module Selenium
       end
 
       def send_keys *args
+        # ----- workaround -----
+        # see http://code.google.com/p/selenium/issues/detail?id=440
         if @browser.browser == :chrome
           @element.click
         end
+        # ----- workaround -----
         @element.send_keys *args
       end
 

data/spec/form_populate_spec.rb

@@ -7,37 +7,36 @@ describe "Form" do
   include Aux
 
   it "should populate textbox" do
-    populate_and_check 'http://www.htmlcodetutorial.com/forms/index_famsupp_1.html', 1, {'color' => 'red'}
+    populate_and_check 'http://www.htmlcodetutorial.com/forms/index_famsupp_1.html', {'color' => 'red'}
   end
 
   it "should populate multiple textboxes" do
-    populate_and_check 'http://www.htmlcodetutorial.com/forms/_INPUT_TYPE_PASSWORD.html', 1, {'realname' => 'John Smith', 'mypassword' => 'qwerty'}
+    populate_and_check 'http://www.htmlcodetutorial.com/forms/_INPUT_TYPE_PASSWORD.html', {'realname' => 'John Smith', 'mypassword' => 'qwerty'}
   end
 
   it "should populate checkboxes" do
-    populate_and_check 'http://www.htmlcodetutorial.com/forms/_INPUT_TYPE_CHECKBOX.html', 2, {'mushrooms' => true, 'greenpeppers' => false, 'olives' => true, 'onions' => false}
+    populate_and_check 'http://www.htmlcodetutorial.com/forms/_INPUT_TYPE_CHECKBOX.html', {'mushrooms' => true, 'greenpeppers' => false, 'olives' => true, 'onions' => false}, 1
   end
 
   it "should populate textarea" do
-    populate_and_check 'http://www.htmlcodetutorial.com/forms/_TEXTAREA.html', 1, { 'comments' => 'bla bla bla'}
+    populate_and_check 'http://www.htmlcodetutorial.com/forms/_TEXTAREA.html',{ 'comments' => 'bla bla bla'}
   end
 
   it "should populate select" do
-    populate_and_check 'http://www.htmlcodetutorial.com/forms/_SELECT_onFocus.html', 1, { 'size' => 'm', 'phone' => '+0 123 4567890' }
+    populate_and_check 'http://www.htmlcodetutorial.com/forms/_SELECT_onFocus.html', { 'size' => 'm', 'phone' => '+0 123 4567890' }
   end
 
   it "should populate multiple select" do
-    populate_and_check 'http://www.htmlcodetutorial.com/forms/_SELECT_MULTIPLE.html', 1, { 'toppings' => ['greenpeppers', 'tomatoes'] }
+    populate_and_check 'http://www.htmlcodetutorial.com/forms/_SELECT_MULTIPLE.html', { 'toppings' => ['greenpeppers', 'tomatoes'] }
   end
 
   it "should populate mixed fields" do
-    populate_and_check 'http://www.htmlcodetutorial.com/forms/_SELECT_TABINDEX.html', 1, \
-      { 'realname' => 'John Smith', 'email' => 'smith@example.com', 'dep' => 'dev', }
+    populate_and_check 'http://www.htmlcodetutorial.com/forms/_SELECT_TABINDEX.html', { 'realname' => 'John Smith', 'email' => 'smith@example.com', 'dep' => 'dev', }
   end
 
-  def populate_and_check url, form_no, data
+  def populate_and_check url, data, form_no = 0
     @browser.navigate.to url
-    form = @browser.find_elements(:tag_name => 'form')[form_no]
+    form = @browser.find_element(:id => 'content').find_elements(:tag_name => 'form')[form_no]
     form.populate(data).submit
     expect_result data
   end

data/spec/spec_helper.rb

@@ -3,7 +3,6 @@ $LOAD_PATH.unshift(File.dirname(__FILE__))
 
 require 'rubygems'
 require 'rspec'
-require 'selenium/webdriver'
 require 'selenium/webdriver/elements'
 
 include Selenium::WebDriver::Elements

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 2
+  - 3
   - 0
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors: 
 - Alexei Barantsev
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-17 00:00:00 +03:00
+date: 2011-02-18 00:00:00 +03:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -175,7 +175,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 910147891
+      hash: -945287555
       segments: 
       - 0
       version: "0"