module Druid::PagePopulator

Public Instance Methods

populate_page_with(data) click to toggle source

This method will populate all matched page TextFields, TextAreas, SelectLists, FileFields, Checkboxes, and Radio Buttons from the Hash passed as an argument. The way it find an element is by matching the Hash key to the name you provided when declaring the element on your page.

Checkbox and Radio Button values must be true or false.

@example

class ExamplePage
  include PageObject

  text_field(:username, :id => 'username_id')
  checkbox(:active, :id => 'active_id')
end

...

@browser = Watir::Browser.new :firefox
example_page = ExamplePage.new(@browser)
example_page.populate_page_with :username => 'a name', :active => true

@param data [Hash] the data to use to populate this page. The key can be either a string or a symbol. The value must be a string for TextField, TextArea, SelectList and FileField must be true or false for a Checkbox or RadioButton.

# File lib/druid/page_populator.rb, line 31
def populate_page_with(data)
  data.to_h.each do |key, value|
    populate_section(key, value) if value.respond_to?(:to_h)
    populate_value(self, key, value)
  end
end

Private Instance Methods

is_checkbox?(receiver, key) click to toggle source
# File lib/druid/page_populator.rb, line 81
def is_checkbox?(receiver, key)
  receiver.respond_to?("check_#{key}".to_sym)
end
is_enabled?(receiver, key) click to toggle source
# File lib/druid/page_populator.rb, line 97
def is_enabled?(receiver, key)
  return false if is_radiobuttongroup?(receiver, key)
  return true if (receiver.send "#{key}_element").tag_name == "textarea"
  element = receiver.send("#{key}_element")
  element.enabled? and element.present?
end
is_radiobutton?(receiver, key) click to toggle source
# File lib/druid/page_populator.rb, line 85
def is_radiobutton?(receiver, key)
  receiver.respond_to?("select_#{key}".to_sym)
end
is_radiobuttongroup?(receiver, key) click to toggle source
# File lib/druid/page_populator.rb, line 89
def is_radiobuttongroup?(receiver, key)
  receiver.respond_to?("select_#{key}".to_sym) and receiver.respond_to?("#{key}_values")
end
is_select_list?(receiver, key) click to toggle source
# File lib/druid/page_populator.rb, line 93
def is_select_list?(receiver, key)
  receiver.respond_to?("#{key}_options".to_sym)
end
is_text?(receiver, key) click to toggle source
# File lib/druid/page_populator.rb, line 76
def is_text?(receiver, key)
  return false if is_select_list?(receiver, key)
  receiver.respond_to?("#{key}=".to_sym)
end
populate_checkbox(receiver, key, value) click to toggle source
# File lib/druid/page_populator.rb, line 59
def populate_checkbox(receiver, key, value)
  return receiver.send "check_#{key}" if value
  return receiver.send "uncheck_#{key}"
end
populate_radiobutton(receiver, key, value) click to toggle source
# File lib/druid/page_populator.rb, line 64
def populate_radiobutton(receiver, key, value)
  return receiver.send "select_#{key}" if value
end
populate_radiobuttongroup(receiver, key, value) click to toggle source
# File lib/druid/page_populator.rb, line 68
def populate_radiobuttongroup(receiver, key, value)
  return receiver.send "select_#{key}", value
end
populate_section(section, data) click to toggle source
# File lib/druid/page_populator.rb, line 40
def populate_section(section, data)
  return unless self.respond_to? section
  data.to_h.each do |key, value|
    populate_value(self.send(section), key, value)
  end
end
populate_select_list(receiver, key, value) click to toggle source
# File lib/druid/page_populator.rb, line 72
def populate_select_list(receiver, key, value)
  receiver.send "#{key}=", value
end
populate_text(receiver, key, value) click to toggle source
# File lib/druid/page_populator.rb, line 55
def populate_text(receiver, key, value)
  receiver.send "#{key}=", value
end
populate_value(receiver, key, value) click to toggle source
# File lib/druid/page_populator.rb, line 47
def populate_value(receiver, key, value)
  populate_checkbox(receiver, key, value) if is_checkbox?(receiver, key) and is_enabled?(receiver, key)
  populate_radiobuttongroup(receiver, key, value) if is_radiobuttongroup?(receiver, key)
  populate_radiobutton(receiver, key, value) if is_radiobutton?(receiver, key) and is_enabled?(receiver, key)
  populate_select_list(receiver, key, value) if is_select_list?(receiver, key)
  populate_text(receiver, key, value) if is_text?(receiver, key) and is_enabled?(receiver, key)
end