taf 0.1.1

data/lib/functions/handlers/handle_browser_window.rb

@@ -0,0 +1,23 @@
+require_relative 'base_handler'
+# require './taf_config.rb'
+
+module TestSteps
+  module Handlers
+    class HandleBrowserWindow < Base
+      register :handle_browser_window
+
+      def perform(step_attributes)
+        text_check = step_attributes[:testvalue]
+
+        Browser.b.window(title: text_check.to_s).use
+        sleep 3
+        Browser.b.title.eql?(text_check.to_s)
+        Report.results.puts("Window title: #{text_check} is correct")
+        true
+      rescue StandardError
+        Report.results.puts("Window not found: #{text_check}")
+        false
+      end
+    end
+  end
+end

data/lib/functions/handlers/insert_value_config.rb

@@ -0,0 +1,28 @@
+require_relative 'base_handler'
+# require './taf_config.rb'
+
+module TestSteps
+  module Handlers
+    class InsertValueConfig < Base
+      register :insert_value_config
+
+      def perform(step_attributes)
+        box = step_attributes[:testvalue]
+        locate = step_attributes[:locate]
+        value = step_attributes[:testvalue2]
+        value = ENV[value.to_s]
+
+        Browser.b.text_field(:"#{locate}" => box).wait_until_present.set value
+        (Browser.b.text_field(:"#{locate}" => box).value == value)
+        Report.results.puts("Textbox: #{box} has correct value: #{value}")
+        true
+      rescue StandardError
+        Report.results.puts("Textbox: #{box} has the incorrect value: #{value}")
+        false
+      rescue StandardError
+        Report.results.puts("Textbox: #{box} does not exist")
+        false
+      end
+    end
+  end
+end

data/lib/functions/handlers/ipause.rb

@@ -0,0 +1,21 @@
+require_relative 'base_handler'
+# require './taf_config.rb'
+
+module TestSteps
+  module Handlers
+    class Ipause < Base
+      register :ipause
+
+      def perform(step_attributes)
+        wait_time = step_attributes[:testvalue]
+
+        sleep(wait_time.to_i)
+        Report.results.puts('Wait completed for seconds: ' + wait_time.to_s)
+        true
+      rescue StandardError
+        Report.results.puts('Wait failed for seconds: ' + wait_time.to_s)
+        false
+      end
+    end
+  end
+end

data/lib/functions/handlers/list_all_dropdowns_values.rb

@@ -0,0 +1,24 @@
+require_relative 'base_handler'
+# require './taf_config.rb'
+
+module TestSteps
+  module Handlers
+    class ListAllDropdownValues < Base
+      register :list_all_dropdown_values
+
+      def perform(step_attributes)
+        dropdown = step_attributes[:testvalue]
+        locate = step_attributes[:locate]
+
+        Browser.b.element(:"#{locate}" => dropdown).wait_until_present
+        Browser.b.select_list(:"#{locate}" => dropdown).options.each do |i|
+        Report.results.puts("List of dropdown for #{dropdown} are: #{i.text}")
+        return true
+        end
+      rescue StandardError
+        Report.results.puts("List dropdown: #{dropdown} does not exist")
+        false
+      end
+    end
+  end
+end

data/lib/functions/handlers/login.rb

@@ -0,0 +1,25 @@
+require_relative 'base_handler'
+
+module TestSteps
+  module Handlers
+    class PortalLogin < Base
+      register :portal_login
+
+      def perform(step_attributes)
+        value = step_attributes[:testvalue]
+
+        url = ENV['URL']
+        user = ENV[value.to_s]
+        pass = ENV['USER_PASS']
+        b_title = 'Log in'
+        b_title_sucess = 'Home'
+        user_elm = 'user_email'
+        pass_elm = 'user_password'
+        
+        open_url_process(url)
+        login_process(b_title, user_elm, pass_elm, user, pass)
+        mem_word_check(user, b_title_sucess)
+      end
+    end
+  end
+end

data/lib/functions/handlers/open_portal_url.rb

