RubyGems - awetestlib - Versions diffs - 0.1.30-x86-mingw32 → 1.2.4-x86-mingw32 - Mend

awetestlib 0.1.30-x86-mingw32 → 1.2.4-x86-mingw32

Files changed (43) hide show

checksums.yaml +7 -0
data/README.md +101 -41
data/awetestlib.gemspec +36 -47
data/awetestlib_osx.gemspec +24 -18
data/awetestlib_windows.gemspec +46 -0
data/bin/awetestlib +130 -111
data/bin/awetestlib-driver-setup.rb +0 -2
data/bin/awetestlib-helpers.rb +43 -30
data/lib/awetestlib.rb +196 -20
data/lib/awetestlib/command_line.rb +44 -0
data/lib/awetestlib/html_report.rb +57 -50
data/lib/awetestlib/logging.rb +242 -171
data/lib/awetestlib/regression/awetest_dsl.rb +4240 -0
data/lib/awetestlib/regression/browser.rb +514 -397
data/lib/awetestlib/regression/date_and_time.rb +280 -0
data/lib/awetestlib/regression/drag_and_drop.rb +24 -0
data/lib/awetestlib/regression/find.rb +70 -43
data/lib/awetestlib/regression/legacy.rb +1 -1
data/lib/awetestlib/regression/mobile.rb +293 -0
data/lib/awetestlib/regression/reporting.rb +298 -0
data/lib/awetestlib/regression/runner.rb +156 -200
data/lib/awetestlib/regression/tables.rb +117 -7
data/lib/awetestlib/regression/test_data.rb +354 -0
data/lib/awetestlib/regression/user_input.rb +179 -93
data/lib/awetestlib/regression/utilities.rb +755 -286
data/lib/awetestlib/regression/validations.rb +325 -115
data/lib/awetestlib/regression/waits.rb +60 -133
data/lib/awetestlib/runner.rb +5 -2
data/lib/version.rb +11 -2
data/setup_samples/sample_cucumber/features/step_definitions/predefined_steps.rb +109 -49
data/setup_samples/sample_mobile_app/features/support/env.rb +1 -1
data/test/google_search2.rb +7 -6
data/test/popup_child_0.rb +13 -0
data/test/popup_child_1.rb +33 -0
data/test/watir_no_require.rb +13 -0
data/test/watir_with_require.rb +16 -0
data/test/zoho_exercise.rb +8 -8
metadata +216 -303
data/AwetestLib Instructions.rtf +0 -0
data/awetestlib.windows.gemspec +0 -42
data/lib/patches/README +0 -2
data/lib/patches/firewatir.rb +0 -106
data/lib/patches/watir.rb +0 -175

data/lib/awetestlib/command_line.rb ADDED Viewed

@@ -0,0 +1,44 @@
+module CommandLine
+  def build_awetestlib_command_line(options)
+    option_keys = {
+        :browser              => '-b',
+        :capture_load_times   => '-L',
+        :debug_dsl            => '-d',
+        :device_id            => '-I',
+        :device_type          => '-T',
+        :emulator             => '-E',
+        :environment_name     => '-n',
+        :environment_nodename => '-f',
+        :environment_url      => '-e',
+        :global_debug         => '-D',
+        :library              => '-l',
+        :log_path_subdir      => '-S',
+        :output_to_log        => '-o',
+        :platform             => '-P',
+        :pry                  => '-p',
+        :remote_url           => '-u',
+        :report_all_test_refs => '-R',
+        :root_path            => '-r',
+        :screencap_path       => '-s',
+        :sdk                  => '-K',
+        :locate_timeout       => '-t',
+        :version              => '-v',
+        :xls_path             => '-x',
+        :help                 => '-h',
+    }
+    run_cmd = "awetestlib #{options[:script_file]}"
+    option_keys.each_key do |opt|
+      if options[opt]
+        run_cmd << " #{option_keys[opt]} #{options[opt]}"
+      end
+    end
+    run_cmd
+  end
+end

data/lib/awetestlib/html_report.rb CHANGED Viewed

@@ -2,34 +2,38 @@ module Awetestlib
   # Report generator for Awetestlib.
   class HtmlReport
+    attr_accessor :report_name,
+                  :html_file_name,
+                  :json_file_name
+    # TODO: split the json and html reports to separate classes
     # Initialize the report class
     # @private
