centric_page_object 2.3.1

data/lib/page-object/element_locators.rb

@@ -0,0 +1,21 @@
+require 'page-object/locator_generator'
+
+module PageObject
+  module  ElementLocators
+
+    def self.included(cls)
+      ::PageObject::LocatorGenerator.generate_locators(cls)
+    end
+
+    def element(tag, identifier={:index => 0})
+      platform.element_for(tag, identifier.clone)
+    end
+
+    private
+
+    def locator(identifier)
+      identifier[0] ? identifier[0] : {:index => 0}
+    end
+
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class Area < Element
+
+    end
+
+    ::PageObject::Elements.type_to_class[:area] = ::PageObject::Elements::Area
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class Audio < Media
+
+    end
+
+    ::PageObject::Elements.type_to_class[:audio] = ::PageObject::Elements::Audio
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class Bold < Element
+
+    end
+
+    ::PageObject::Elements.tag_to_class[:b] = ::PageObject::Elements::Bold
+  end
+end

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

@@ -0,0 +1,12 @@
+module PageObject
+  module Elements
+    class Button < Element
+
+    end
+
+    ::PageObject::Elements.type_to_class[:submit] = ::PageObject::Elements::Button
+    ::PageObject::Elements.type_to_class[:image] = ::PageObject::Elements::Button
+    ::PageObject::Elements.type_to_class[:button] = ::PageObject::Elements::Button
+    ::PageObject::Elements.type_to_class[:reset] = ::PageObject::Elements::Button
+  end
+end

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

@@ -0,0 +1,10 @@
+module PageObject
+  module Elements
+    class Canvas < Element
+
+    end
+
+    ::PageObject::Elements.type_to_class[:canvas] = ::PageObject::Elements::Canvas
+  end
+end
+

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class CheckBox < Element
+
+    end
+
+    ::PageObject::Elements.type_to_class[:checkbox] = ::PageObject::Elements::CheckBox
+  end
+end

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

@@ -0,0 +1,10 @@
+module PageObject
+  module Elements
+    class DateField < Element
+
+    end
+
+    ::PageObject::Elements.type_to_class[:date] = ::PageObject::Elements::DateField
+  end
+end
+

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class Div < Element
+
+    end
+
+    ::PageObject::Elements.tag_to_class[:div] = ::PageObject::Elements::Div
+  end
+end

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

