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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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