-    def initialize(report_name)
-      @reportname     = report_name
-      @reportContent1 = ''
-      @reportContent2 = ''
+    def initialize(report_name, report_dir, ts)
+      @report_name      = report_name
+      @report_content_1 = ''
+      @report_content_2 = ''
+      rpt_time            = "#{ts.strftime("%Y%m%d_%H%M%S")}"
+      self.html_file_name = File.join(report_dir, "#{report_name}_#{rpt_time}.html")
+      self.json_file_name = File.join(report_dir, "#{report_name}_#{rpt_time}.json")
     end
     # Create a report
     # @private
-    def create_report(reportName)
+    def create_report(report_name)
       # Get current time
       t = Time.now
-      @col_1_p        = '65%'
-      @col_2_p        = '25%'
-      @col_3_p        = '10%'
-      # Create the report name
-      rpt_time        = "#{t.strftime("%Y%m%d_%H%M%S")}"
-      rpt_nice_time   = "#{t.strftime("%m/%d/%Y @ %H:%M:%S")}"
-      rpt_file_name   = "#{reportName}_#{rpt_time}.html"
+      @col_1_p          = '66%'
+      @col_2_p          = '22%'
+      @col_3_p          = '6%'
+      @col_4_p          = '6%'
-      # Create the HTML report
-      rpt_file        = File.open(rpt_file_name, 'w')
+      rpt_nice_time     = "#{t.strftime("%m/%d/%Y @ %H:%M:%S")}"
       # Format the header of the HTML report
-      @reportContent1 = '<html>
+      @report_content_1 = '<html>
         <head>
         <meta content=text/html; charset=ISO-8859-1 http-equiv=content-type>
         <title>Awetestlib Test Run</title>
@@ -66,7 +70,7 @@ module Awetestlib
         <tbody>
         <tr>
         <td style=width: 150px;>&nbsp;</td>
-        <td align=left><img src="https://raw.github.com/3qilabs/awetestlib/develop/images/logo.png"></img></td>
+        <td align=left><img src="http://awetest.com/images/awetest_logo.png"></img></td>
         <td align=right><p class=title>Test Report</p></td>
         </tr>
         </tbody>
@@ -80,7 +84,7 @@ module Awetestlib
         <td width=10%><p class=normal_text></p></td>
         <td width=20%><p class=bold_text>Script</p></td>
         <td width=5%><p class=bold_text>:</p></td>
-        <td width=65%><p class=normal_text>' + @reportname.capitalize + '</p></td>
+        <td width=65%><p class=normal_text>' + report_name.capitalize + '</p></td>
         </tr>
         <tr>
         <td width=10%><p class=normal_text></p></td>
@@ -90,7 +94,7 @@ module Awetestlib
         </tr>
         <tr>'
-      @reportContent2 = '</tr>
+      @report_content_2 = '</tr>
         </tbody>
         </table>
         </center>
@@ -101,28 +105,34 @@ module Awetestlib
         <tr>
         <td class=bborder_left width=' + @col_1_p + '><p>Test Step</p></td>
         <td class=bborder_left width=' + @col_2_p + '><p>Location</p></td>
-        <td class=bborder_left width=' + @col_3_p + '><p>Result</p></td>
+        <td class=bborder_left width=' + @col_3_p + '><p>Duration</p></td>
+        <td class=bborder_left width=' + @col_4_p + '><p>Result</p></td>
         </tr>' + "\n"
-      # Close the report
-      rpt_file.close
+      @json_content                = {}
+      @json_content['report_type'] = 'Awetestlib Report'
+      @json_content['Data_order'] = 'message, location, result, level, Time.now, line' #, duration'
+      @line_no                     = 1
-      return rpt_file_name
     end
     # Add a row to the report
     # @private
-    def add_to_report(message, location, result, level = 1)
+    def add_to_report(message, location, result, duration = 0, level = 1)
       # Format the body of the HTML report
+      fmt_duration = "#{'%9.5f' % (duration)}"
       left_class   = 'border_left'
       right_class  = 'border_right'
       pgph_class   = 'normal_text'
       loc_class    = 'center_text'
+      dur_class    = 'center_text'
       rslt_class   = 'result_ok'
       middle_class = 'border_middle'
-      rslt_class = 'result_nok' if result == "FAILED"
+      rslt_class   = 'result_nok' if result == "FAILED"
       case result
         when 'FAILED'
           rslt_class = 'result_nok'
@@ -135,6 +145,10 @@ module Awetestlib
               left_class   = 'mark_testlevel_left'
               middle_class = 'mark_testlevel_middle'
               right_class  = 'mark_testlevel_right'