@@ -0,0 +1,212 @@
+require 'page-object/nested_elements'
+
+module PageObject
+  module Elements
+    #
+    # Contains functionality that is common across all elements.
+    #
+    # @see PageObject::Platforms::Watir::Element for the Watir version of all common methods
+    #
+    class Element
+      include ::PageObject::NestedElements
+
+      attr_reader :element
+
+      def initialize(element)
+        @element = element
+        @platform = PageObject::Platforms::Watir::PageObject.new(@element)
+      end
+
+      #
+      # return true if the element is not enabled
+      #
+      def disabled?
+        not enabled?
+      end
+
+      #
+      # return true if the element exists and is visible
+      #
+      def present?
+        element.present?
+      end
+
+      def drag_and_drop_on(droppable)
+        droppable_native = droppable.kind_of?(PageObject::Elements::Element) ? droppable.element : droppable
+        element.drag_and_drop_on(droppable_native)
+      end
+
+      #
+      # specify plural form of element
+      #
+      def self.plural_form
+        "#{self.to_s.split('::')[-1].
+            gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2').
+            gsub(/([a-z\d])([A-Z])/, '\1_\2').
+            tr("-", "_").
+            downcase}s"
+      end
+
+      #
+      # Keeps checking until the element is visible
+      #
+      # @param [Integer] (defaults to: 5) seconds to wait before timing out
+      #
+      def check_visible(timeout=::PageObject.default_element_wait)
+        timed_loop(timeout) do |element|
+          element.present?
+        end
+      end
+
+      #
+      # Keeps checking until the element exists
+      #
+      # @param [Integer] (defaults to: 5) seconds to wait before timing out
+      #
+      def check_exists(timeout=::PageObject.default_element_wait)
+        timed_loop(timeout) do |element|
+          element.exists?
+        end
+      end
+
+      #
+      # compare this element to another to determine if they are equal
+      #
+      def ==(other)
+        other.is_a? self.class and element == other.element
+      end
+
+      #
+      # find the parent element
+      #
+      def parent(opt = {})
+        parent = element.parent(opt)
+        pageobject_wrapper(parent)
+      end
+
+      #
+      # Return the element that exists at the same level of the DOM
+      # immediately prior to this element
+      #
+      def preceding_sibling(opt = {})
+        sibling = element.preceding_sibling(opt)
+        pageobject_wrapper(sibling)
+      end
+
+      #
+      # Return the element that exists at the same level of the DOM
+      # immediately after this element
+      #
+      def following_sibling(opt={})
+        sibling = element.following_sibling(opt)
+        pageobject_wrapper(sibling)
+      end
+
+      #
+      # Return all elements that are direct children of this element's parent
+      #
+      def siblings(opt={})
+        siblings = element.siblings(opt)
+        siblings.collect {|sibling| pageobject_wrapper(sibling)}
+      end
+
+      #
+      # Return all elements that are children of this element
+      #
+      def children(opt={})
+        children = element.children(opt)
+        children.collect {|child| pageobject_wrapper(child)}
+      end
+
+      #
+      # Return all elements that exist at the same level of the DOM
+      # immediately prior to this element
+      #
+      def preceding_siblings(opt={})
+        siblings = element.preceding_siblings(opt)
+        siblings.collect {|sibling| pageobject_wrapper(sibling)}
+      end
+
+      #
+      # Return all elements that exist at the same level of the DOM
+      # immediately after this element
+      #
+      def following_siblings(opt={})
+        siblings = element.following_siblings(opt)
+        siblings.collect {|sibling| pageobject_wrapper(sibling)}
+      end
+
+      #
+      # Waits until the element is present
+      #
+      # @param [Integer] (defaults to: 5) seconds to wait before timing out
+      #
+      def when_present(timeout=::PageObject.default_element_wait)
+        element.wait_until(timeout: timeout, message: "Element not present in #{timeout} seconds", &:present?)
+        self
+      end
+      alias_method :when_visible, :when_present
+
+      #
+      # Waits until the element is not present
+      #
+      # @param [Integer] (defaults to: 5) seconds to wait before
+      # timing out
+      #
+      def when_not_present(timeout=::PageObject.default_element_wait)
+        element.wait_while(timeout: timeout, message: "Element still present in #{timeout} seconds", &:present?)
+      end
+      alias_method :when_not_visible, :when_not_present
+
+      #
+      # Waits until the block returns true
+      #
+      # @param [Integer] (defaults to: 5) seconds to wait before timing out
+      # @param [String] the message to display if the event timeouts
+      # @param the block to execute when the event occurs
+      #
+      def wait_until(timeout=::PageObject.default_element_wait, message=nil, &block)
+        element.wait_until(timeout: timeout, message: message, &block)
+      end
+
+      def name
+        element.attribute(:name)
+      end
+
+      # @private
+      # delegate calls to driver element
+      def method_missing(method, *args, &block)
+        if element.respond_to?(method)
+          element.send(method, *args, &block)
+        else
+          super
+        end
+      end
+
+      def respond_to_missing?(m,*args)
+        element.respond_to?(m) || super
+      end
+
+      protected
+
+      def pageobject_wrapper(watir_object)
+        type = element.type if watir_object.tag_name.to_sym == :input
+        cls = ::PageObject::Elements.element_class_for(watir_object.tag_name, type)
+        cls.new(watir_object.to_subtype)
+      end
+
+      private
+
+      def timed_loop(timeout)
+        end_time = ::Time.now + timeout
+        until ::Time.now > end_time
+          result = yield(self)
+          return result if result
+          sleep 0.5
+        end
+        false
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class FileField < Element
+
+    end
+
+    ::PageObject::Elements.type_to_class[:file] = ::PageObject::Elements::FileField
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class Form < Element
+
+    end
+
+    ::PageObject::Elements.tag_to_class[:form] = ::PageObject::Elements::Form
+  end
+end

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

@@ -0,0 +1,14 @@
+module PageObject
+  module Elements
+    class Heading < Element
+
+    end
+
+    ::PageObject::Elements.tag_to_class[:h1] = ::PageObject::Elements::Heading
+    ::PageObject::Elements.tag_to_class[:h2] = ::PageObject::Elements::Heading
+    ::PageObject::Elements.tag_to_class[:h3] = ::PageObject::Elements::Heading
+    ::PageObject::Elements.tag_to_class[:h4] = ::PageObject::Elements::Heading
+    ::PageObject::Elements.tag_to_class[:h5] = ::PageObject::Elements::Heading
+    ::PageObject::Elements.tag_to_class[:h6] = ::PageObject::Elements::Heading
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class HiddenField < Element
+
+    end
+
+    ::PageObject::Elements.type_to_class[:hidden] = ::PageObject::Elements::HiddenField
+  end
+end

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

@@ -0,0 +1,10 @@
+module PageObject
+  module Elements
+    class Image < Element
+
+    end
+
+    ::PageObject::Elements.tag_to_class[:img] = ::PageObject::Elements::Image
+    
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class Italic < Element
+
+    end
+
+    ::PageObject::Elements.tag_to_class[:i] = ::PageObject::Elements::Italic
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class Label < Element
+
+    end
+
+    ::PageObject::Elements.tag_to_class[:label] = ::PageObject::Elements::Label
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class Link < Element
+
+    end
+    
+    ::PageObject::Elements.tag_to_class[:a] = ::PageObject::Elements::Link
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class ListItem < Element
+
+    end
+
+    ::PageObject::Elements.tag_to_class[:li] = ::PageObject::Elements::ListItem
+  end
+end

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

@@ -0,0 +1,11 @@
+module PageObject
+  module Elements
+    class Media < Element
+
+      def has_controls?
+        attribute(:controls)
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class Option < Element
+
+    end
+
+    ::PageObject::Elements.tag_to_class[:option] = ::PageObject::Elements::Option
+  end
+end

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

