Class: Lumberjack::Formatter
- Inherits:
-
Object
- Object
- Lumberjack::Formatter
- Defined in:
- lib/lumberjack/formatter.rb,
lib/lumberjack/formatter/id_formatter.rb,
lib/lumberjack/formatter/strip_formatter.rb,
lib/lumberjack/formatter/object_formatter.rb,
lib/lumberjack/formatter/string_formatter.rb,
lib/lumberjack/formatter/inspect_formatter.rb,
lib/lumberjack/formatter/truncate_formatter.rb,
lib/lumberjack/formatter/date_time_formatter.rb,
lib/lumberjack/formatter/exception_formatter.rb,
lib/lumberjack/formatter/structured_formatter.rb,
lib/lumberjack/formatter/pretty_print_formatter.rb
Overview
This class controls the conversion of log entry messages into a loggable format. This allows you to log any object you want and have the logging system deal with converting it into a string.
Formats are added to a Formatter by associating them with a class using the add
method. Formats are any object that responds to the call
method.
By default, all object will be converted to strings using their inspect method except for Strings and Exceptions. Strings are not converted and Exceptions are converted using the ExceptionFormatter.
Enumerable objects (including Hash and Array) will call the formatter recursively for each element.
Direct Known Subclasses
Defined Under Namespace
Classes: DateTimeFormatter, ExceptionFormatter, IdFormatter, InspectFormatter, ObjectFormatter, PrettyPrintFormatter, StringFormatter, StripFormatter, StructuredFormatter, TruncateFormatter
Class Method Summary collapse
-
.empty ⇒ Lumberjack::Formatter
Returns a new empty formatter with no mapping.
Instance Method Summary collapse
-
#add(klass, formatter = nil, *args) {|obj| ... } ⇒ self
Add a formatter for a class.
-
#call(severity, timestamp, progname, msg) ⇒ Object
Compatibility with the Logger::Formatter signature.
-
#clear ⇒ self
Remove all formatters including the default formatter.
-
#format(message) ⇒ Object
Format a message object by applying all formatters attached to it.
-
#initialize ⇒ Formatter
constructor
A new instance of Formatter.
-
#remove(klass) ⇒ self
Remove the formatter associated with a class.
Constructor Details
#initialize ⇒ Formatter
Returns a new instance of Formatter.
37 38 39 40 41 42 43 44 45 |
# File 'lib/lumberjack/formatter.rb', line 37 def initialize @class_formatters = {} @module_formatters = {} structured_formatter = StructuredFormatter.new(self) add([String, Numeric, TrueClass, FalseClass], :object) add(Object, InspectFormatter.new) add(Exception, :exception) add(Enumerable, structured_formatter) end |
Class Method Details
.empty ⇒ Lumberjack::Formatter
Returns a new empty formatter with no mapping. For historical reasons, a formatter is initialized with mappings to help output objects as strings. This will return one without the default mappings.
32 33 34 |
# File 'lib/lumberjack/formatter.rb', line 32 def empty new.clear end |
Instance Method Details
#add(klass, formatter = nil, *args) {|obj| ... } ⇒ self
Add a formatter for a class. The formatter can be specified as either an object that responds to the call
method or as a symbol representing one of the predefined formatters, or as a block to the method call.
The predefined formatters are:
- :date_time
- :exception
- :id
- :inspect
- :object
- :pretty_print
- :string
- :strip
- :structured
- :truncate
You can add multiple classes at once by passing an array of classes.
You can also pass class names as strings instead of the classes themselves. This can help avoid loading dependency issues. This applies only to classes; modules cannot be passed in as strings.
93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 |
# File 'lib/lumberjack/formatter.rb', line 93 def add(klass, formatter = nil, *args, &block) formatter ||= block if formatter.nil? remove(klass) else formatter_class_name = nil if formatter.is_a?(Symbol) formatter_class_name = "#{formatter.to_s.gsub(/(^|_)([a-z])/) { |m| $~[2].upcase }}Formatter" elsif formatter.is_a?(String) formatter_class_name = formatter end if formatter_class_name formatter = Formatter.const_get(formatter_class_name) end if formatter.is_a?(Class) formatter = formatter.new(*args) end Array(klass).each do |k| if k.instance_of?(Module) @module_formatters[k] = formatter else k = k.name if k.is_a?(Class) @class_formatters[k] = formatter end end end self end |
#call(severity, timestamp, progname, msg) ⇒ Object
Compatibility with the Logger::Formatter signature. This method will just convert the message object to a string and ignores the other parameters.
175 176 177 |
# File 'lib/lumberjack/formatter.rb', line 175 def call(severity, , progname, msg) "#{format(msg)}#{Lumberjack::LINE_SEPARATOR}" end |
#clear ⇒ self
Remove all formatters including the default formatter. Can be chained to add method calls.
149 150 151 152 153 |
# File 'lib/lumberjack/formatter.rb', line 149 def clear @class_formatters.clear @module_formatters.clear self end |
#format(message) ⇒ Object
Format a message object by applying all formatters attached to it.
159 160 161 162 163 164 165 166 |
# File 'lib/lumberjack/formatter.rb', line 159 def format() formatter = formatter_for(.class) if formatter&.respond_to?(:call) formatter.call() else end end |
#remove(klass) ⇒ self
Remove the formatter associated with a class. Remove statements can be chained together.
You can remove multiple classes at once by passing an array of classes.
You can also pass class names as strings instead of the classes themselves. This can help avoid loading dependency issues. This applies only to classes; modules cannot be passed in as strings.
134 135 136 137 138 139 140 141 142 143 144 |
# File 'lib/lumberjack/formatter.rb', line 134 def remove(klass) Array(klass).each do |k| if k.instance_of?(Module) @module_formatters.delete(k) else k = k.name if k.is_a?(Class) @class_formatters.delete(k) end end self end |