+              location     = ''
+              fmt_duration = ''
+            else
+              result = ''
             end
           end
       end
@@ -142,47 +156,40 @@ module Awetestlib
       row = '<tr>
         <td class=' + left_class + ' width=' + @col_1_p + '><p class=' + pgph_class + '>' + message + '</p></td>
         <td class=' + middle_class + ' width=' + @col_2_p + '><p class=' + loc_class + '>' + location + '</p></td>
-        <td class=' + right_class + ' width=' + @col_3_p + '><p class=' + rslt_class + '>' + result + '</p></td>
+        <td class=' + middle_class + ' width=' + @col_3_p + '><p class=' + dur_class + '>' + fmt_duration + '</p></td>
+        <td class=' + right_class + ' width=' + @col_4_p + '><p class=' + rslt_class + '>' + result + '</p></td>
         </tr>'
-      @reportContent2 += row + "\n"
-      #if (result == 'PASSED')
-      #  @reportContent2 = @reportContent2 + '<tr>C'
-      #  @reportContent2 = @reportContent2 + '<td class=border_right width=20%><p class=result_ok>' + result + '</p></td>'
-      #elsif (result == 'FAILED')
-      #  @reportContent2 = @reportContent2 + '<tr><td class=border_left width=80%><p class=normal_text>' + step + '</p></td>'
-      #  @reportContent2 = @reportContent2 + '<td class=border_right width=20%><p class=result_nok>' + result + '</p></td>'
-      #elsif level < 1
-      #  @reportContent2 = @reportContent2 + '<tr><td class=border_left width=80%><p class=normal_text>' + step + '</p></td>'
-      #  @reportContent2 = @reportContent2 + '<td class=border_right width=20%><p class=result_ok>' + result + '</p></td>'
-      #else
-      #  @reportContent2 = @reportContent2 + '<tr><td class=mark_testlevel_left width=80%><p class=bold_large_text>' + step + '</p></td>'
-      #  @reportContent2 = @reportContent2 + '<td class=mark_testlevel_right width=20%><p class=result_ok>' + result + '</p></td>'
-      #end
+      @report_content_2                    += row + "\n"
+      @json_content["line_no_#{@line_no}"] = [message, location, result, level, Time.now, @line_no] #, duration]
+      @line_no                             += 1
     end
     # Close the report HTML
     # @private
-    def finish_report(reportName)
-      # Open the HTML report
-      rpt_file = File.open(reportName, 'a')
+    def finish_report
-      @reportContent2 = @reportContent2 + '<tr>
+      # HTML Report
+      rpt_file = File.open(self.html_file_name, 'w')
+      @report_content_2 = @report_content_2 + '<tr>
       <td class=bborder_left width=' + @col_1_p + '><p>&nbsp;</p></td>
       <td class=bborder_left width=' + @col_2_p + '><p>&nbsp;</p></td>
       <td class=bborder_left width=' + @col_3_p + '><p>&nbsp;</p></td>
+      <td class=bborder_left width=' + @col_4_p + '><p>&nbsp;</p></td>
       </tr>
       </table>'
+      rpt_file.puts(@report_content_1)
+      rpt_file.puts(@report_content_2)
+      rpt_file.close
-      rpt_file.puts(@reportContent1)
+      # JSON report
+      rpt_json = File.open(self.json_file_name, 'w')
+      rpt_json.puts(@json_content.to_json)
+      rpt_json.close
-      rpt_file.puts(@reportContent2)
+      self.html_file_name
-      # Close the report
-      rpt_file.close
     end
   end
 end

data/lib/awetestlib/logging.rb CHANGED Viewed

@@ -1,7 +1,8 @@
 module Awetestlib
   # Logging and reporting.
-  module Logging
+  module Logging
+    include ActiveSupport
     # @deprecated
     def self.included(mod)
       # puts "RegressionSupport::Logging extended by #{mod}"
@@ -13,39 +14,44 @@ module Awetestlib
     # @param [String] message The message to be placed in the log.
     # @param [String, Fixnum] tag Indicates the type of message. Valid string values are 'FAIL' and 'PASS'.
     # Valid number values are 0 to 9.
-    # @param [Fixnum] lnbr the line number in the calling script
-    # @param [Fixnum] addts Obsolete, no longer used.
-    # @param [String] exception Obsolete, no longer used.
-    def log_message(severity, message, tag = '', lnbr = nil, addts = 1, exception=nil)
-      # caller = get_caller(lnbr, exception)
-      # @sequence ||= log_properties ? log_properties.fetch('sequence', 0) : 0
-      # @sequence += 1
+    def log_message(severity, message, tag = '', who_called = nil, exception = nil)
+      level  = nil
       t        = Time.now.utc
