Sha256: 84dace0c3fb1633e32c38df243b209fd004848986f648a3a644f8184b6a98076
Contents?: true
Size: 1.74 KB
Versions: 38
Compression:
Stored size: 1.74 KB
Contents
module Logging::Appenders
# This class provides an Appender that can write to any IO stream
# configured for writing.
#
class IO < ::Logging::Appender
include Buffering
# call-seq:
# IO.new( name, io )
# IO.new( name, io, :layout => layout )
#
# Creates a new IO Appender using the given name that will use the _io_
# stream as the logging destination.
#
def initialize( name, io, opts = {} )
unless io.respond_to? :write
raise TypeError, "expecting an IO object but got '#{io.class.name}'"
end
@io = io
@io.sync = true if @io.respond_to?(:sync) rescue nil
configure_buffering(opts)
super(name, opts)
end
# call-seq:
# close( footer = true )
#
# Close the appender and writes the layout footer to the logging
# destination if the _footer_ flag is set to +true+. Log events will
# no longer be written to the logging destination after the appender
# is closed.
#
def close( *args )
return self if @io.nil?
super
io, @io = @io, nil
io.close unless [STDIN, STDERR, STDOUT].include?(io)
rescue IOError => err
ensure
return self
end
# call-seq:
# flush
#
# Call +flush+ to force an appender to write out any buffered log events.
# Similar to IO#flush, so use in a similar fashion.
#
def flush
return self if @io.nil?
@io.write(buffer.join) unless buffer.empty?
@io.flush
self
rescue StandardError => err
self.level = :off
::Logging.log_internal {"appender #{name.inspect} has been disabled"}
::Logging.log_internal(-2) {err}
ensure
buffer.clear
end
end # class IO
end # module Logging::Appenders
# EOF
Version data entries
38 entries across 38 versions & 6 rubygems