tinyusb/tests/vendor/ceedling/lib/tool_executor_helper.rb

require 'constants' # for Verbosity enumeration & $stderr redirect enumeration

class ToolExecutorHelper

  constructor :streaminator, :system_utils, :system_wrapper

  def stderr_redirection(tool_config, logging)
    # if there's no logging enabled, return :stderr_redirect unmodified
    return tool_config[:stderr_redirect] if (not logging)
    
    # if there is logging enabled but the redirect is a custom value (not enum), return the custom string
    return tool_config[:stderr_redirect] if (tool_config[:stderr_redirect].class == String)
 
    # if logging is enabled but there's no custom string, return the AUTO enumeration so $stderr goes into the log
    return StdErrRedirect::AUTO
  end

  def background_exec_cmdline_prepend(tool_config)
    return nil if (tool_config[:background_exec].nil?)
    
    config_exec = tool_config[:background_exec]
    
    if ((config_exec == BackgroundExec::AUTO) and (@system_wrapper.windows?))
      return 'start'
    end

    if (config_exec == BackgroundExec::WIN)
      return 'start'
    end

    return nil
  end

  def osify_path_separators(executable)
    return executable.gsub(/\//, '\\') if (@system_wrapper.windows?)
    return executable
  end
  
  def stderr_redirect_cmdline_append(tool_config)
    return nil if (tool_config[:stderr_redirect].nil?)
    
    config_redirect = tool_config[:stderr_redirect]
    redirect        = StdErrRedirect::NONE
    
    if (config_redirect == StdErrRedirect::AUTO)
       if (@system_wrapper.windows?)
         redirect = StdErrRedirect::WIN
       else
         if (@system_utils.tcsh_shell?)
           redirect = StdErrRedirect::TCSH
         else
           redirect = StdErrRedirect::UNIX           
         end
       end
    end

    case redirect
      # we may need more complicated processing after some learning with various environments
      when StdErrRedirect::NONE then nil
      when StdErrRedirect::WIN  then '2>&1'
      when StdErrRedirect::UNIX then '2>&1'
      when StdErrRedirect::TCSH then '|&'
      else redirect.to_s
    end
  end

  def background_exec_cmdline_append(tool_config)
    return nil if (tool_config[:background_exec].nil?)

    config_exec = tool_config[:background_exec]
    
    # if :auto & windows, then we already prepended 'start' and should append nothing
    return nil if ((config_exec == BackgroundExec::AUTO) and (@system_wrapper.windows?))

    # if :auto & not windows, then we append standard '&'
    return '&' if ((config_exec == BackgroundExec::AUTO) and (not @system_wrapper.windows?))

    # if explicitly Unix, then append '&'
    return '&' if (config_exec == BackgroundExec::UNIX)
    
    # all other cases, including :none, :win, & anything unrecognized, append nothing
    return nil
  end

  # if command succeeded and we have verbosity cranked up, spill our guts
  def print_happy_results(command_str, shell_result, boom=true)
    if ((shell_result[:exit_code] == 0) or ((shell_result[:exit_code] != 0) and not boom))
      output  = "> Shell executed command:\n"
      output += "#{command_str}\n"
      output += "> Produced output:\n"             if (not shell_result[:output].empty?)
      output += "#{shell_result[:output].strip}\n" if (not shell_result[:output].empty?)
      output += "> And exited with status: [#{shell_result[:exit_code]}].\n" if (shell_result[:exit_code] != 0)
      output += "\n"
  
      @streaminator.stdout_puts(output, Verbosity::OBNOXIOUS)
    end
  end

  # if command failed and we have verbosity set to minimum error level, spill our guts
  def print_error_results(command_str, shell_result, boom=true)
    if ((shell_result[:exit_code] != 0) and boom)
      output  = "ERROR: Shell command failed.\n"
      output += "> Shell executed command:\n"
      output += "'#{command_str}'\n"
      output += "> Produced output:\n"             if (not shell_result[:output].empty?)
      output += "#{shell_result[:output].strip}\n" if (not shell_result[:output].empty?)
      output += "> And exited with status: [#{shell_result[:exit_code]}].\n" if (shell_result[:exit_code] != nil)
      output += "> And then likely crashed.\n"                               if (shell_result[:exit_code] == nil)
      output += "\n"

      @streaminator.stderr_puts(output, Verbosity::ERRORS)
    end
  end
  
end