@@ -0,0 +1,43 @@
+
+module PageObject
+  module Elements
+    class OrderedList < Element
+      include Enumerable
+
+      #
+      # iterator that yields with a PageObject::Elements::ListItem
+      #
+      # @return [PageObject::Elements::ListItem]
+      #
+      def each(&block)
+        list_items.each(&block)
+      end
+
+      #
+      # Return the PageObject::Elements::ListItem for the index provided.  Index
+      # is zero based.
+      #
+      # @return [PageObject::Elements::ListItem]
+      #
+      def [](idx)
+        list_items[idx]
+      end
+
+      #
+      # Return the number of items contained in the ordered list
+      #
+      def items
+        list_items.size
+      end
+
+      #
+      # Return Array of ListItem objects that are children of the OrderedList
+      #
+      def list_items
+        @list_items ||= children(tag_name: 'li')
+      end
+    end
+
+    ::PageObject::Elements.tag_to_class[:ol] = ::PageObject::Elements::OrderedList
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class Paragraph < Element
+
+    end
+
+    ::PageObject::Elements.tag_to_class[:p] = ::PageObject::Elements::Paragraph
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class RadioButton < Element
+
+    end
+
+    ::PageObject::Elements.type_to_class[:radio] = ::PageObject::Elements::RadioButton
+  end
+end

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

@@ -0,0 +1,42 @@
+module PageObject
+  module Elements
+    class SelectList < Element
+
+      #
+      # Return the PageObject::Elements::Option for the index provided.  Index
+      # is zero based.
+      #
+      # @return [PageObject::Elements::Option]
+      #
+      def [](idx)
+        options[idx]
+      end
+
+      #
+      # Return an array of Options contained in the select list.
+      #
+      # @return [array of PageObject::Elements::Option]
+      #
+      def options
+        element.options.map { |e| PageObject::Elements::Option.new(e) }
+      end
+
+      #
+      # @return [Array<String>] An array of strings representing the text of the currently selected options.
+      #
+      def selected_options
+        element.selected_options.map(&:text).compact
+      end
+
+      #
+      # @return [Array<String>] An array of strings representing the value of the currently selected options.
+      #
+      def selected_values
+        element.selected_options.map(&:value).compact
+      end
+
+    end
+
+    ::PageObject::Elements.tag_to_class[:select] = ::PageObject::Elements::SelectList
+  end
+end

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

@@ -0,0 +1,9 @@
+module PageObject
+  module Elements
+    class Span < Element
+
+    end
+
+    ::PageObject::Elements.tag_to_class[:span] = ::PageObject::Elements::Span
+  end
+end

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

@@ -0,0 +1,85 @@
+module PageObject
+  module Elements
+    class Table < Element
+      include Enumerable
+
+      #
+      # iterator that yields with a PageObject::Elements::TableRow
+      #
+      # @return [PageObject::Elements::TableRow]
+      #
+      def each(&block)
+        row_items.each(&block)
+      end
+
+      alias_method :first_row, :first
+
+      #
+      # return the last row
+      #
+      # @return PageObject::Elements::TableRow
+      #
+      def last_row
+        self[-1]
+      end
+
+      #
+      # Return the PageObject::Elements::TableRow for the index provided.  Index
+      # is zero based.  If the index provided is a String then it
+      # will be matched with the text from any column. The text can be a substring of the full column text.
+      #
+      # @return [PageObject::Elements::TableRow]
+      #
+      def [](what)
+        idx = find_index(what)
+        idx && row_items[idx]
+      end
+
+      #
+      # Returns the number of rows in the table.
+      #
+      def rows
+        row_items.size
+      end
+
+      #
+      # Returns the Array of values(String) in a column for the index provided. Index
+      # is zero based. If the index provided is a String then it
+      # will be matched with the text from the header. The text can be a substring of the full header text.
+      #
+      def column_values(what)
+        idx = find_index_of_header(what)
+        idx && row_items.drop(1).collect { |row| row.cell(index: idx).text }
+      end
+
+      protected
+
+      def row_items
+        meth = strategy == :descendants ? :trs : :rows
+        @row_items ||= element.send(meth).map do |obj|
+          ::PageObject::Elements::TableRow.new(obj)
+        end
+      end
+
+      def strategy
+        :children
+      end
+
+      def find_index_of_header(what)
+        return what if what.is_a? Integer
+        row_items[0].cells.find_index do |cell|
+          cell.text.include? Regexp.escape(what)
+        end
+      end
+
+      def find_index(what)
+        return what if what.is_a? Integer
+        row_items.find_index do |row|
+          row.cell(text: /#{Regexp.escape(what)}/).exist?
+        end
+      end
+    end
+
+    ::PageObject::Elements.tag_to_class[:table] = ::PageObject::Elements::Table
+  end
+end

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

@@ -0,0 +1,10 @@
+module PageObject
+  module Elements
+    class TableCell < Element
+
+    end
+
+    ::PageObject::Elements.tag_to_class[:td] = ::PageObject::Elements::TableCell
+    ::PageObject::Elements.tag_to_class[:th] = ::PageObject::Elements::TableCell
+  end
+end