-      @last_t  ||= t
-      @last_t  = t
-      dt       = t.strftime("%H%M%S")
-      mySev    = translate_severity(severity)
-      myCaller = get_caller(lnbr) || 'unknown'
-      myMsg = "%-8s" % mySev
-      myMsg << '[' + dt + ']:'
+      @last_ts  ||= t
+      duration = (t.to_f - @last_ts.to_f)
+      # durations = calculate_durations(tag, t = Time.now.utc)
+      tstmp    = t.strftime("%H%M%S") + '.' + t.to_f.modulo(t.to_i).to_s.split('.')[1].slice(0, 5)
+      my_sev = translate_severity(severity)
+      my_msg = '%-8s' % my_sev
+      my_msg << '[' + tstmp + ']:'
+      my_msg << "[#{'%9.5f' % duration}]:"
       if tag
         if tag.is_a? Fixnum
+          level = tag.to_i
           tag = '-LVL' + tag.to_s
         end
       end
-      myMsg << "[%-5s]:" % tag
-      #myMsg << '[' + t.to_f.to_s + ']:'
-      #myMsg << '[' + myCaller + ']:'
-      #myMsg << "#{get_call_list[-1]}#{get_call_list[-2]} "
-      myMsg << get_call_list_new.to_s
-      myMsg << ' '+message
-      myMsg << " [#{lnbr}] " if lnbr
+      my_msg << '[%-6s][:' % tag
-      @myLog.add(severity, myMsg) if @myLog # add persistent logging for awetestlib. pmn 05jun2012
-      puts myMsg+"\n"
+      unless who_called
+        who_called = exception.nil? ? get_debug_list(false, true, true) : get_caller(exception)
+      end
+      my_msg << who_called
+      my_msg << ']: ' + message
+      @logger.add(severity, my_msg) if @logger
+      puts my_msg + "\n"
+      @report_class.add_to_report(message, who_called, text_for_level(tag), duration, level) if tag and tag.length > 0
+      @last_ts = t
       nil # so method doesn't return whole @output.
     end
@@ -55,20 +61,24 @@ module Awetestlib
     # Translates tag value to corresponding value for +pass+ column in database.
     # @private
     # @param [String, Fixnum] tag
-    # @return [String] Single character
-    def pass_code_for(tag)
-      case
-        when tag =~ /PASS/
-          'P'
-        when tag =~ /FAIL/
-          'F'
+    # @return [String] Single word
+    def text_for_level(tag)
+      case tag
+        when /PASS/
+          'PASSED'
+        when /FAIL/
+          'FAILED'
         #when tag =~ /\d+/ # avoid having to require andand for awetestlib. pmn 05jun2012
-        when tag.andand.is_a?(Fixnum)
-          'H'
-        when tag =~ /DONE/
-          'D'
-        when tag =~ /role/
-          'R'
+        when /\d+/
+          unless tag == '0'
+            tag.to_s
+          end
+        when /DONE/
+          'DONE'
+        when /role/
+          'ROLE'
+        else
+          ''
       end
     end
@@ -77,11 +87,11 @@ module Awetestlib
       output_lines = File.open(output_file, 'r') { |f| f.readlines }
       puts "IM FAILING?! #{passed}"
-                                                              # if passed
+      # if passed
       log_messages = ['[log]', '[error]']
       output_lines = output_lines.select { |l| log_messages } #.detect{|msg| l.include?(msg)} }
-      while line = output_lines.shift do
+      while line == output_lines.shift do
         puts "line to be logged: #{line}"
         if line.include? '[log]'
           passed_to_log line
@@ -91,7 +101,7 @@ module Awetestlib
           failed_to_log output_lines.join("\n")
           break
         else
-          debug_tolog line
+          debug_to_log line
         end
       end
@@ -102,7 +112,6 @@ module Awetestlib
       return { :result => passed, :msg => output_lines }
     end
     # Write a status message to the log and report indicating location or activity
     # in the script. mark_test_level automatically determines the call hierarchy level
     # of the calling method within the script and project utility methods.  The top level
@@ -113,33 +122,41 @@ module Awetestlib
     # @param [Fixnum] lvl '0' forces a message to the report without a specific level
     # attached. Any other integer is ignored in favor of the calculated level
     # @param [String] desc Any additional information to add to the message.