@@ -0,0 +1,25 @@
+require_relative 'base_handler'
+# require './taf_config.rb'
+
+module TestSteps
+  module Handlers
+    class OpenPortalUrl < Base
+      register :open_portal_url
+
+      def perform(step_attributes)
+        value = step_attributes[:testvalue]
+        url = ENV[value.to_s]
+        Browser.open_browser
+        Browser.b.goto(url)
+        url_nme = Browser.b.url
+        if url_nme == url
+          Report.results.puts("opened URL: #{url}")
+          return true
+        else
+          Report.results.puts("URL not open: #{url} - opened #{url_nme} instead")
+          return false
+        end
+      end
+    end
+  end
+end

data/lib/functions/handlers/open_url.rb

@@ -0,0 +1,26 @@
+require_relative 'base_handler'
+# require './taf_config.rb'
+
+module TestSteps
+  module Handlers
+    class OpenUrl < Base
+      register :open_url
+
+      def perform(step_attributes)
+        url = step_attributes[:testvalue]
+
+        Browser.open_browser
+        Browser.b.goto(url)
+        sleep 2
+        url_nme = Browser.b.url
+        if url_nme == url
+          Report.results.puts("opened URL: #{url}")
+          return true
+        else
+          Report.results.puts("URL not open: #{url} - opened #{url_nme} instead")
+          return false
+        end
+      end
+    end
+  end
+end

data/lib/functions/handlers/ping_test.rb

@@ -0,0 +1,28 @@
+require_relative 'base_handler'
+# require './taf_config.rb'
+
+module TestSteps
+  module Handlers
+    class PingTest < Base
+      register :ping_test
+
+      def perform(step_attributes)
+        url = step_attributes[:testvalue]
+
+        while check = Net::Ping::HTTP.new(url)
+          check.ping?
+          sleep 5
+          if check.ping? == true
+            # website alive
+            Report.results.puts("pinged: #{url}")
+            return true
+          else
+            # website not responding
+            Report.results.puts("Failed to ping: #{url}")
+            return false
+          end
+        end
+      end
+    end
+  end
+end

data/lib/functions/handlers/radio_button.rb

@@ -0,0 +1,25 @@
+require_relative 'base_handler'
+# require './taf_config.rb'
+
+module TestSteps
+  module Handlers
+    class RadioButton < Base
+      register :radio_button
+
+      def perform(step_attributes)
+        radio = step_attributes[:testvalue]
+        value2 = step_attributes[:testvalue2]
+        locate = step_attributes[:locate]
+        locate2 = step_attributes[:locate2]
+
+        Browser.b.radio(:"#{locate}" => radio).wait_until_present
+        Browser.b.radio(:"#{locate}" => radio, :"#{locate2}" => "#{value2}").set
+        Report.results.puts("Radio button: #{radio} has been selected")
+        true
+      rescue StandardError
+        Report.results.puts("Radio button: #{radio} does not exist")
+        false
+      end
+    end
+  end
+end

data/lib/functions/handlers/select_dropdown.rb

@@ -0,0 +1,28 @@
+require_relative 'base_handler'
+# require './taf_config.rb'
+
+module TestSteps
+  module Handlers
+    class SelectDropdown < Base
+      register :select_dropdown
+
+      def perform(step_attributes)
+        dropdown = step_attributes[:testvalue]
+        value2 = step_attributes[:testvalue2]
+        locate = step_attributes[:locate]
+        locate2 = step_attributes[:locate2]
+
+        Browser.b.select_list(:"#{locate}" => dropdown).wait_until_present
+        Browser.b.select_list(:"#{locate}" => dropdown).option(:"#{locate2}" => "#{value2}").select
+        Report.results.puts("Dropdown item: #{value2} has been selected")
+        true
+      rescue StandardError
+        Report.results.puts("Dropdown item: #{value2} has NOT been selected")
+        false
+      rescue StandardError
+        Report.results.puts("the dropdown: #{dropdown} does not exist")
+        false
+      end
+    end
+  end
+end

data/lib/functions/handlers/send_special_keys.rb

