SimpliTest 0.0.1

data/lib/SimpliTest/helpers/step_helpers/custom_chrome_helpers.rb

@@ -0,0 +1,14 @@
+#The chrome profile loads Selenium Helpers as well. These methods
+#override the methods available in Selenium Helpers
+module CustomChromeHelpers
+  def maximize_window
+    page.driver.browser.manage.window.resize_to(MAX_WIDTH,MAX_HEIGHT)
+  end
+  def keydown_on(element)
+    element.native.send_key(:arrow_down)
+  end
+
+  def capture_screenshot(filename)
+    page.driver.browser.save_screenshot(filename)
+  end
+end

data/lib/SimpliTest/helpers/step_helpers/custom_date_helpers.rb

@@ -0,0 +1,64 @@
+module CustomDateHelpers
+  def calculated_date_from(date_rule)
+    # Takes strings like "Today's Date", "4 days ago", "5 days since" etc. and
+    # returns a calculated date in the default_date_format
+    potential_date_formats = /[0-9]+\/[0-9]+\/[0-9]+/x
+    first_and_last_regex = /the (nearest|first|last) (.*)/
+    date =  case date_rule
+            when potential_date_formats
+              date_rule
+            when /Today's Date/i
+              Date.today
+            when /(\d+) days (ago|since)/i
+              number_of_days = $1.to_i rescue nil
+              time_travel_method = $2.downcase.to_sym
+              raise "Invalid number of days. Please enter a valid number" if number_of_days.nil?
+              number_of_days.send(:days).send(time_travel_method)
+            when first_and_last_regex
+              first_and_last_date_rule(rule)
+            end
+    date.respond_to?(:strftime) ? date.strftime(default_date_format) : date
+  end
+
+  def first_and_last_date_rule(phrase)
+    # Takes a phrase like "the first day of the month" or "last day of the
+    # previous month" and returns a calculated date in the default_date_format
+    case phrase
+    when /the (first|last) day of the month/i
+      Date.today.send(beginning_or_end($1))
+    when /the (first|last) day of next month/i
+      1.month.since.send(beginning_or_end($1))
+    when /the (first|last) day of previous month/i
+      1.month.ago.send(beginning_or_end($1))
+    when /the (first|last) day of (.*)/i
+      date_from_phrase($1, $2)
+    when /the nearest (first|last) day of month/i
+      rule = Date.today.day >= 15 ? "the #{$1} day of next month" : "the #{$1} day of the month"
+      calculated_date_from(rule)
+    end
+  end
+
+  def beginning_or_end(first_or_last)
+    first_or_last == 'first' ? :beginning_of_month : :end_of_month
+  end
+
+  def default_date_format
+    format_for_strftime SimpliTest.config_settings['DEFAULT_DATE_FORMAT']
+  end
+
+  def date_from_phrase(first_or_last, month)
+    month_name = month.downcase.camelize
+    month = Date::MONTHNAMES.index(month_name)
+    if month.nil?
+      raise "Oops you provided an invalid month name. Please use a valid month name from January to December"
+    end
+      date = Date.parse("#{month}/1") #mm/dd in current year
+      date = date.send(:end_of_month) if first_or_last == 'last'
+  end
+
+  def format_for_strftime(string)
+    string.gsub('mm', '%m').gsub('dd', '%d').gsub('yyyy', '%Y').gsub('yy', '%y')
+  end
+end
+
+World(CustomDateHelpers)

data/lib/SimpliTest/helpers/step_helpers/custom_form_helpers.rb

