selenium_fury 0.6.3 → 1.0.0

data/lib/selenium_fury/selenium_web_driver/generic_elements/generic_element.rb

@@ -0,0 +1,52 @@
+module SeleniumFury
+  module SeleniumWebDriver
+    module PageObjectComponents
+
+      class GenericElement
+        include GenericElementHelpers
+        include ElementWaitHelpers
+
+        def initialize(locator, driver=nil, opt={})
+          @location = locator
+          @driver = driver
+        end
+
+        attr_accessor :location, :driver
+      end
+
+      class CheckboxElement < GenericElement
+        include CheckboxElementHelpers
+        include SelectableElementHelpers
+      end
+
+      class DropDownElement < GenericElement
+        include DropDownHelpers
+        include SelectableElementHelpers
+      end
+
+      class ImageElement < GenericElement
+        include ImageElementHelpers
+      end
+
+      class LinkElement < GenericElement
+        include LinkElementHelpers
+        include SelectableElementHelpers
+      end
+
+      class RadioButtonElement < GenericElement
+        include SelectableElementHelpers
+      end
+
+      class SubmitElement < GenericElement
+        include SelectableElementHelpers
+      end
+
+      class TextElement < GenericElement
+      end
+
+      class TextInputElement < GenericElement
+        include TextElementHelpers
+      end
+    end
+  end
+end

data/lib/selenium_fury/selenium_web_driver/generic_elements/generic_element_helpers.rb

@@ -0,0 +1,110 @@
+module GenericElementHelpers
+  def el
+    raise "Locator at #{location} is not present" unless present?
+    @driver.find_element(location)
+  end
+
+  def present?
+    list.size > 0
+  end
+
+  def visible?
+    el.displayed?
+  end
+
+  def list
+    @driver.find_elements(location)
+  end
+
+  def value
+    el.attribute('value')
+  end
+
+  # Use any methods from WebDriverElement not present
+  def method_missing method_sym, *args
+    if el.respond_to?(method_sym)
+      el.send(method_sym, *args)
+    else
+      raise NoMethodError, "No such  method #{method_sym} for #{self.class}"
+    end
+  end
+end
+
+module ElementWaitHelpers
+  def wait_present(timeout)
+    web_driver_wait(timeout) { present? }
+  end
+
+  def wait_visible(timeout)
+    web_driver_wait(timeout) { visible? }
+  end
+
+  def wait_not_present(timeout)
+    web_driver_wait(timeout) { !present? }
+  end
+
+  def wait_not_visible(timeout)
+    web_driver_wait(timeout) { !visible? }
+  end
+end
+
+module CheckboxElementHelpers
+  def checked(be_selected=true)
+    select unless be_selected == selected?
+  end
+end
+
+
+module DropDownHelpers
+  def selected_option
+    Selenium::WebDriver::Support::Select.new(el).first_selected_option.text
+  end
+
+    # how can be :text, :index, :value
+  def select_option(how=nil, what=nil)
+    raise "Locator at #{location} can not be interacted with" unless visible?
+    el.click if how.nil?
+    Selenium::WebDriver::Support::Select.new(el).select_by(how, what)
+  end
+end
+
+module ImageElementHelpers
+  def text
+    attribute('alt')
+  end
+
+  def source
+    attribute('src')
+  end
+end
+
+module LinkElementHelpers
+  def link
+    attribute('href')
+  end
+end
+
+
+module SelectableElementHelpers
+  def select
+    raise "Locator at #{location} can not be interacted with" unless visible?
+    el.click
+  end
+
+  def selected?
+    el.selected?
+  end
+end
+
+module TextElementHelpers
+  def send_keys(text)
+    raise "Locator at #{location} can not be interacted with" unless visible?
+    el.clear
+    el.send_keys(text)
+  end
+
+  def send_keys!(text)
+    raise "Locator at #{location} can not be interacted with" unless visible?
+    el.send_keys(text)
+  end
+end

data/lib/selenium_fury/selenium_web_driver/page_object_components.rb

@@ -69,7 +69,71 @@ module SeleniumFury
             page_class.new(driver)
           end
         end