@@ -0,0 +1,22 @@
+require_relative 'base_handler'
+# require './taf_config.rb'
+
+module TestSteps
+  module Handlers
+    class SendSpecialKeys < Base
+      register :send_special_keys
+
+      def perform(step_attributes)
+        special_key = step_attributes[:testvalue]
+
+        Browser.b.send_keys :"#{special_key}"
+        sleep 1
+        Report.results.puts("Browser Sent key: :#{special_key} successfully")
+        true
+      rescue StandardError
+        Report.results.puts("Browser Failed to Send key: :#{special_key}")
+        false
+      end
+    end
+  end
+end

data/lib/functions/handlers/write_box_data.rb

@@ -0,0 +1,40 @@
+require_relative 'base_handler'
+# require './taf_config.rb'
+
+module TestSteps
+  module Handlers
+    class WriteBoxdata < Base
+      register :write_box_data
+
+      def perform(step_attributes)
+        box = step_attributes[:testvalue]
+        value = step_attributes[:testvalue2]
+        locate = step_attributes[:locate]
+
+        found_box = [
+          Browser.b.textarea(:"#{locate}" => box).exist?,
+          Browser.b.text_field(:"#{locate}" => box).exist?
+        ]
+    
+        raise 'Multiple matches' if found_box.select { |i| i }.empty?
+        index = found_box.index(true)
+        return unless index
+        if index.zero?
+          Browser.b.textarea(:"#{locate}" => box).wait_until_present.set value
+          (Browser.b.textarea(:"#{locate}" => box).value == value)
+        elsif index == 1
+          Browser.b.text_field(:"#{locate}" => box).wait_until_present.set value
+          (Browser.b.text_field(:"#{locate}" => box).value == value)
+        end
+        Report.results.puts("Textbox: #{box} has correct value: #{value}")
+        true
+      rescue StandardError
+        Report.results.puts("Textbox: #{box} has the incorrect value: #{value}")
+        false
+      rescue StandardError
+        Report.results.puts("Textbox: #{box} does not exist")
+        false
+      end
+    end
+  end
+end

data/lib/functions/handlers/write_to_editor.rb

@@ -0,0 +1,27 @@
+require_relative 'base_handler'
+# require './taf_config.rb'
+
+module TestSteps
+  module Handlers
+    class WriteToEditor < Base
+      register :write_to_editor
+
+      def perform(step_attributes)
+        iframe = step_attributes[:testvalue]
+        value = step_attributes[:testvalue2]
+        locate = step_attributes[:locate]
+
+        Browser.b.iframe(:"#{locate}" => iframe).wait_until_present
+        Browser.b.iframe(:"#{locate}" => iframe).send_keys value
+        Report.results.puts("Editor box: #{iframe} has correct value: #{value}")
+        true
+      rescue StandardError
+        Report.results.puts("Editor box: #{iframe} has wrong value: #{value}")
+        false
+      rescue StandardError
+        Report.results.puts("Editor box: #{iframe} does not exist")
+        false
+      end
+    end
+  end
+end

data/lib/main.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+# Created on 20 Sept 2017
+# @author: Andy Perrett
+#
+# Versions:
+# 1.0 - Baseline
+#
+# main.rb - Framework Driver Script
+module Main
+  require_relative './taf_config.rb'
+
+  begin
+    # holds list of test file names read from the input file
+    test_file_names = []
+
+    # variables to manage the failure reporting
+    $testStepPasses     = 0
+    $testStepFailures   = 0
+    $testStepNotrun     = 0
+    $totalTestPasses    = 0
+    $totalTestFailures  = 0
+    $totalTestNotrun = 0
+    $previousTestFail = false
+    $currentTestFail = false
+    # initialised stores for the input xlsx test data
+    $XlsxDoc = ''
+
+    begin
+      # check if the test suite file name exists on the command line
+      # allow a user to input 1 or 2 arguments in to CMD line the 2 values are:
+      # Testsuite File and Browser.
+      if ARGV.length < 2
+        $testSuiteFile = ARGV[0]
+        puts 'Only one argument needed: {TestSuite File}'
+      elsif ARGV.length < 3
+        $testSuiteFile = ARGV[0]
+        $browserType = ARGV[1]
+        puts 'Only 2 arguments needed: {TestSuite File} {Browser}'
+      elsif ARGV.length < 4
+        $testSuiteFile = ARGV[0]
+        $browserType = ARGV[1]
+        $securityTest = ARGV[2]
+        puts 'Only 3 arguments needed: {TestSuite File} {Browser} {Security test}'
+      else
+        # unable to open file as not supplied as command-line parameter
+        $testSuiteFile = 'unknown'
+        error_to_display = 'Test File has not been supplied as a command-line parameter as expected'
+        raise IOError, error_to_display  
+      end
+
+    # Get the test suite data
+    Parser.read_test_suite_data
+
+  # unable to read the test file then handle the error and terminate
+  rescue StandardError => error
+    warn error
+    $stdout.puts error
+    abort
+  end
+
+    puts "There are: #{$numberOfTestSpecs} test files to process \n"
+
+    # process the test files to execute the tests
+    TestEngine.process_testfiles
+
+    # get the overall test end time
+    $test_end_time = Report.current_time
+
+    # output the overall test summary
+    ReportSummary.print_overall_test_summary
+    JunitReport.test_summary_junit
+  end
+end