-    # @param [Boolean] dbg When set to true adds a trace to the message.
-    # @return [void]
-    def mark_test_level(message = '', lvl = nil, desc = '', dbg = nil)
-      call_arr = get_call_array()
-      #debug_to_log("#{call_arr.to_yaml}")
+    # @param [Boolean] trc When set to true adds a trace to the message.
+    # @return [Boolean] Always returns true
+    def mark_test_level(message = '', lvl = nil, desc = '', caller = 1, wai_lvl = 4, trc = $debug)
       strg = ''
-      call_script, call_line, call_meth = parse_caller(call_arr[1])
+      list = nil
+      call_arr = get_call_array
+      debug_to_log("#{call_arr.to_yaml}") if trc
+      call_script, call_line, call_meth = parse_caller(call_arr[caller])
       if not lvl or lvl > 1
         lvl, list = get_test_level
-        strg << "#{call_meth.titleize}"
+        strg << "#{call_meth.titleize}: "
+      end
+      if lvl == 0
+        parse_error_references(message)
       end
-      strg << " #{message}" if message.length > 0
+      strg << "#{message}" if message.length > 0
       strg << " (#{desc})" if desc.length > 0
-      strg << " [#{call_line}]" if dbg or @debug_calls
-      strg << "\n#{list.to_yaml}" if dbg or @debug_calls
-      @report_class.add_to_report(strg, "&nbsp", "&nbsp", lvl || 1) unless Awetestlib::Runner.nil?
-      log_message(INFO, strg, lvl, nil, 1)
+      strg << " [#{call_line}]" if trc
+      strg << "\n#{list.to_yaml}" if list and trc
+      log_message(INFO, strg, lvl, where_am_i?(wai_lvl))
+      true
     rescue
-      failed_to_log("#{__method__}: #{$!}")
+      failed_to_log(unable_to)
     end
     alias mark_testlevel mark_test_level
     # @param [String] message The text to place in the log
     # @return [void]
-    def info_to_log(message, lnbr = nil)
-      log_message(INFO, message, 0, lnbr)
+    def info_to_log(message, wai_lvl = 1)
+      log_message(INFO, message, '', where_am_i?(wai_lvl))
     end
     alias message_tolog info_to_log
@@ -148,9 +165,12 @@ module Awetestlib
     # @param [String] message The text to place in the log and report
     # @return [void]
-    def debug_to_log(message, lnbr = nil, dbg = false)
-      message << "\n#{get_debug_list}" if dbg or @debug_calls # and not @debug_calls_fail_only)
-      log_message(DEBUG, "#{message}", nil, lnbr)
+    def debug_to_log(message, wai_lvl = 3)
+      message << "\n#{get_debug_list}" if $debug
+      scr_lvl = first_script_index
+      lvl     = scr_lvl > 0 ? scr_lvl : wai_lvl
+      log_message(DEBUG, "#{message}", nil, where_am_i?(lvl))
+      true
     end
     alias debug_tolog debug_to_log
@@ -158,20 +178,25 @@ module Awetestlib
     # @note Do not use for failed validations. Use only for serious error conditions.
     # @return [void]
     # @param [String] message The text to place in the log and report
-    def error_to_log(message, lnbr = nil)
-      log_message(ERROR, message, nil, lnbr)
+    def error_to_log(message, wai_lvl = 3, exception = nil)
+      scr_lvl = first_script_index
+      lvl     = scr_lvl > 0 ? scr_lvl : wai_lvl
+      log_message(ERROR, message, nil, where_am_i?(lvl), exception)
+      false
     end
     alias error_tolog error_to_log
     # @param [String] message The text to place in the log and report
     # @return [void]
-    def passed_to_log(message, lnbr = nil, dbg = false)
-      message << " \n#{get_debug_list}" if dbg or @debug_calls # and not @debug_calls_fail_only)
+    def passed_to_log(message, wai_lvl = 3, dbg = false)
+      message << " \n#{get_debug_list}" if $debug
       @my_passed_count += 1 if @my_passed_count
       parse_error_references(message)
-      @report_class.add_to_report(message, get_caller(lnbr), "PASSED") unless Awetestlib::Runner.nil?
-      log_message(INFO, "#{message}", PASS, lnbr)
+      scr_lvl = first_script_index
+      lvl     = scr_lvl > 0 ? scr_lvl : wai_lvl
+      log_message(INFO, "#{message}", PASS, where_am_i?(lvl))
+      true
     end
     alias validate_passed_tolog passed_to_log
