Class: Logging::Appenders::StringIo

Inherits:
IO show all
Defined in:
lib/logging/appenders/string_io.rb

Overview

This class provides an Appender that can write to a StringIO instance. This is very useful for testing log message output.

Defined Under Namespace

Modules: IoToS

Constant Summary

Constants included from Buffering

Buffering::DEFAULT_BUFFER_SIZE

Instance Attribute Summary collapse

Attributes inherited from IO

#close_method

Attributes included from Buffering

#auto_flushing, #buffer, #flush_period

Attributes inherited from Logging::Appender

#layout, #level, #name

Instance Method Summary collapse

Methods inherited from IO

#close

Methods included from Buffering

#close, #flush, #immediate_at=

Methods inherited from Logging::Appender

#<<, #append, #close, #closed?, #flush, #inspect

Constructor Details

#initialize(name, opts = {}) ⇒ StringIo

call-seq:

StringIo.new( name, opts = {} )

Creates a new StringIo appender that will append log messages to a StringIO instance.



18
19
20
21
22
23
 
# File 'lib/logging/appenders/string_io.rb', line 18

def initialize( name, opts = {} )
  @sio = StringIO.new
  @sio.extend IoToS
  @pos = 0
  super(name, @sio, opts)
end

Instance Attribute Details

#sio ⇒ Object (readonly)

The StringIO instance the appender is writing to.



10
11
12
 
# File 'lib/logging/appenders/string_io.rb', line 10

def sio
  @sio
end

Instance Method Details

#clear ⇒ Object Also known as: reset

Clears the internal StringIO instance. All log messages are removed from the buffer.



46
47
48
49
50
51
52
 
# File 'lib/logging/appenders/string_io.rb', line 46

def clear
  @mutex.synchronize {
    @pos = 0
    @sio.seek 0
    @sio.truncate 0
  }
end

#reopen ⇒ Object

Reopen the underlying StringIO instance. If the instance is currently closed then it will be opened. If the instance is currently open then it will be closed and immediately opened.



29
30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/logging/appenders/string_io.rb', line 29

def reopen
  @mutex.synchronize {
    if defined? @io and @io
      flush
      @io.close rescue nil
    end
    @io = @sio = StringIO.new
    @sio.extend IoToS
    @pos = 0
  }
  super
  self
end