Class: SemanticLogger::Appenders

Inherits:
Concurrent::Array
  • Object
show all
Defined in:
lib/semantic_logger/appenders.rb

Overview

Manage a collection of appenders.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(logger = Processor.logger.dup) ⇒ Appenders

Returns a new instance of Appenders.



6
7
8
9
10
 
# File 'lib/semantic_logger/appenders.rb', line 6

def initialize(logger = Processor.logger.dup)
  @logger      = logger
  @logger.name = self.class.name
  super()
end

Instance Attribute Details

#logger ⇒ Object

Returns the value of attribute logger.



4
5
6
 
# File 'lib/semantic_logger/appenders.rb', line 4

def logger
  @logger
end

Instance Method Details

#add(**args, &block) ⇒ Object 



12
13
14
15
16
17
18
19
20
21
22
 
# File 'lib/semantic_logger/appenders.rb', line 12

def add(**args, &block)
  appender = SemanticLogger::Appender.factory(**args, &block)

  if appender.respond_to?(:console_output?) && appender.console_output? && console_output?
    logger.warn "Ignoring attempt to add a second console appender: #{appender.class.name} since it would result in duplicate console output."
    return
  end

  self << appender
  appender
end

#close ⇒ Object 



48
49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/semantic_logger/appenders.rb', line 48

def close
  closed_appenders = []
  each do |appender|
    logger.trace "Closing appender: #{appender.name}"
    appender.flush
    appender.close
    closed_appenders << appender
  rescue Exception => e
    logger.error "Failed to close appender: #{appender.name}", e
  end
  # Delete appenders outside the #each above which prevents changes during iteration.
  closed_appenders.each { |appender| delete(appender) }
  logger.trace "All appenders closed and removed from appender list"
end

#console_output? ⇒ Boolean

Whether any of the existing appenders already output to the console? I.e. Writes to stdout or stderr.

Returns:

  • (Boolean) 


26
27
28
 
# File 'lib/semantic_logger/appenders.rb', line 26

def console_output?
  any? { |appender| appender.respond_to?(:console_output?) && appender.console_output? }
end

#flush ⇒ Object 



38
39
40
41
42
43
44
45
46
 
# File 'lib/semantic_logger/appenders.rb', line 38

def flush
  each do |appender|
    logger.trace "Flushing appender: #{appender.name}"
    appender.flush
  rescue Exception => e
    logger.error "Failed to flush appender: #{appender.name}", e
  end
  logger.trace "All appenders flushed"
end

#log(log) ⇒ Object 



30
31
32
33
34
35
36
 
# File 'lib/semantic_logger/appenders.rb', line 30

def log(log)
  each do |appender|
    appender.log(log) if appender.should_log?(log)
  rescue Exception => e
    logger.error "Failed to log to appender: #{appender.name}", e
  end
end

#reopen ⇒ Object

After a fork reopen each appender.



64
65
66
67
68
69
70
71
72
73
74
 
# File 'lib/semantic_logger/appenders.rb', line 64

def reopen
  each do |appender|
    next unless appender.respond_to?(:reopen)

    logger.trace "Reopening appender: #{appender.name}"
    appender.reopen
  rescue Exception => e
    logger.error "Failed to re-open appender: #{appender.name}", e
  end
  logger.trace "All appenders re-opened"
end