module PageObjectPal

Module that will compare element identifying information used to define instance methods in PageObject classes to the HTML source code of a URL. Use to keep page objects from becoming stale/unit testing your classes.

Can be used independent of class to unit test page object. @example Independent test

describe Page do
  it "calls upon valid elements in its instance methods" do
    PageObjectPal.examine(Page, 'path/to/page/file', 'http://www.page.com').should be_true
  end
end

Can be wrapped in a page object class method for validation. @example Class method

class Page
  include PageObject

  def self.elements_still_valid
    PageObjectPal.examine(self, __FILE__, 'http://www.page.com')
  end
end

Constants

VERSION

Public Instance Methods

examine(klass, path, url) click to toggle source

Compare elements constructed by the PageObject::DSL to the elements in the URL’s source code.

@param [Class] Page object class to be tested @param [String] Path to the file housing the class being tested @param [String] Page URL

@return [Boolean] True if no error is raised

# File lib/page-object-pal.rb, line 44
def examine(klass, path, url)
  polish! url unless url.start_with? "http://"
  diff_page(Nokogiri::HTML(open(url)), parse_class(klass, path))
  declare_success
end

Private Instance Methods

declare_success() click to toggle source

# File lib/page-object-pal.rb, line 51
def declare_success
  true
end

find_class_methods(klass) click to toggle source

Grab instance methods defined in the page object class and not its super classes.

# File lib/page-object-pal.rb, line 73
def find_class_methods(klass)
  methods = []
  klass.instance_methods(false).each { |m| methods << m }
end

parse_class(klass, path) click to toggle source

Parse elements from the page object class methods.

# File lib/page-object-pal.rb, line 65
def parse_class(klass, path)
  methods = find_class_methods(klass)
  elements = parse_methods(methods, path)
end

polish!(url) click to toggle source

Ensure the given URL will work with open-uri.

# File lib/page-object-pal.rb, line 58
def polish!(url)
  url.replace "http://#{url}"
end