@@ -182,12 +207,14 @@ module Awetestlib
     # @param [String] message The text to place in the log and report
     # @return [void]
-    def failed_to_log(message, lnbr = nil, dbg = false, exception = nil)
-      message << " \n#{get_debug_list}" if dbg.to_s == 'true' or @debug_calls or @debug_calls_fail_only
+    def failed_to_log(message, wai_lvl = 3, exception = nil)
+      message << " \n#{get_debug_list}" if $debug
       @my_failed_count += 1 if @my_failed_count
       parse_error_references(message, true)
-      @report_class.add_to_report("#{message}", get_caller(lnbr), "FAILED") unless Awetestlib::Runner.nil?
-      log_message(WARN, "#{message}", FAIL, lnbr, nil, exception)
+      scr_lvl = first_script_index
+      lvl     = scr_lvl > 0 ? scr_lvl : wai_lvl
+      log_message(WARN, "#{message}", FAIL, where_am_i?(lvl), exception)
+      false
     end
     alias validate_failed_tolog failed_to_log
@@ -198,168 +225,212 @@ module Awetestlib
     # @param [String] message The text to place in the log and report
     # @return [void]
-    def fatal_to_log(message, lnbr = nil, dbg = false, exception = nil)
-      message << " \n#{get_debug_list}" if dbg.to_s == 'true' or (@debug_calls and not @debug_calls_fail_only)
+    def fatal_to_log(message, wai_lvl = 3, exception = nil)
+      message << " #{get_debug_list}"
       @my_failed_count += 1 if @my_failed_count
       parse_error_references(message, true)
-      @report_class.add_to_report("#{message}", get_caller(lnbr), "FAILED") unless Awetestlib::Runner.nil?
-      debug_to_report("#{__method__}:\n#{dump_caller(lnbr)}")
-      log_message(FATAL, "#{message} (#{lnbr})", FAIL, lnbr, nil, exception)
+      debug_to_report("#{__method__}:\n#{dump_caller(nil)}")
+      scr_lvl = first_script_index
+      lvl     = scr_lvl > 0 ? scr_lvl : wai_lvl
+      log_message(FATAL, "#{message} '#{$!}'", FAIL, where_am_i?(lvl), exception)
+      false
     end
     alias fatal_tolog fatal_to_log
     # @param [String] message The text to place in the log and report
-    # @return [void]
-    def message_to_report(message, dbg = false)
-      mark_testlevel(message, 0, '', dbg)
+    # @return [Boolean] Always returns true
+    def message_to_report(message, wai_lvl = 4)
+      scr_lvl = first_script_index
+      lvl     = scr_lvl > 0 ? scr_lvl : wai_lvl
+      mark_test_level(message, 0, '', 1, lvl + 1)
+      true
     end
     # @param [String] message The text to place in the log and report
     # @return [void]
-    def debug_to_report(message, dbg = false)
-      mark_testlevel("(DEBUG): ", 0, "#{message}", dbg)
+    def debug_to_report(message, wai_lvl = 4)
+      scr_lvl = first_script_index
+      lvl     = scr_lvl > 0 ? scr_lvl : wai_lvl
+      mark_test_level("(DEBUG): ", 0, "#{message}", 1, lvl + 1)
+      true
     end
     # @private
-    # @return [Fixnum] required by logger.
+    # @severity [Fixnum] used by logger.
     def translate_severity(severity)
-      mySev = ''
-      case
-        when severity == 0
-          mySev = 'DEBUG'
-        when severity == 1
-          mySev = 'INFO'
-        when severity == 2
-          mySev = 'WARN'
-        when severity == 3
-          mySev = 'ERROR'
-        when severity == 4
-          mySev = 'FATAL'
-        when severity > 4
-          mySev = 'UNKNOWN'
+      case severity
+        when 0
+          'DEBUG'
+        when 1
+          'INFO'
+        when 2
+          'WARN'
+        when 3
+          'ERROR'
+        when 4
+          'FATAL'
+        when 4
+          'UNKNOWN'
+        else
+          ''
       end
-      mySev
     end
     # @private
