page-object 0.9.2 → 0.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6c01b813ea17360d98a97206dd1dc24a8928c9dd
-  data.tar.gz: 9cc17aafde0461e9c883e97415ae0d642e979f7f
+  metadata.gz: 8c3bfa3ecdb6fcee1e7ba4384511ee6479e86597
+  data.tar.gz: 49404e73c224e8dfa6b68a3e878bce44a9e8c203
 SHA512:
-  metadata.gz: 8de08d4d39d7fb91fdaf4fa9d38a430a649502c1d0ffb47eb92d20e60ec5699c60ea73801828eb4e5a90ccd5774379dd4649151b844f7f4dc166e8589467957f
-  data.tar.gz: ff1478fc9c7438771b0ac4e427a00230950e47e2933c259ebae7ea8a3c7a61b573e010b90b6653d67af2edd7b03b0f9ab413c06d3f1a1717a7c202469ac71272
+  metadata.gz: 2ed2bdca4c6adc2148ee442a28ff39a8a1ffe71b2bdf2287a0fbfab78cb4250b628ca161a41d536c46b95ac8b4ba46c2340ff966f121e496ae6b94ea3a211741
+  data.tar.gz: db51a5b4cf3ef8598355ed6192ff71a84ce6fe452192b0b4450a53f5acf3846a8c05bf2c111d5ff5efa13b398de737475c85cc73725152d14986aafeb4db785b

data/.travis.yml

@@ -1,6 +1,5 @@
 language: ruby
 rvm:
-  - 1.9.2
   - 1.9.3
   - 2.0.0
   - jruby-19mode

data/ChangeLog

@@ -1,3 +1,12 @@
+=== Version 0.9.3 / 2013-10-24
+* Enhancements
+  * Added class_name method to Element
+  * Added select_text method to Element
+  * Added wait_for_expected_title and expected_element_visible methods (Thanks smartkiwi)
+  * Updated to use the latest selenium-webdriver 2.37.0
+* Fixes
+  * Fixed issue with custom widgets on Ruby 1.8.7 (Thanks X Zhang)
+
 === Version 0.9.2 / 2013-8-23
 * Enhancements
   * Added elements method to accessor so one can gen methods for generic collections of elements

data/features/element.feature

@@ -313,3 +313,11 @@ Feature: Elements
   Scenario: Accessing an HTML 5 element using the element method
     When I retrieve the figure using the element
     Then I should see the figure contains an image
+
+  Scenario: Getting the class name for an element
+    When I search for the paragraph by "id"
+    Then I should know the paragraph class is "p_class"
+
+@focus
+  Scenario: Selecting the text for an element
+    Then I should be able to select "Elements" from the paragraph

data/features/multi_elements.feature

@@ -478,7 +478,6 @@ Feature: Multi Elements
     And the title for file field 2 should be "File Field 2"
     And the title for file field 3 should be "File Field 3"
 
-@focus
   Scenario: Selecting multple generic element types
     When I select the multiple elements with a tag label
     Then I should have 3 labels

data/features/step_definitions/paragraph_steps.rb

@@ -18,3 +18,11 @@ end
 Then /^I should see that the paragraph exists$/ do
   @page.p_id?.should == true
 end
+
+Then(/^I should know the paragraph class is "(.*?)"$/) do |class_name|
+  @page.p_id_element.class_name.should == class_name
+end
+
+Then(/^I should be able to select "(.*?)" from the paragraph$/) do |text|
+  @page.p_id_element.select_text text
+end

data/lib/page-object/accessors.rb

@@ -48,6 +48,34 @@ module PageObject
     end
     alias_method :direct_url, :page_url
 
+    #
+    # Creates a method that waits the expected_title of a page to match the actual.
+    # @param [String] expected_title the literal expected title for the page
+    # @param [Regexp] expected_title the expected title pattern for the page
+    # @param [optional, Integer] timeout default value is nil - do not wait
+    # @return [boolean]
+    # @raise An exception if expected_title does not match actual title
+    #
+    # @example Specify 'Google' as the expected title of a page
+    #   expected_title "Google"
+    #   page.has_expected_title?
+    #
+    def wait_for_expected_title(expected_title, timeout=::PageObject.default_element_wait)
+      define_method("wait_for_expected_title?") do
+        page_title = title
+        has_expected_title = (expected_title === page_title)
+        if not has_expected_title and not timeout.nil?
+          wait_until(timeout, "Expected title '#{expected_title}' instead of '#{page_title}'") do 
+            has_expected_title = (expected_title === page_title)
+            has_expected_title
+          end
+        end
+        raise "Expected title '#{expected_title}' instead of '#{page_title}'" unless has_expected_title
+        has_expected_title
+      end
+    end
+
+
     #
     # Creates a method that compares the expected_title of a page against the actual.
     # @param [String] expected_title the literal expected title for the page
