selenium_fury 1.0.1 → 1.0.2

data/.ruby-gemset

@@ -0,0 +1 @@
+selenium-fury

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.0.0

data/Gemfile

@@ -1,4 +1,4 @@
-source :rubygems
+source 'https://rubygems.org' 
 
 # Specify your gem's dependencies in selenium_fury.gemspec
 gemspec

data/lib/selenium/webdriver/common/timeouts.rb

@@ -0,0 +1,19 @@
+module Selenium
+  module WebDriver
+    class Timeouts
+
+      def initialize(bridge)
+        @bridge = bridge
+      end
+
+      def implicit_wait
+        @implicit_wait || 0
+      end
+
+      def implicit_wait=(seconds)
+        @bridge.setImplicitWaitTimeout Integer(seconds * 1000)
+        @implicit_wait = seconds || 0
+      end
+    end
+  end
+end

data/lib/selenium_fury.rb

@@ -18,6 +18,8 @@ require "selenium_fury/version"
 require 'rubygems'
 require 'bundler'
 
+require "selenium/webdriver/common/timeouts"
+
 require "selenium-webdriver"
 require "selenium-client"
 require 'nokogiri'

data/lib/selenium_fury/selenium_web_driver/create_selenium_web_driver.rb

@@ -25,11 +25,10 @@ module SeleniumFury
 
       # @param url [string]
       # @return [Selenium::WebDriver::Driver]
-      def launch_web_driver url
+      def launch_web_driver url=nil
         @driver = Selenium::WebDriver.for :chrome
-        @driver.navigate.to url
+        @driver.navigate.to url unless url.nil?
       end
-
     end
   end
-end
+end

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

@@ -10,15 +10,29 @@ module SeleniumFury
           @location = locator
           @driver = driver
           @tags = opt[:tags]
-          @validate = opt[:validate] != false  # true if nil
+          # Should validate if opt[:validate] is nil, should not validate if doing dynamic matchin
+          @validate = opt[:validate] != false  && !locator.values.first.match(/\^([^=].*?)\$/)
+          # This is different from implicit_wait. This explicitly waits for this element, not for entire driver session.
+          @wait = 10 || opt[:wait]
         end
 
-        attr_accessor :location, :driver, :tags
+        attr_accessor :location, :driver, :tags, :wait, :implicit_wait
         attr_writer :validate
 
         def validate?
           @validate
         end
+
+        def update_locator(variables)
+          locator_value = @location.values.first
+          variables.each { |key, value|
+            locator_value.scan(/\^([^=]\w*)\$/).flatten.each { |match|
+              locator_value.gsub!("^#{match}$", value.to_s) if match == key.to_s
+            }
+          }
+          self
+        end
+
       end
 
       class CheckboxElement < GenericElement
@@ -54,6 +68,10 @@ module SeleniumFury
       class TextInputElement < GenericElement
         include TextElementHelpers
       end
+
+      class SelectableElement < GenericElement
+        include SelectableElementHelpers
+      end
     end
   end
 end

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

@@ -5,9 +5,15 @@ module GenericElementHelpers
   end
 
   def present?
-    list.size > 0
+    # Set implicit wait to zero so it doesn't wait that time each method call
+    implicit_wait = driver.manage.timeouts.implicit_wait
+    driver.manage.timeouts.implicit_wait = 0
+    present = list.size > 0
+    driver.manage.timeouts.implicit_wait = implicit_wait
+    present
   end
 
+  # Raises error if not already present
   def visible?
     el.displayed?
   end
@@ -20,6 +26,10 @@ module GenericElementHelpers
     el.attribute('value')
   end
 
+  def move_to
+    @driver.action.move_to(el).perform
+  end
+
   # Use any methods from WebDriverElement not present
   def method_missing method_sym, *args
     if el.respond_to?(method_sym)
@@ -31,26 +41,37 @@ module GenericElementHelpers
 end
 
 module ElementWaitHelpers
-  def web_driver_wait(opt=10, &condition)
-    options={}
-    opt.kind_of?(Integer) ? options[:timeout] = opt : options = opt
-    Selenium::WebDriver::Wait.new(options).until { condition.call }
+  def wait_for(opts={}, &condition)
+    opts[:timeout] ||= @wait
+    opts[:message] ||= ''
+    Selenium::WebDriver::Wait.new(opts).until { condition.call }
+  end
+
+  def wait_present(timeout=@wait)
+    wait_for(timeout: timeout) { present? }
+  end
+
+  def wait_not_present(timeout=@wait)
+    wait_for(timeout: timeout) { !present? }
   end
 
