class Logging::Appenders::Console

This class is provides an Appender base class for writing to the standard IO stream - STDOUT and STDERR. This class should not be instantiated directly. The `Stdout` and `Stderr` subclasses should be used.

Public Class Methods

new( name = 'stdout' ) click to toggle source
new( :layout → layout )
new( name = 'stdout', :level → 'info' )

Creates a new Stdout/Stderr Appender. The name 'stdout'/'stderr' will be used unless another is given. Optionally, a layout can be given for the appender to use (otherwise a basic appender will be created) and a log level can be specified.

Options:

:layout => the layout to use when formatting log events
:level  => the level at which to log
Calls superclass method Logging::Appenders::IO.new
# File lib/logging/appenders/console.rb, line 23
def initialize( *args )
  name = self.class.name.split("::").last.downcase
  io   = Object.const_get(name.upcase)

  opts = args.last.is_a?(Hash) ? args.pop : {}
  name = args.shift unless args.empty?

  opts[:encoding] = io.external_encoding if io.respond_to? :external_encoding

  super(name, io, opts)
rescue NameError
  raise RuntimeError, "Please do not use the `Logging::Appenders::Console` class directly - " +
                      "use `Logging::Appenders::Stdout` and `Logging::Appenders::Stderr` instead"
end