#
# Author:: Adam Jacob (<adam@chef.io>)
# Copyright:: Copyright (c) 2009-2025 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
# License:: Apache License, Version 2.0
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

require "logger"
require "time" unless defined?(Time.zone_offset)

module Mixlib
  module Log
    class Formatter < Logger::Formatter
      @@show_time = true

      def self.show_time=(show = false)
        @@show_time = show
      end

      # Prints a log message as '[time] severity: message' if Chef::Log::Formatter.show_time == true.
      # Otherwise, doesn't print the time.
      def call(severity, time, progname, msg)
        if @@show_time
          sprintf("[%s] %s: %s\n", time.iso8601, severity, msg2str(msg))
        else
          sprintf("%s: %s\n", severity, msg2str(msg))
        end
      end

      # Converts some argument to a Logger.severity() call to a string.  Regular strings pass through like
      # normal, Exceptions get formatted as "message (class)\nbacktrace", and other random stuff gets
      # put through "object.inspect"
      def msg2str(msg)
        case msg
        when ::Hash
          if msg.has_key?(:err)
            format_exception(msg[:err])
          else
            msg[:msg]
          end
        when ::String
          msg
        when ::Exception
          format_exception(msg)
        else
          msg.inspect
        end
      end

      def format_exception(msg)
        "#{msg.message} (#{msg.class})\n" <<
          (msg.backtrace || []).join("\n")
      end
    end
  end
end