-  def wait_present(timeout)
-    web_driver_wait(timeout) { present? }
+  def wait_visible(timeout=@wait)
+    wait_present(timeout)
+    wait_visible!(timeout)
   end
 
-  def wait_visible(timeout)
-    web_driver_wait(timeout) { visible? }
+  # Raises error if not present
+  def wait_visible!(timeout=@wait)
+    wait_for(timeout: timeout) { visible? }
   end
 
-  def wait_not_present(timeout)
-    web_driver_wait(timeout) { !present? }
+  def wait_not_visible(timeout=@wait)
+    wait_for(timeout: timeout) { !present? || !visible? }
   end
 
-  def wait_not_visible(timeout)
-    web_driver_wait(timeout) { !visible? }
+  # Raises error if not present
+  def wait_not_visible!(timeout=@wait)
+    wait_for(timeout: timeout) { !visible? }
   end
 end
 
@@ -60,7 +81,6 @@ module CheckboxElementHelpers
   end
 end
 
-
 module DropDownHelpers
   def selected_option
     Selenium::WebDriver::Support::Select.new(el).first_selected_option.text
@@ -76,30 +96,52 @@ end
 
 module ImageElementHelpers
   def text
-    attribute('alt')
+    el.attribute('alt')
   end
 
   def source
-    attribute('src')
+    el.attribute('src')
   end
 end
 
 module LinkElementHelpers
   def link
-    attribute('href')
+    el.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
+
+    # Raises error if not selectable
+  def select!
+    raise "Locator at #{location} is not visible" unless visible?
+    begin
+      el.click
+    rescue
+      raise "Locator at #{location} can not be interacted with" unless visible?
+    end
+    check_errors
+  end
+
+  def select
+    wait_visible
+    begin
+      el.click
+    rescue Exception => e
+      retry_select(e)
+    end
+    check_errors
+  end
+
+  # Overwrite in your project if desired
+  def check_errors; end
+  def retry_select(exception)
+    raise "Locator at #{location} can not be interacted with - Failed with #{exception}"
+  end
 end
 
 module TextElementHelpers

data/lib/selenium_fury/selenium_web_driver/page_object_components.rb

@@ -133,6 +133,13 @@ module SeleniumFury
           end
           elements << element_sym unless elements.include? element_sym
         end
+
+        def selectable_element(element_sym, locator, opt={})
+          define_method(element_sym) do
+            SelectableElement.new(locator, driver, opt)
+          end
+          elements << element_sym unless elements.include? element_sym
+        end
       end
     end
   end

data/lib/selenium_fury/version.rb

@@ -1,3 +1,3 @@
 module SeleniumFury
-  VERSION = "1.0.1"
+  VERSION = "1.0.2"
 end

data/spec/selenium/webdriver/common/timeouts_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+describe Selenium::WebDriver::Timeouts do
+
+  it 'should allow reading of implict wait' do
+    launch_web_driver
+    driver.manage.timeouts.implicit_wait.should == 0
+    driver.manage.timeouts.implicit_wait = 2
+    driver.manage.timeouts.implicit_wait.should == 2
+  end
+end

data/spec/selenium_web_driver/generic_elements_spec.rb

@@ -5,48 +5,63 @@ describe PageObject do
   let(:test_page) { TestPage.new(driver) }
 
   before(:each) do
-    load "test_page/test_page.rb"
+    load 'test_page/test_page.rb'
     launch_web_driver TEST_PAGE_URL
   end
 
+  describe 'Dynamic Locators' do
+
+    it 'should allow a single dynamic selection of an element with id' do
+      specific_element = test_page.dynamic_locator_id.update_locator(id: 222222)
+      specific_element.location.should == {id: 'link222222'}
+      specific_element.link.should == 'http://yahoo.com/'
+    end
+
+    it 'should allow multiple dynamic selections of an element with css' do
+      specific_element = test_page.dynamic_locator_css.update_locator(locator: 'id', id: 333333)
+      specific_element.location.should == {css: "a[id='link333333']"}
+      specific_element.link.should == 'http://google.com/'
+    end
+  end
+
   describe SeleniumFury::SeleniumWebDriver::PageObjectComponents::GenericElement do
 
-    it "should return correct object type" 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
+    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
+    it 'should provide location' do
       test_page.form_element.location.should == {id: 'form'}
     end
 
-    it "should return a web driver element" do
+    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
+    it 'should find visible elements' do
       test_page.form_element.visible?.should be_true
     end
 
