Sha256: 1d4124f3ba9b543482b575817152809e8e46e70bd0c2b8ce1284bdd6e6dd3436
Contents?: true
Size: 1.92 KB
Versions: 7
Compression:
Stored size: 1.92 KB
Contents
module Logging::Appenders
# This class provides an Appender that can write to any IO stream
# configured for writing.
#
class IO < ::Logging::Appender
# 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? :print
raise TypeError, "expecting an IO object but got '#{io.class.name}'"
end
@io = io
@io.sync = true if @io.respond_to?('sync') rescue nil
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(*args)
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.flush
self
end
private
# call-seq:
# write( event )
#
# Writes the given _event_ to the IO stream. If an +IOError+ is detected,
# than this appender will be turned off and the error reported.
#
def write( event )
begin
str = event.instance_of?(::Logging::LogEvent) ?
@layout.format(event) : event.to_s
return if str.empty?
@io.print str
rescue IOError
self.level = :off
raise
end
end
end # class IO
end # module Logging::Appenders
# EOF
Version data entries
7 entries across 7 versions & 2 rubygems