-    def get_caller(lnbr=nil, exception=nil)
-      script_name ||= File.basename(script_file)
-      if lnbr && script_type.eql?("Selenium")
-        [script_name, lnbr, 'in run()'].join(":")
-      elsif lnbr && script_type.eql?("MobileNativeApp")
-        [script_name, lnbr, 'in scenario()'].join(":")
-      else
+    def get_call_array(depth = 9)
+      arr       = []
+      call_list = Kernel.caller
+      call_list.each_index do |x|
+        my_caller = call_list[x].to_s
+        my_caller =~ /([\(\)\w_\_\-\.]+\:\d+\:.*?)$/
+        # myCaller =~ /([\(\)\w_\_\-\.]+\:\d+\:?.*?)$/
+        arr << $1.gsub(/eval/, @myName)
+        break if x > depth or my_caller =~ /:in .run.*$/
+      end
+      arr
+    rescue
+      failed_to_log(unable_to)
+    end
+    # @private
+    def get_caller(exception = nil)
+      # TODO: Awetestlib no longer supports script types 'Selenium' or 'MobileNativeApp'.
+      # Those are supported directly by Shamisen and Awetest
+      # script_name ||= File.basename(@myName)
+      # if lnbr && script_type.eql?("Selenium")
+      #   [script_name, lnbr, 'in run()'].join(":")
+      # elsif lnbr && script_type.eql?("MobileNativeApp")
+      #   [script_name, lnbr, 'in scenario()'].join(":")
+      # else
         caller_object = exception ? exception.backtrace : Kernel.caller
         call_frame    = caller_object.detect do |frame|