@@ -0,0 +1,66 @@
+module CustomFormHelpers
+
+  def numerize(number_name)
+    case number_name
+    when 'first'; 0
+    when 'last'; -1
+    else number_name.match(/[0-9]/)[1].to_i + 1 rescue 0 #take the first one if you cant figure it out
+    end
+  end
+
+  def blur(selector_and_xpath)
+    css_selector, xpath = selector_and_xpath
+    selector = xpath ? xpath : css_selector
+    if xpath
+      return
+    else
+      #TODO: Hate how this done...need to come back to this
+     execute_script_for_driver(SimpliTest.config_driver, %Q{ $('#{selector}').blur(); })
+    end
+  end
+
+  def fill_in_masked_field(css_selector, value)
+    STDOUT.puts "Entering #{value} in Masked Field #{css_selector} now" #TODO: Delete this debugging statement
+    execute_script_for_driver(SimpliTest.config_driver, %Q{ $("#{css_selector}").val("#{value}"); })
+    STDOUT.puts "Blurring the field now" #TODO: Delete this debugging statement
+    execute_script_for_driver(SimpliTest.config_driver, %Q{ $("#{css_selector}").blur(); })
+    #page.driver.debug
+  end
+
+
+  def press_key(key)
+    keycode = keycode_for[key.downcase.gsub(' ','_')]
+    keypress_script = "var e = $.Event('keydown', { keyCode: #{keycode} }); $('body').trigger(e);"
+    execute_js(keypress_script)
+  end
+
+  def tab_on(element)
+    element.native.send_key(:tab)
+  end
+
+  def keypress_on(elem, key, charCode = 0)
+    keyCode = keycode_for[key]
+    elem.base.invoke('keypress', false, false, false, false, keyCode, charCode);
+  end
+
+  def keycode_for
+    {
+      :tab => 9,
+      :enter => 13,
+      :up_arrow => 38,
+      :down_arrow => 40,
+      :left_arrow => 37,
+      :right_arrow => 39,
+      :escape => 27,
+      :spacebar => 32,
+      :ctrl => 17,
+      :alt => 18,
+      :shift => 16,
+      :caps_lock => 20,
+      :backspace => 8,
+      :delete => 46
+    }
+  end
+end
+World(CustomFormHelpers)
+

data/lib/SimpliTest/helpers/step_helpers/custom_phantomjs_helpers.rb

@@ -0,0 +1,49 @@
+module CustomPhantomjsHelpers
+  def maximize_window
+    page.driver.resize_window(MAX_WIDTH,MAX_HEIGHT)
+  end
+
+  def tab_on(element)
+    element.native.send_key(:Tab)
+  end
+
+  def accept_confirmation
+    #TODO: accept confirmation
+    raise "NotImplementedError"
+  end
+
+  def execute_js(script)
+    page.execute_script(script)
+  end
+
+  def get_text_from(element)
+    element.native.all_text
+  end
+
+  def click_element(element)
+    begin
+      element.click
+    rescue Capybara::Poltergeist::MouseEventFailed
+      element.trigger('click')
+    end
+  end
+
+  def key_in(character, element)
+    element.native.send_key(character)
+  end
+
+  def keydown_on(element)
+    key_in('Down', element)
+  end
+
+  def capture_screenshot(filename)
+    page.save_screenshot(filename)
+  end
+
+  def change_window(first_or_last)
+    raise "Invalid window name #{first_or_last}. You can only use 'first' or 'last'" unless first_or_last =~ /first|last/
+    window_handle = page.driver.browser.window_handles.send(first_or_last.to_sym)
+    page.driver.browser.switch_to_window(window_handle)
+    wait_for(page.driver.browser.window_handles.size, 1)
+  end
+end

data/lib/SimpliTest/helpers/step_helpers/custom_selenium_helpers.rb