-    it "should return the value" do
+    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
+    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
+    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
+    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
@@ -54,27 +69,27 @@ describe PageObject do
 
   describe SeleniumFury::SeleniumWebDriver::PageObjectComponents::CheckboxElement do
 
-    it "should check a checkbox not checked" 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
+    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
+    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
+    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
@@ -84,18 +99,18 @@ describe PageObject do
 
   describe SeleniumFury::SeleniumWebDriver::PageObjectComponents::DropDownElement do
 
-    it "should select from a dropdown by value" 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
+    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
+    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
@@ -104,7 +119,7 @@ describe PageObject do
 
   describe SeleniumFury::SeleniumWebDriver::PageObjectComponents::ImageElement do
 
-    it "should return the alternate text for an image" do
+    it 'should return the alternate text for an image' do
       test_page.input_image_element.text.should == 'input image'
     end
 
@@ -116,45 +131,191 @@ describe PageObject do
 
   describe SeleniumFury::SeleniumWebDriver::PageObjectComponents::LinkElement do
 
-    it "should return the link location" do
+    it 'should return the link location' do
       test_page.link_element.link.should == 'http://news.ycombinator.com/'
     end
   end
 
 
   describe SelectableElementHelpers do
+    let(:wait_element) { WaitElement.new(driver) }
+
+    class WaitElement < PageObject
+      generic_element :not_a_element, {id: 'not a element'}
+      selectable_element :not_visible, {id: 'not_visible'}
+    end
 
-    it "should properly submit a form" do
-      text = "Hey buddy"
+    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
+    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
+    it 'should verify option is selected' do
       test_page.input_checkbox_element.select
       test_page.input_checkbox_element.selected?.should be_true
     end
+
+    it 'should throw not visible error if element to select is not visible and ! is specified' do
+      expect {wait_element.not_visible.select!}.
+      to raise_exception(RuntimeError, "Locator at #{wait_element.not_visible.location.to_s} is not visible")
+    end
+
+    it 'should throw timeout error if element to select is not visible and ! is not specified' do
+      expect {wait_element.not_visible.select}.
+      to raise_exception(Selenium::WebDriver::Error::TimeOutError)
+    end
   end
 
 
   describe TextElementHelpers do
 
-    it "should clear and write text" do
-      text = "Hey buddy"
+    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
+    it 'should write text without clearing' do
       existing_text = "This is a textarea field.\n    "