-          frame.match(/#{script_name}/) or (library && frame.match(/#{library}/))
+          frame.match(/#{self.script_name}/) or
+              (@library && frame.match(/#{@library}/)) or
+              (@library2 && frame.match(/#{@library2}/))
         end
-        unless call_frame.nil?
+        if call_frame.nil?
+          'unknown'
+        else
           call_frame.gsub!(/^C:/, '')
           file, line, method = call_frame.split(":")
           [File.basename(file), line, method].join(":")
-        else
-          'unknown'
         end
-      end
+      # end
     end
     # @private
-    def init_logger(logFile, scriptName = nil)
-      if File.exist?(logFile)
-        puts "==> Logfile already exists: #{logFile}. Replacing it."
+    def init_logger(log_spec, script_name = nil)
+      if File.exist?(log_spec)
+        puts "==> log_spec already exists: #{log_spec}. Replacing it."
         begin
-          File.delete(logFile)
+          File.delete(log_spec)
         rescue
-          puts "#{scriptName}: init_logger RESCUE: #{$!}"
+          puts "#{script_name}: init_logger RESCUE: #{$!}"
         end
       end
-      logger               = ActiveSupport::BufferedLogger.new(logFile)
-      logger.level         = ActiveSupport::BufferedLogger::DEBUG
-      logger.auto_flushing = (true)
-      logger.add(INFO, "#{logFile}\n#{ENV["OS"]}")
+      logger       = ActiveSupport::Logger.new(log_spec)
+      logger.level = ActiveSupport::Logger::DEBUG
+      # logger.auto_flushing = (true)
+      logger.add(INFO, "#{log_spec}\n#{ENV["OS"]}")
       logger
     end
     #private init_logger
     # @private
-    def start_run(ts = nil)
-      @start_timestamp = Time.now unless ts
-      utc_ts = @start_timestamp.getutc
-      loc_tm = "#{@start_timestamp.strftime("%H:%M:%S")} #{@start_timestamp.zone}"
+    def log_begin_run(begin_time)
+      message_to_report(">> Running on host '#{$os.nodename}'")
+      message_to_report(">> Running #{$os.name} version #{$os.version}")
+      @my_failed_count = 0 unless @my_failed_count
+      @my_passed_count = 0 unless @my_passed_count
+      utc_ts           = begin_time.getutc
+      loc_tm           = "#{begin_time.strftime("%H:%M:%S")} #{begin_time.zone}"
       message_to_report(">> Starting #{@myName.titleize} #{utc_ts} (#{loc_tm})")
+      debug_to_log("\nAwetestlib #{$metadata.to_yaml}")
+    rescue
+      failed_to_log(unable_to)
     end
-    alias start_to_log start_run
     # @private
     # Tally and report duration, validation and failure counts, and end time for the script.
     # @param [DateTime] ts Time stamp indicating the time the script completed.
-    def finish_run(ts = Time.now)
+    def log_finish_run(ts = Time.now, begin_time = $begin_time)
       tally_error_references
       message_to_report(
-          ">> #{@myName.titleize} duration: #{sec2hms(ts - @start_timestamp)}")
+          ">> #{@myName.titleize} duration: #{sec2hms(ts - begin_time)}")
       message_to_report(">> #{@myName.titleize} validations: #{@my_passed_count + @my_failed_count} "+
-                         "fail: #{@my_failed_count}]") if @my_passed_count and @my_failed_count
+                            "fail: #{@my_failed_count}]") if @my_passed_count and @my_failed_count
       utc_ts = ts.getutc
       loc_tm = "#{ts.strftime("%H:%M:%S")} #{ts.zone}"
       message_to_report(">> End #{@myName.titleize} #{utc_ts} (#{loc_tm})")
     end
-    alias finish_to_log finish_run
-    # @private
-    def tally_error_references(list_tags = @report_all_refs)
-      tags_tested = 0
-      tags_hit    = 0
-      if @my_error_hits and @my_error_hits.length > 0
-        message_to_report(">> Tagged Error Hits:")
-        tags_hit = @my_error_hits.length
-        @my_error_hits.each_key do |ref|
-          message_to_report("#{ref} - #{@my_error_hits[ref]}")
-        end
-      end
-      if list_tags
-        if @my_error_references and @my_error_references.length > 0
-          message_to_report(">> Error and Test Case Tags:")
-          tags_tested = @my_error_references.length
-          @my_error_references.each_key do |ref|
-            message_to_report("#{ref} - #{@my_error_references[ref]}")
-          end
-          message_to_report(">> Fails were hit on #{tags_hit} of #{tags_tested} error/test case references")
+    def calculate_durations(tag, t = Time.now.utc)
+      last_log_ts ||= t
+      last_lvl_ts ||= t
+      last_val_ts ||= t
+      log_dur     = "%9.5f" % (t.to_f - last_log_ts.to_f)
+      lvl_dur     = "%9.5f" % (t.to_f - last_lvl_ts.to_f)
+      val_dur     = "%9.5f" % (t.to_f - last_val_ts.to_f)
+      last_log_ts = t
+      case tag
+        when /LVL/i
+          last_lvl_ts = t
+          dur         = lvl_dur
+        when /PASS|FAIL/i
+          last_val_ts = t
+          dur         = val_dur
         else
-          message_to_report(">> No Error or Test Case References found.")
-        end
+          dur = log_dur
       end
+      [dur, log_dur, lvl_dur, val_dur]
     end
-    # @private
-    def parse_error_references(message, fail = false)
-      msg = message.dup
-      while msg =~ /(\*\*\*\s+[\w\d_\s,-:;\?]+\s+\*\*\*)/
-        capture_error_reference($1, fail)
-        msg.sub!($1, '')
+    def with_caller(message = '', *strings)
+      call_arr                          = get_call_array
+      call_script, call_line, call_meth = parse_caller(call_arr[1])
+      strg                              = "#{call_meth.titleize}"
+      strg << ':' # if strings.size > 0
+      strg << ' '
+      strg << build_message(message, *strings)
+      strg
+    end
+    alias message_with_caller with_caller
+    alias msg_with_caller with_caller
+    def where_am_i?(index = 2)
+      index = index ? index : 2
+      calls = get_call_list_new
+      log_message(DEBUG, "=== #{__LINE__}\n#{calls.to_yaml}\n===") if $debug
+      if calls[index]
+        where = calls[index].dup.to_s
+        here  = where.gsub(/^\[/, '').gsub(/\]\s*$/, '')
+      else
+        here = 'unknown'
       end
+      here
+    rescue
+      failed_to_log(unable_to)
     end
-    # @private
-    def capture_error_reference(ref, fail)
-      if fail
-        @my_error_hits = Hash.new unless @my_error_hits
-        if @my_error_hits[ref]
-          @my_error_hits[ref] += 1
-        else
-          @my_error_hits[ref] = 1
+    def first_script_index(script = @myName)
+      here      = 0
+      call_list = get_call_list_new
+      debug_to_log(DEBUG, with_caller("=== #{__LINE__}\n#{call_list.to_yaml}\n===")) if $debug
+      call_list.each_index do |x|
+        a_caller = call_list[x].to_s
+        a_caller =~ /([\(\)\w_\_\-\.]+\:\d+\:?.*?)$/
+        caller = $1
+        if caller =~ /#{script}/
+          here = x
+          break
         end
-        #debug_to_report("#{__method__}: error hits:\n#{@my_error_hits.to_yaml}")
-      end
-      @my_error_references = Hash.new unless @my_error_references
-      if @my_error_references[ref]
-        @my_error_references[ref] += 1
-      else
-        @my_error_references[ref] = 1
       end
+      here
+    rescue
+      failed_to_log(unable_to)
     end
   end