Class: J1::LogAdapter

Inherits:
Object
  • Object
show all
Defined in:
lib/j1/log_adapter.rb

Constant Summary collapse

LOG_LEVELS =
{
  :debug => ::Logger::DEBUG,
  :info  => ::Logger::INFO,
  :warn  => ::Logger::WARN,
  :error => ::Logger::ERROR,
}.freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(writer, level = :info) ⇒ LogAdapter

Public: Create a new instance of a log writer

writer - Logger compatible instance log_level - (optional, symbol) the log level

Returns nothing




19
20
21
22
23
# File 'lib/j1/log_adapter.rb', line 19

def initialize(writer, level = :info)
  @messages = []
  @writer = writer
  self.log_level = level
end

Instance Attribute Details

#messagesObject (readonly)

Returns the value of attribute messages.



3
4
5
# File 'lib/j1/log_adapter.rb', line 3

def messages
  @messages
end

#writerObject (readonly)

Returns the value of attribute writer.



3
4
5
# File 'lib/j1/log_adapter.rb', line 3

def writer
  @writer
end

Instance Method Details

#abort_with(topic, message = nil) ⇒ Object

Public: Print an error message and immediately abort the process

topic - the topic of the message, e.g. “Configuration file”, “Deprecation”, etc. message - the message detail (can be omitted)

Returns nothing




95
96
97
98
# File 'lib/j1/log_adapter.rb', line 95

def abort_with(topic, message = nil)
  error(topic, message)
  abort
end

#adjust_verbosity(options = {}) ⇒ Object



35
36
37
38
39
40
41
42
43
# File 'lib/j1/log_adapter.rb', line 35

def adjust_verbosity(options = {})
  # Quiet always wins.
  if options[:quiet]
    self.log_level = :error
  elsif options[:verbose]
    self.log_level = :debug
  end
  debug "Logging at level:", LOG_LEVELS.key(writer.level).to_s
end

#debug(topic, message = nil) ⇒ Object

Public: Print a debug message

topic - the topic of the message, e.g. “Configuration file”, “Deprecation”, etc. message - the message detail

Returns nothing




52
53
54
# File 'lib/j1/log_adapter.rb', line 52

def debug(topic, message = nil)
  writer.debug(message(topic, message))
end

#error(topic, message = nil) ⇒ Object

Public: Print an error message

topic - the topic of the message, e.g. “Configuration file”, “Deprecation”, etc. message - the message detail

Returns nothing



84
85
86
# File 'lib/j1/log_adapter.rb', line 84

def error(topic, message = nil)
  writer.error(message(topic, message))
end

#formatted_topic(topic) ⇒ Object

Internal: Format the topic

topic - the topic of the message, e.g. “Configuration file”, “Deprecation”, etc.

Returns the formatted topic statement




119
120
121
# File 'lib/j1/log_adapter.rb', line 119

def formatted_topic(topic)
  "#{topic} ".rjust(20)
end

#info(topic, message = nil) ⇒ Object

Public: Print a message

topic - the topic of the message, e.g. “Configuration file”, “Deprecation”, etc. message - the message detail

Returns nothing




63
64
65
# File 'lib/j1/log_adapter.rb', line 63

def info(topic, message = nil)
  writer.info(message(topic, message))
end

#log_level=(level) ⇒ Object

Public: Set the log level on the writer

level - (symbol) the log level

Returns nothing




31
32
33
# File 'lib/j1/log_adapter.rb', line 31

def log_level=(level)
  writer.level = LOG_LEVELS.fetch(level)
end

#message(topic, message) ⇒ Object

Internal: Build a topic method

topic - the topic of the message, e.g. “Configuration file”, “Deprecation”, etc. message - the message detail

Returns the formatted message




107
108
109
110
111
# File 'lib/j1/log_adapter.rb', line 107

def message(topic, message)
  msg = formatted_topic(topic) + message.to_s.gsub(%r!\s+!, " ")
  messages << msg
  msg
end

#warn(topic, message = nil) ⇒ Object

Public: Print a message

topic - the topic of the message, e.g. “Configuration file”, “Deprecation”, etc. message - the message detail

Returns nothing




74
75
76
# File 'lib/j1/log_adapter.rb', line 74

def warn(topic, message = nil)
  writer.warn(message(topic, message))
end