+
+
+        def generic_element(element_sym, locator, opt={})
+          define_method(element_sym) do
+            GenericElement.new(locator, driver, opt)
+          end
+          elements << element_sym unless elements.include? element_sym
+        end
+
+        def text_element(element_sym, locator, opt={})
+          define_method(element_sym) do
+            TextElement.new(locator, driver, opt)
+          end
+          elements << element_sym unless elements.include? element_sym
+        end
+
+        def link_element(element_sym, locator, opt={})
+          define_method(element_sym) do
+            LinkElement.new(locator, driver, opt)
+          end
+          elements << element_sym unless elements.include? element_sym
+        end
+
+        def text_input_element(element_sym, locator, opt={})
+          define_method(element_sym) do
+            TextInputElement.new(locator, driver, opt)
+          end
+          elements << element_sym unless elements.include? element_sym
+        end
+
+        def drop_down_element(element_sym, locator, opt={})
+          define_method(element_sym) do
+            DropDownElement.new(locator, driver, opt)
+          end
+          elements << element_sym unless elements.include? element_sym
+        end
+
+        def submit_element(element_sym, locator, opt={})
+          define_method(element_sym) do
+            SubmitElement.new(locator, driver, opt)
+          end
+          elements << element_sym unless elements.include? element_sym
+        end
+
+        def checkbox_element(element_sym, locator, opt={})
+          define_method(element_sym) do
+            CheckboxElement.new(locator, driver, opt)
+          end
+          elements << element_sym unless elements.include? element_sym
+        end
+
+        def image_element(element_sym, locator, opt={})
+          define_method(element_sym) do
+            ImageElement.new(locator, driver, opt)
+          end
+          elements << element_sym unless elements.include? element_sym
+        end
+
+        def radio_button_element(element_sym, locator, opt={})
+          define_method(element_sym) do
+            RadioButtonElement.new(locator, driver, opt)
+          end
+          elements << element_sym unless elements.include? element_sym
+        end
       end
     end
   end
-end
+end

data/lib/selenium_fury/selenium_web_driver/page_validator.rb

@@ -23,13 +23,17 @@ module SeleniumFury
         puts "class #{page_class}"
         page_object=page_class.new(driver)
         raise "Could not find web driver elements in #{page_class}" if page_class.elements.nil?
-        page_class.elements.each do |web_drive_element_name|
-          puts "\tValidating #{web_drive_element_name}"
+        page_class.elements.each do |web_driver_element_name|
+          puts "\tValidating #{web_driver_element_name}"
           begin
-            page_object.method(web_drive_element_name).call
+            if page_object.send(web_driver_element_name).is_a? Selenium::WebDriver::Element
+              page_object.method(web_driver_element_name).call
+            else
+              raise unless page_object.send(web_driver_element_name).present?
+            end
           rescue
-            puts "\t\t\tCould not find #{web_drive_element_name}"
-            missing_elements.push(web_drive_element_name)
+            puts "\t\t\tCould not find #{web_driver_element_name}"
+            missing_elements.push(web_driver_element_name)
           end
         end
         if missing_elements.length > 0
@@ -40,7 +44,6 @@ module SeleniumFury
         end
         raise "Found Missing Elements: #{missing_elements.inspect}" if missing_elements.length > 0
       end
-
     end
   end
 end

data/lib/selenium_fury/version.rb

@@ -1,3 +1,3 @@
 module SeleniumFury
-  VERSION = "0.6.3"
+  VERSION = "1.0.0"
 end

data/lib/selenium_fury.rb

@@ -31,6 +31,9 @@ require "selenium_fury/selenium_web_driver/page_object"
 require "selenium_fury/selenium_web_driver/page_generator"
 require "selenium_fury/selenium_web_driver/page_validator"
 
+require "selenium_fury/selenium_web_driver/generic_elements/generic_element_helpers"
+require "selenium_fury/selenium_web_driver/generic_elements/generic_element"
+
 include SeleniumFury::SeleniumWebDriver::PageGenerator
 include SeleniumFury::SeleniumWebDriver::PageValidator
 

data/spec/selenium_web_driver/generic_elements_spec.rb