-      new_text = "Hey buddy"
+      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
+
+  describe ElementWaitHelpers do
+    class TestPage < PageObject
+      generic_element :not_a_element, {id: 'not a element'}
+      generic_element :not_visible, {id: 'not_visible'}
+    end
+
+    context 'With implicit waits' do
+      it 'should error immediately with traditional element check and implicit wait not set' do
+        start_time = Time.now
+        expect { driver.find_element(id: 'not a element') }.
+            to raise_exception(Selenium::WebDriver::Error::NoSuchElementError, 'The element could not be found')
+        (Time.now-start_time).should < 1
+      end
+
+      it 'should error after waiting the time set by implicit wait' do
+        driver.manage.timeouts.implicit_wait = 2
+
+        start_time = Time.now
+        expect { driver.find_element(id: 'not a element') }.
+            to raise_exception(Selenium::WebDriver::Error::NoSuchElementError, 'The element could not be found')
+        (Time.now-start_time).should > 2
+      end
+
+      it 'should ignore implicit wait for new element check, and reset wait after done' do
+        implicit_wait = 2
+        driver.manage.timeouts.implicit_wait = implicit_wait
+        test_element = test_page.not_a_element
+        test_element.implicit_wait = implicit_wait
+
+        start_time = Time.now
+        test_element.present?
+        (Time.now-start_time).should < 1
+
+        start_time = Time.now
+        expect { driver.find_element(id: 'not a element') }.
+            to raise_exception(Selenium::WebDriver::Error::NoSuchElementError, 'The element could not be found')
+        (Time.now-start_time).should > 2
+      end
+    end
+
+    context 'With explicit waits' do
+      it 'should wait for something with wait time and message parameters set' do
+        start_time = Time.now
+        begin
+          test_page.not_a_element.wait_for(timeout: 2, message: 'This is the message to return') { false }
+          raise 'This should have failed'
+        rescue Exception => e
+          e.message.should == 'This is the message to return'
+          time_taken = (Time.now-start_time)
+          time_taken.should > 2
+          time_taken.should < 10
+        end
+      end
+
+      it 'should wait for something with wait time set but no message' do
+        start_time = Time.now
+        begin
+          test_page.not_a_element.wait_for(timeout: 2) { false }
+          raise 'This should have failed'
+        rescue Exception => e
+          e.message.should == ''
+          time_taken = (Time.now-start_time)
+          time_taken.should > 2
+          time_taken.should < 10
+        end
+      end
+
+      it 'should wait for something with message parameters set but not wait time' do
+        start_time = Time.now
+        begin
+          test_page.not_a_element.wait_for(message: 'This is the message to return') { false }
+          raise 'This should have failed'
+        rescue Exception => e
+          e.message.should == 'This is the message to return'
+          (Time.now-start_time).should > 10
+        end
+      end
+
+      it 'should wait for something with no parameters set' do
+        start_time = Time.now
+        begin
+          test_page.not_a_element.wait_for { false }
+          raise 'This should have failed'
+        rescue Exception => e
+          e.message.should == ''
+          (Time.now-start_time).should > 10
+        end
+      end
+
+      it 'should return the value in of the condition' do
+        result = test_page.not_a_element.wait_for { true }
+        result.should be_a TrueClass
+      end
+
+      it 'should error on missing element if specify !' do
+        start_time = Time.now
+        expect { test_page.not_a_element.wait_visible! }.
+            to raise_exception(RuntimeError, "Locator at #{test_page.not_a_element.location.to_s} is not present")
+        (Time.now-start_time).should < 1
+      end
+
+      it 'should timeout without erroring on missing element if do not specify !' do
+        start_time = Time.now
+        expect { test_page.not_a_element.wait_visible(2) }.
+            to raise_exception(Selenium::WebDriver::Error::TimeOutError)
+        time_taken = (Time.now-start_time)
+        time_taken.should > 2
+        time_taken.should < 10
+      end
+
+      it 'should wait for element present and not visible for !' do
+        start_time = Time.now
+        expect { test_page.not_visible.wait_visible(2) }.
+            to raise_exception(Selenium::WebDriver::Error::TimeOutError)
+        time_taken = (Time.now-start_time)
+        time_taken.should > 2
+        time_taken.should < 10
+      end
+
+      it 'should wait for element present and not visible without !' do
+        start_time = Time.now
+        expect { test_page.not_visible.wait_visible(2) }.
+            to raise_exception(Selenium::WebDriver::Error::TimeOutError)
+        time_taken = (Time.now-start_time)
+        time_taken.should > 2
+        time_taken.should < 10
+      end
+    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(37).elements
+    test_page.class.elements.should have(39).elements
     test_page.method(test_page.class.elements[0]).call.class.should == Selenium::WebDriver::Element
   end
 

data/spec/test_page/test_page.rb

@@ -34,6 +34,8 @@ class TestPage < PageObject
   image_element         :input_image_element, {id: 'input_image'}
 
   link_element          :link_element, {id: 'link111111'}
+  link_element          :dynamic_locator_css, {css: "a[^locator$='link^id$']"}
+  link_element          :dynamic_locator_id, {id: 'link^id$'}
 
   radio_button_element  :input_radio_element, {id: 'input_radio'}
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: selenium_fury
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-31 00:00:00.000000000 Z
+date: 2013-06-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -116,7 +116,8 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
-- .rvmrc
+- .ruby-gemset
+- .ruby-version
 - Changelog.md
 - Gemfile
 - LICENSE
@@ -128,6 +129,7 @@ files:
 - features/support/env.rb
 - features/support/hooks.rb
 - features/validate_page_object.feature
+- lib/selenium/webdriver/common/timeouts.rb
 - lib/selenium_fury.rb
 - lib/selenium_fury/common/page_parser.rb
 - lib/selenium_fury/selenium_web_driver/create_selenium_web_driver.rb
@@ -141,6 +143,7 @@ files:
 - lib/selenium_fury/version.rb
 - selenium_fury.gemspec
 - spec/common/page_parser_spec.rb
+- spec/selenium/webdriver/common/timeouts_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
@@ -165,7 +168,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 417938360726335985
+      hash: -1088754158506320944
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -174,7 +177,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 417938360726335985
+      hash: -1088754158506320944
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.25
@@ -189,6 +192,7 @@ test_files:
 - features/support/hooks.rb
 - features/validate_page_object.feature
 - spec/common/page_parser_spec.rb
+- spec/selenium/webdriver/common/timeouts_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

data/.rvmrc

@@ -1,3 +0,0 @@
-rvm use ruby-1.9.3-p362@selenium_fury --create
-
-