@@ -85,6 +113,25 @@ module PageObject
       end
     end
 
+    #
+    # Creates a method that provides a way to initialize a page based upon an expected element to become visible.
+    # This is useful for pages that load dynamic content and might have hidden elements that are not shown.
+    # @param [Symbol] the name given to the element in the declaration
+    # @param [optional, Integer] timeout default value is 5 seconds
+    # @param [optional, boolean] also check that element to be visible if set to true
+    # @return [boolean]
+    #
+    # @example Specify a text box named :address expected on the page within 10 seconds
+    #   expected_element_visible(:address, 10)
+    #   page.has_expected_element_visible?
+    #
+    def expected_element_visible(element_name, timeout=::PageObject.default_element_wait, check_visible=false)
+      define_method("has_expected_element_visible?") do
+        self.respond_to? "#{element_name}_element" and self.send("#{element_name}_element").when_present timeout
+        self.respond_to? "#{element_name}_element" and self.send("#{element_name}_element").when_visible timeout
+      end
+    end
+
     #
     # Identify an element as existing within a frame or iframe.  A frame parameter
     # is passed to the block and must be passed to the other calls to PageObject.

data/lib/page-object/elements/element.rb

@@ -52,6 +52,13 @@ module PageObject
         element.inspect
       end
 
+      #
+      # retrieve the class name for an element
+      #
+      def class_name
+        attribute 'class'
+      end
+
       # @private
       def self.watir_identifier_for identifier
         if should_build_watir_xpath(identifier)

data/lib/page-object/platforms/selenium_webdriver/element.rb

@@ -156,6 +156,15 @@ module PageObject
           bridge.executeScript("return arguments[0].focus()", element)
         end
 
+        #
+        # Select the provided text
+        #
+        def select_text(text)
+          Watir::Atoms.load(:selectText)
+          script = "return (%s).apply(null, arguments)" % ATOMS.fetch(:selectText)
+          bridge.executeScript(script, element, text)
+        end
+
         #
         # Click this element
         #

data/lib/page-object/platforms/watir_webdriver/element.rb

@@ -1,3 +1,5 @@
+require 'watir-webdriver/extensions/select_text'
+
 module PageObject
   module Platforms
     #
@@ -141,6 +143,13 @@ module PageObject
         def focus
           element.focus
         end
+
+        #
+        # Select the provided text
+        #
+        def select_text(text)
+          element.select_text text
+        end
         
         #
         # Waits until the element is present

data/lib/page-object/version.rb

@@ -1,4 +1,4 @@
 module PageObject
   # @private
-  VERSION = "0.9.2"
+  VERSION = "0.9.3"
 end

data/lib/page-object/widgets.rb

@@ -29,7 +29,11 @@ module PageObject
 
     def self.define_accessors(base, widget_tag, widget_class)
       accessors_module = Module.new do
-        define_method widget_tag do |name, identifier={:index => 0}, &block|
+        define_method widget_tag do |name, *identifier_args, &block|
+          
+          identifier = identifier_args.first
+          identifier = {:index => 0} if identifier.nil?
+          
           define_method("#{name}_element") do
             return call_block(&block) if block
             platform.send("#{widget_tag}_for", identifier.clone)

data/page-object.gemspec

@@ -21,7 +21,7 @@ Gem::Specification.new do |s|
   s.require_paths = ["lib"]
 
   s.add_dependency 'watir-webdriver', '>= 0.6.4'
-  s.add_dependency 'selenium-webdriver', '>= 2.35.0'
+  s.add_dependency 'selenium-webdriver', '>= 2.37.0'
   s.add_dependency 'page_navigation', '>= 0.8'
 
   s.add_development_dependency 'rspec', '>= 2.12.0'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: page-object
 version: !ruby/object:Gem::Version
-  version: 0.9.2
+  version: 0.9.3
 platform: ruby
 authors:
 - Jeff Morgan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-23 00:00:00.000000000 Z
+date: 2013-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: 2.35.0
+        version: 2.37.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: 2.35.0
+        version: 2.37.0
 - !ruby/object:Gem::Dependency
   name: page_navigation
   requirement: !ruby/object:Gem::Requirement