@@ -0,0 +1,160 @@
+require 'spec_helper'
+
+describe PageObject do
+
+  let(:test_page) { TestPage.new(driver) }
+
+  before(:each) do
+    load "test_page/test_page.rb"
+    launch_web_driver TEST_PAGE_URL
+  end
+
+  describe SeleniumFury::SeleniumWebDriver::PageObjectComponents::GenericElement do
+
+    it "should return correct object type" do
+      test_page.input_checkbox_element.should be_an SeleniumFury::SeleniumWebDriver::PageObjectComponents::CheckboxElement
+    end
+
+    it "should return correct superclass object type" do
+      test_page.input_checkbox_element.should be_an SeleniumFury::SeleniumWebDriver::PageObjectComponents::GenericElement
+    end
+
+    it "should provide location" do
+      test_page.form_element.location.should == {id: 'form'}
+    end
+
+    it "should return a web driver element" do
+      test_page.form_element.el.should be_an Selenium::WebDriver::Element
+    end
+
+    it "should find visible elements" do
+      test_page.form_element.visible?.should be_true
+    end
+
+    it "should return the value" do
+      test_page.input_button_element.value.should == 'Click me'
+    end
+
+    it "When there is more than one element with the provided locator, it should return an array of all of them" do
+      test_page.listings_element.list.should be_an Array
+      test_page.listings_element.list[0].should be_an Selenium::WebDriver::Element
+    end
+
+    describe Selenium::WebDriver::Element
+
+    it "should return the correct value of a method defined in WebDriver::Element, but not GenericElement class" do
+      test_page.input_button_element.tag_name.should == 'input'
+    end
+
+    it "should throw an WebDriver Element error when using a method not defined in either WebDriver::Element or GenericElement classes" do
+      expect { test_page.input_checkbox.clickit_good }.to raise_error(NoMethodError)
+    end
+  end
+
+
+  describe SeleniumFury::SeleniumWebDriver::PageObjectComponents::CheckboxElement do
+
+    it "should check a checkbox not checked" do
+      test_page.input_checkbox_element.selected?.should be_false
+      test_page.input_checkbox_element.checked(true)
+      test_page.input_checkbox_element.selected?.should be_true
+    end
+
+    it "should leave a checkbox checked when already checked" do
+      test_page.input_checkbox_element.click
+      test_page.input_checkbox_element.selected?.should be_true
+      test_page.input_checkbox_element.checked(true)
+      test_page.input_checkbox_element.selected?.should be_true
+    end
+
+    it "should uncheck a checkbox when checked" do
+      test_page.input_checkbox_element.click
+      test_page.input_checkbox_element.selected?.should be_true
+      test_page.input_checkbox_element.checked(false)
+      test_page.input_checkbox_element.selected?.should be_false
+    end
+
+    it "should leave a checkbox alone when already checked" do
+      test_page.input_checkbox_element.selected?.should be_false
+      test_page.input_checkbox_element.checked(false)
+      test_page.input_checkbox_element.selected?.should be_false
+    end
+  end
+
+
+  describe SeleniumFury::SeleniumWebDriver::PageObjectComponents::DropDownElement do
+
+    it "should select from a dropdown by value" do
+      test_page.select_element.select_option(:value, 'mercedes')
+      test_page.select_element.selected_option.should == 'Mercedes'
+    end
+
+    it "should select from a dropdown by text" do
+      what = 'Mercedes'
+      test_page.select_element.select_option(:text, what)
+      test_page.select_element.selected_option.should == what
+    end
+
+    it "should select from a dropdown by index" do
+      test_page.select_element.select_option(:index, 3)
+      test_page.select_element.selected_option.should == 'Audi'
+    end
+  end
+
+
+  describe SeleniumFury::SeleniumWebDriver::PageObjectComponents::ImageElement do
+
+    it "should return the alternate text for an image" do
+      test_page.input_image_element.text.should == 'input image'
+    end
+
+    it 'should return the source of an image' do
+      test_page.input_image_element.attribute('src').include?('test_page/spacer.gif')
+    end
+  end
+
+
+  describe SeleniumFury::SeleniumWebDriver::PageObjectComponents::LinkElement do
+
+    it "should return the link location" do
+      test_page.link_element.link.should == 'http://news.ycombinator.com/'
+    end
+  end
+
+
+  describe SelectableElementHelpers do
+
+    it "should properly submit a form" do
+      text = "Hey buddy"
+      test_page.input_message_element.send_keys(text)
+      test_page.input_msg_button_element.select
+      test_page.message_element.text.should == text
+    end
+
+    it "should verify option is not selected" do
+      test_page.input_checkbox_element.selected?.should be_false
+    end
+
+    it "should verify option is selected" do
+      test_page.input_checkbox_element.select
+      test_page.input_checkbox_element.selected?.should be_true
+    end
+  end
+
+
+  describe TextElementHelpers do
+
+    it "should clear and write text" do
+      text = "Hey buddy"
+      test_page.textarea_element.send_keys(text)
+      test_page.textarea_element.value.should == text
+    end
+
+    it "should write text without clearing" do
+      existing_text = "This is a textarea field.\n    "
+      new_text = "Hey buddy"
+      test_page.textarea_element.send_keys!(new_text)
+      test_page.textarea_element.value.should == existing_text+new_text
+    end
+  end
+end

data/spec/selenium_web_driver/page_object_spec.rb

@@ -42,7 +42,7 @@ describe PageObject do
     launch_web_driver TEST_PAGE_URL
     test_page = TestPage.new(driver)
     test_page.class.elements.should_not be_nil
-    test_page.class.elements.should have(15).elements
+    test_page.class.elements.should have(37).elements
     test_page.method(test_page.class.elements[0]).call.class.should == Selenium::WebDriver::Element
   end
 

data/spec/test_page/test_page.html

@@ -8,9 +8,12 @@
            document.getElementById('message').innerHTML = document.form.msgtext.value
         }
     </script>