data/lib/parser/parser.rb

@@ -0,0 +1,87 @@
+# Created on 02 Aug 2018
+# @author: Andy Perrett
+#
+# Versions:
+# 1.0 - Baseline
+#
+# parser.rb - basic parser functions
+module Parser
+  require_relative '../taf_config.rb'
+  # variables:
+  @XlsxFileNameType = '.xlsx'
+
+ # read in the data from the test suite file
+  def self.read_test_suite_data
+    # check if the file list exists and is readable
+    if (File.file?($testSuiteFile) & File.readable?($testSuiteFile))
+      puts "\nProcessing test suite file: #{$testSuiteFile}"
+      # get the file type
+      fileType = File.extname($testSuiteFile)
+      # extract the test data from the test suite
+      if (fileType.casecmp(@XlsxFileNameType) == 0)
+        # process as xlsx...
+        $XlsxSuiteDoc = RubyXL::Parser.parse($testSuiteFile)
+        # ...and parse...
+        XlsxParser.parse_xlxs_test_suite_header_data
+      else
+        # the file type is not that expected so create
+        # a error message and raise an exception
+        error_to_display = "Test Suite file: '#{$testSuiteFile}' "\
+                           "type not recognised (must be .xlsx)"
+        raise IOError, error_to_display
+      end
+        # if unable to read the test file list then construct
+        # a custom error message and raise an exception
+    elsif error_to_display = "Test Suite file: '#{$testSuiteFile}' "\
+                             "does not exist or is unreadable"
+        raise IOError, error_to_display
+    end
+  end
+
+  def self.parse_test_suite_data(testSpecIndex)
+    begin
+      # get the file type
+      fileType = File.extname($testSuiteFile)
+
+      if (fileType.casecmp(@XlsxFileNameType) == 0)
+        XlsxParser.parse_xlxs_test_suite_data(testSpecIndex)
+      else
+        # the file type is not that expected so create a
+        # error message and raise an exception
+        error_to_display = "Test Suite file: '#{$testSuiteFile}' "\
+                           "type not recognised (must be .xlsx)"
+        raise IOError, error_to_display
+      end
+    end
+  end
+
+  # readTestData
+  def self.read_test_data(testFileName)
+    # get the file type
+    fileType = File.extname(testFileName)
+    if (fileType.casecmp(@XlsxFileNameType) == 0)
+      puts "Processing test file: #{testFileName}"
+      puts "Browser Type: #{$browserType}"
+      puts "Security Test: #{$securityTest}"
+      $xlsxDoc = RubyXL::Parser.parse(testFileName)
+      XlsxParser.parse_xlxs_test_header_data
+      return 'XLSX'
+    else
+      # if unable to read the test file list then construct a custom error
+      # message and raise an exception.
+      error_to_display = "Test File Name: '#{testFileName}' " \
+                         "type not recognised (must be .xslx)"
+      raise IOError, error_to_display
+    end
+
+    # if an error occurred reading the test file list then
+    # re-raise the exception.
+  rescue StandardError => error
+    raise IOError, error
+  end
+
+  # parseTestStepData
+  def self.parse_test_step_data(testFileType)
+    XlsxParser.parse_test_step_data(testFileType)
+  end
+end