@@ -0,0 +1,41 @@
+module CustomSeleniumHelpers
+  def maximize_window
+    page.driver.browser.manage.window.resize_to(MAX_WIDTH, MAX_HEIGHT)
+  end
+
+  def capture_screenshot(filename)
+    page.driver.browser.save_screenshot(filename)
+  end
+
+  def accept_confirmation
+    page.driver.browser.switch_to.alert.accept
+  end
+
+  def execute_js(script)
+    page.driver.browser.execute_script(script)
+  end
+
+  def get_text_from(element)
+    element.text
+  end
+
+  def click_element(element)
+    element.click
+  end
+
+  def key_in(character, element)
+    element.native.send_key(character)
+  end
+
+  def keydown_on(element)
+    key_in(:arrow_down, element)
+  end
+
+  def change_window(first_or_last)
+    raise "Invalid window name #{first_or_last}. You can only use 'first' or 'last'" unless first_or_last =~ /first|last/
+    window_handle = page.driver.browser.window_handles.send(first_or_last.to_sym)
+    page.driver.browser.switch_to.window(window_handle)
+    wait_for(page.driver.browser.window_handles.size, 1)
+  end
+end
+

data/lib/SimpliTest/helpers/step_helpers/html_selectors_helpers.rb

@@ -0,0 +1,154 @@
+module HtmlSelectorsHelpers
+  #TODO: Rewrite without test app for template. The code here effing nuts'...clean this shit
+  @selectors_file = 'features/support/config/selectors.yml'
+
+  def pagination_links_for(page_number)
+    selector = "input[title='Page #{page_number}']"
+    all(:css, selector)
+  end
+
+  def pagination_element_for(index)
+    lookup = {
+      'first' => 'firstButton',
+      'last' => 'lastButton',
+      'previous' => 'prevButton',
+      'next' => 'nextButton'
+    }
+    selector = "##{lookup[index]}"
+    elements = all(:css, selector)
+    elements.first if elements
+  end
+
+  def select_options_for(locator)
+    element = get_element_from(locator)
+    get_text_from(element)
+  end
+
+  def get_element_from(locator, try_field=true, find_button_or_link=false)
+    selector, selector_type = selector_for(locator)
+    element = nil
+    patiently do
+      if selector_type == 'xpath'
+        element = page.find(:xpath, selector)
+      elsif selector_type == 'css'
+        element = page.find(:css, selector)
+      elsif try_field
+        element = page.find_field(selector)
+      elsif find_button_or_link
+        raise "Button or Link Not Found"
+      else
+        element = find(selector)
+      end
+    end
+  end
+
+
+  def get_button_or_link_from(locator)
+    begin
+      get_element_from(locator, false, true)
+    rescue
+      begin
+        page.find_link(locator)
+      rescue
+        page.find_button(locator)
+      end
+    end
+  end
+
+  def selector_for(locator)
+    if SimpliTest.config_selectors
+      mapping = mapping_for(locator)
+      mapping ? selector_from(mapping) : default_selector_for(locator)
+    else 
+      default_selector_for(locator)
+    end
+  end
+
+  def mapping_for(selector)
+    SimpliTest.config_selectors[unquoted(selector)] || false
+  end
+
+  def selector_from(selector)
+    selector_type = is_xpath?(selector) ? 'xpath' : (is_css?(selector) ? 'css' : 'other')
+    selector = without_identifier(selector)
+    return selector, selector_type
+  end
+
+
+  def is_xpath?(locator)
+    selector_for(locator)[0].match(/xpath:(.*)/)
+  end
+
+  def is_css?(locator)
+    selector_for(locator)[0].match(/css:(.*)/)
+  end
+
+  def without_identifier(locator)
+    if match = (is_xpath?(locator) || is_css?(locator))
+      return match[1]
+    else
+      return locator
+    end
+  end
+
+
+  def unquoted(string)
+    #string[0] is the first char
+    #string[-1,1] is the last char
+    is_string_quoted = (string[0] == string[-1, 1]) && (%w[' "].include?(string[0]))
+    is_string_quoted ? string.gsub(/^"|"$/, '') : string
+  end
+
+  def default_selector_for(locator)
+    case locator
+
+    when "the page"
+      with_selector_type "html > body"
+    when "table's header"
+      with_selector_type "table tbody > tr th"
+    when /^paragraphs?$/
+      with_selector_type  "p"
+    when "\"table tr\""
+      with_selector_type "table tr"
+    when "\"div.some_class\""
+      with_selector_type "div.some_class"
+    else
+      with_selector_type locator
+    end
+  end
+
+  def with_selector_type(selector, selector_type='other')
+    [selector, selector_type]
+  end
+
+  def validate_absence_of(text)
+    min_wait_time = SimpliTest.config_settings ? SimpliTest.config_settings['MIN_WAIT_TIME'] : 2
+    using_wait_time min_wait_time do #because we are validating absence we don't need to wait all 5 seconds?
+      begin
+        should_not have_link(text)
+      rescue RSpec::Expectations::ExpectationNotMetError, Capybara::ExpectationNotMet
+        element = get_button_or_link_from(text)
+        element.should_not be_visible if element.respond_to?(:visible?)
+        ## deprecating the approach below for performance reasons
+        ##xpath = potential_hidden_paths_for(text).join('|')
+        ##should have_xpath(xpath)
+      end
+    end
+  end
+
+  def selectors_from_section(section)
+    SimpliTest.config_selectors[section].values
+  end
+
+  #def potential_hidden_paths_for(text) #the different ways developers might choose to hide things in the DOM
+  #[
+  #"//*[@class='hidden' and contains(.,'#{text}')]",
+  #"//*[@class='invisible' and contains(.,'#{text}')]",
+  #"//*[@style='display: none;' and contains(.,'#{text}')]"
+  #]
+
+  #end
+
+end
+
+World(HtmlSelectorsHelpers)

data/lib/SimpliTest/helpers/step_helpers/navigation_helpers.rb

@@ -0,0 +1,196 @@
+module NavigationHelpers
+  # Maps a name to a path. Used by the
+  #
+  #   When /^I go to (.+)$/ do |page_name|
+  #
+  #TODO: Rewrite without test app for template
+  def path_to(page_name)
+    if is_url?(page_name)
+      page_name
+    elsif SimpliTest.config_pages
+      matches = SimpliTest.config_pages.select { |p| unquoted(page_name) == p }
+      matches.any? ? url_from(matches, page_name) : default_path_for(page_name)
+    else
+      default_path_for(page_name)
+    end
+  end
+# :nocov:
+  def url_from(matches, page_name)
+    if matches.length > 1
+      raise "Oops ambigous page name! More than one matched our search. It seems you have similar page names. \n" +
+        "Now, go and modify #{page_name} to something cooler in config/pages.yml"
+    else
+      path = matches.values.first
+    end
+    url_to(path) if path
+  end
+
+  def default_path_for(page_name)
+    case page_name
+
+    when /^home$/
+      '/'
+    when /^congratulations$/
+      '/congratulations'
+    when /^other$/
+      '/other/page'
+    when /^form$/
+      '/form/page'
+    when /^valid_links$/
+      '/valid-links'
+    when /^invalid_links$/
+      '/invalid-links'
+      # Add more mappings here.
+      # Here is an example that pulls values out of the Regexp:
+      #
+      #   when /^(.*)'s profile page$/i
+      #     user_profile_path(User.find_by_login($1))
+
+    else
+      begin
+        page_name =~ /^the (.*) page$/
+        path_components = $1.split(/\s+/)
+        self.send(path_components.push('path').join('_').to_sym)
+      rescue NoMethodError, ArgumentError
+        raise "Can't find mapping from \"#{page_name}\" to a path.\n" +
+        "Now, go and add a mapping in #{__FILE__}"
+      end
+    end
+  end
+# :nocov:
+
+  def url_to(path)
+    if is_url?(path)
+      path
+    else
+      begin
+        URI.parse(SimpliTest.config_environments[SimpliTest.config_environment] + path).normalize.to_s
+      rescue
+        puts "It seems that the #{SimpliTest.config_environment} enviroment has not been set up. Please add it to features/config/environments.yml"
+        raise "Unidentified Environment Requested!!"
+      end
+    end
+  end
+
+  def is_url?(path)
+    uri = URI.parse(path)
+    uri if uri.scheme =~ /^https?$/
+  rescue URI::BadURIError, URI::InvalidURIError
+    false
+  end
+
+  def is_relative?(path)
+    uri = URI.parse(path)
+    uri.relative?
+  end
+
+  def is_valid_url_or_path?(path)
+    is_url?(path) || is_relative?(path)
+  end
+
+  def is_javascript_href?(href)
+    href =~ /^(javascript|#)/
+  end
+
+  def parse_dom_tree(url)
+    Nokogiri::HTML(open(url))
+  end
+
+  def valid_assets_links_from(nokogiri_html_document)
+    doc = nokogiri_html_document
+    links = stylesheet_references_on(doc) + javascript_references_on(doc)
+    links.select{ |l| !is_javascript_href?(l) }
+  end
+
+  def stylesheet_references_on(doc)
+    doc.css('link').collect{|l| l['href'] }.compact
+  end
+
+  def javascript_references_on(doc)
+    doc.css('script').collect{|l| l['src']}.compact
+  end
+
+  def links_on(doc)
+    doc.css('a').collect{|l| l['href']}.compact.select{ |l| !is_javascript_href?(l) }
+  end
+
+  def validate_response_from(page_name, href)
+    begin
+      root_path = path_to(page_name)
+      uri = is_relative?(href) ? (URI.join(root_path, href)) : URI.parse(href)
+      response = get_response_from(uri)
+      valid_status_groups = [Net::HTTPRedirection, Net::HTTPInformation, Net::HTTPSuccess ]
+      valid_status_groups.should include(response.class.superclass)
+      rescue RSpec::Expectations::ExpectationNotMetError
+       message =  "Received a #{response.code} #{ response.msg } from #{href} on #{page_name}"
+        fail message
+      rescue
+        message = "Invalid reference: #{href} found on #{page_name} page"
+        fail message
+    end
+  end
+
+  #this returns a hash with a response code and the url to help provide good fail detail
+  def get_response_from(uri)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.read_timeout = http.open_timeout = SimpliTest.config[:settings]["HTTP_TIMEOUT"] || 3
+      request = Net::HTTP::Get.new(uri.request_uri)
+    if uri.scheme == 'https'
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+    end
+      http.request(request)
+  end
+
+  #FIXME: Code not used. Should be deleted
+  def url_in_new_window
+    if handles = page.driver.browser.window_handles rescue nil
+      new_window = handles.last
+      page.within_window(new_window) do
+        return without_trailing_slash(current_url)
+      end
+    end
+  end
+
+  def without_trailing_slash(url)
+    url.chomp('/')
+  end
+
+  def with_encoded_white_space(string)
+    string.gsub(' ', '%20')
+  end
+
+  def with_unencoded_white_space(string)
+    string.gsub('%20', ' ')
+  end
+
+  def normalize(url)
+    normalized_uri = URI.parse(url).normalize
+    url = normalized_uri.to_s
+    encoded_url = URI::encode(url)
+    without_trailing_slash(encoded_url)
+  end
+
+  def normalize_path(path)
+    if path = is_url?(path)
+      path = path.path
+    end
+    with_encoded_white_space(without_trailing_slash(path))
+  end
+
+  def wait_for(left_argument, right_argument)
+    called_at = Time.now
+    until left_argument > right_argument do
+      past_wait_time = called_at < Time.now - SimpliTest.config['HTTP_TIMEOUT']
+      return if past_wait_time
+      sleep 1
+    end
+  end
+
+  def comparable_urls_for(target_url, source_url)
+    is_url?(target_url) ? [target_url, source_url].map{|u| normalize(u)} : [target_url, URI.parse(source_url).path]
+  end
+
+end
+
+World(NavigationHelpers)