+    <style>p {display:none}</style>
 </head>
 <body>
 
+<p id="not_visible">This should not be visible by default</p>
+
 <div id="message"></div>
 
 <ul id="element_list">
@@ -43,7 +46,7 @@
     <input id="input_hidden" type="hidden"/>
     <br/>
     <label for="input_image">Image</label>
-    <input id="input_image" type="image" alt="input image"/>
+    <input id="input_image" type="image" alt="input image" src="spacer.gif"/>
     <br/>
     <label for="input_password">Password</label>
     <input id="input_password" type="password"/>

data/spec/test_page/test_page.rb

@@ -17,6 +17,39 @@ class TestPage < PageObject
 
   element_list :listings, { css: 'li.listing' }
 
+
+  generic_element       :form_element, {id: 'form'}
+  generic_element       :input_file_element, {id: 'input_file'}
+  generic_element       :input_hidden_element, {id: 'input_hidden'}
+  generic_element       :message_element, {id: 'message'}
+  generic_element       :message_text_element, {name: 'msgtext'}
+  generic_element       :fieldset_element, {css: 'fieldset'}
+  generic_element       :listings_element, {css: 'li.listing'}
+  generic_element       :not_visible_element, {id: 'not_visible'}
+
+  checkbox_element      :input_checkbox_element, {id: 'input_checkbox'}
+
+  drop_down_element     :select_element, {id: 'select'}
+
+  image_element         :input_image_element, {id: 'input_image'}
+
+  link_element          :link_element, {id: 'link111111'}
+
+  radio_button_element  :input_radio_element, {id: 'input_radio'}
+
+  submit_element        :input_button_element, {id: 'input_button'}
+  submit_element        :input_msg_button_element, {id: 'input_msg_button'}
+  submit_element        :input_reset_element, {id: 'input_reset'}
+  submit_element        :input_submit_element, {id: 'input_submit'}
+
+  text_element          :input_message_label_element, {css: 'label'}
+
+  text_input_element    :input_message_element, {id: 'input_message'}
+  text_input_element    :input_password_element, {id: 'input_password'}
+  text_input_element    :input_text_element, {id: 'input_text'}
+  text_input_element    :textarea_element, {id: 'textarea'}
+
+
   def click_check_box
     input_checkbox.click
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: selenium_fury
 version: !ruby/object:Gem::Version
-  version: 0.6.3
+  version: 1.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-01 00:00:00.000000000 Z
+date: 2013-05-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -133,6 +133,8 @@ files:
 - lib/selenium_fury/common/selenium_api_chooser.rb
 - lib/selenium_fury/selenium_web_driver/create_selenium_web_driver.rb
 - lib/selenium_fury/selenium_web_driver/element_finder.rb
+- lib/selenium_fury/selenium_web_driver/generic_elements/generic_element.rb
+- lib/selenium_fury/selenium_web_driver/generic_elements/generic_element_helpers.rb
 - lib/selenium_fury/selenium_web_driver/page_generator.rb
 - lib/selenium_fury/selenium_web_driver/page_object.rb
 - lib/selenium_fury/selenium_web_driver/page_object_components.rb
@@ -142,10 +144,12 @@ files:
 - spec/common/page_parser_spec.rb
 - spec/common/selenium_api_chooser_spec.rb
 - spec/selenium_web_driver/element_finder_spec.rb
+- spec/selenium_web_driver/generic_elements_spec.rb
 - spec/selenium_web_driver/page_generator_spec.rb
 - spec/selenium_web_driver/page_object_spec.rb
 - spec/selenium_web_driver/page_validator_spec.rb
 - spec/spec_helper.rb
+- spec/test_page/Spacer.gif
 - spec/test_page/test_page.html
 - spec/test_page/test_page.rb
 - spec/test_page/test_page_custom_generator_configuration.rb
@@ -163,7 +167,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 2135389141801828284
+      hash: -4010786722862812326
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -172,7 +176,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 2135389141801828284
+      hash: -4010786722862812326
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.25
@@ -189,10 +193,12 @@ test_files:
 - spec/common/page_parser_spec.rb
 - spec/common/selenium_api_chooser_spec.rb
 - spec/selenium_web_driver/element_finder_spec.rb
+- spec/selenium_web_driver/generic_elements_spec.rb
 - spec/selenium_web_driver/page_generator_spec.rb
 - spec/selenium_web_driver/page_object_spec.rb
 - spec/selenium_web_driver/page_validator_spec.rb
 - spec/spec_helper.rb
+- spec/test_page/Spacer.gif
 - spec/test_page/test_page.html
 - spec/test_page/test_page.rb
 - spec/test_page/test_page_custom_generator_configuration.rb