logging 1.8.2 → 2.0.0

data/lib/rspec/logging_helper.rb

@@ -7,9 +7,9 @@ module RSpec
     # supports a readline method to access the log messages.
     #
     def capture_log_messages( opts = {} )
-      from = opts.getopt(:from, 'root')
-      to = opts.getopt(:to, '__rspec__')
-      exclusive = opts.getopt(:exclusive, true)
+      from = opts.fetch(:from, 'root')
+      to = opts.fetch(:to, '__rspec__')
+      exclusive = opts.fetch(:exclusive, true)
 
       appender = Logging::Appenders[to] || Logging::Appenders::StringIo.new(to)
       logger = Logging::Logger[from]

data/logging.gemspec

@@ -0,0 +1,46 @@
+# -*- encoding: utf-8 -*-
+# stub: logging 2.0.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "logging"
+  s.version = "2.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib"]
+  s.authors = ["Tim Pease"]
+  s.date = "2015-03-29"
+  s.description = "Logging is a flexible logging library for use in Ruby programs based on the\ndesign of Java's log4j library. It features a hierarchical logging system,\ncustom level names, multiple output destinations per log event, custom\nformatting, and more."
+  s.email = "tim.pease@gmail.com"
+  s.extra_rdoc_files = ["History.txt"]
+  s.files = [".gitignore", ".travis.yml", "History.txt", "README.md", "Rakefile", "examples/appenders.rb", "examples/classes.rb", "examples/colorization.rb", "examples/custom_log_levels.rb", "examples/fork.rb", "examples/formatting.rb", "examples/hierarchies.rb", "examples/layouts.rb", "examples/lazy.rb", "examples/loggers.rb", "examples/mdc.rb", "examples/names.rb", "examples/rspec_integration.rb", "examples/simple.rb", "lib/logging.rb", "lib/logging/appender.rb", "lib/logging/appenders.rb", "lib/logging/appenders/buffering.rb", "lib/logging/appenders/console.rb", "lib/logging/appenders/file.rb", "lib/logging/appenders/io.rb", "lib/logging/appenders/rolling_file.rb", "lib/logging/appenders/string_io.rb", "lib/logging/appenders/syslog.rb", "lib/logging/color_scheme.rb", "lib/logging/diagnostic_context.rb", "lib/logging/filter.rb", "lib/logging/filters.rb", "lib/logging/filters/level.rb", "lib/logging/layout.rb", "lib/logging/layouts.rb", "lib/logging/layouts/basic.rb", "lib/logging/layouts/parseable.rb", "lib/logging/layouts/pattern.rb", "lib/logging/log_event.rb", "lib/logging/logger.rb", "lib/logging/proxy.rb", "lib/logging/rails_compat.rb", "lib/logging/repository.rb", "lib/logging/root_logger.rb", "lib/logging/utils.rb", "lib/logging/version.rb", "lib/rspec/logging_helper.rb", "lib/spec/logging_helper.rb", "logging.gemspec", "script/bootstrap", "test/appenders/test_buffered_io.rb", "test/appenders/test_console.rb", "test/appenders/test_file.rb", "test/appenders/test_io.rb", "test/appenders/test_periodic_flushing.rb", "test/appenders/test_rolling_file.rb", "test/appenders/test_string_io.rb", "test/appenders/test_syslog.rb", "test/benchmark.rb", "test/layouts/test_basic.rb", "test/layouts/test_color_pattern.rb", "test/layouts/test_json.rb", "test/layouts/test_pattern.rb", "test/layouts/test_yaml.rb", "test/setup.rb", "test/test_appender.rb", "test/test_color_scheme.rb", "test/test_filter.rb", "test/test_layout.rb", "test/test_log_event.rb", "test/test_logger.rb", "test/test_logging.rb", "test/test_mapped_diagnostic_context.rb", "test/test_nested_diagnostic_context.rb", "test/test_proxy.rb", "test/test_repository.rb", "test/test_root_logger.rb", "test/test_utils.rb"]
+  s.homepage = "http://rubygems.org/gems/logging"
+  s.rdoc_options = ["--main", "README.md"]
+  s.rubyforge_project = "logging"
+  s.rubygems_version = "2.2.2"
+  s.summary = "A flexible and extendable logging library for Ruby"
+  s.test_files = ["test/appenders/test_buffered_io.rb", "test/appenders/test_console.rb", "test/appenders/test_file.rb", "test/appenders/test_io.rb", "test/appenders/test_periodic_flushing.rb", "test/appenders/test_rolling_file.rb", "test/appenders/test_string_io.rb", "test/appenders/test_syslog.rb", "test/layouts/test_basic.rb", "test/layouts/test_color_pattern.rb", "test/layouts/test_json.rb", "test/layouts/test_pattern.rb", "test/layouts/test_yaml.rb", "test/test_appender.rb", "test/test_color_scheme.rb", "test/test_filter.rb", "test/test_layout.rb", "test/test_log_event.rb", "test/test_logger.rb", "test/test_logging.rb", "test/test_mapped_diagnostic_context.rb", "test/test_nested_diagnostic_context.rb", "test/test_proxy.rb", "test/test_repository.rb", "test/test_root_logger.rb", "test/test_utils.rb"]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<little-plugger>, ["~> 1.1"])
+      s.add_runtime_dependency(%q<multi_json>, ["~> 1.10"])
+      s.add_development_dependency(%q<flexmock>, ["~> 1.0"])
+      s.add_development_dependency(%q<bones-git>, ["~> 1.3"])
+      s.add_development_dependency(%q<bones>, [">= 3.8.3"])
+    else
+      s.add_dependency(%q<little-plugger>, ["~> 1.1"])
+      s.add_dependency(%q<multi_json>, ["~> 1.10"])
+      s.add_dependency(%q<flexmock>, ["~> 1.0"])
+      s.add_dependency(%q<bones-git>, ["~> 1.3"])
+      s.add_dependency(%q<bones>, [">= 3.8.3"])
+    end
+  else
+    s.add_dependency(%q<little-plugger>, ["~> 1.1"])
+    s.add_dependency(%q<multi_json>, ["~> 1.10"])
+    s.add_dependency(%q<flexmock>, ["~> 1.0"])
+    s.add_dependency(%q<bones-git>, ["~> 1.3"])
+    s.add_dependency(%q<bones>, [">= 3.8.3"])
+  end
+end

data/test/appenders/test_buffered_io.rb

@@ -41,6 +41,26 @@ module TestAppenders
       assert_raise(RuntimeError) {@appender.append event}
     end
 
+    def test_append_with_write_size
+      event = Logging::LogEvent.new('TestLogger', @levels['warn'], %w[a b c d], false)
+      @appender.write_size = 2
+
+      @appender.append event
+      assert_nil(readline)
+
+      @appender.append event
+      assert_nil(readline)
+
+      event.level = @levels['debug']
+      event.data = 'the big log message'
+      @appender.append event
+
+      assert_equal " WARN  TestLogger : <Array> #{%w[a b c d]}\n", readline
+      assert_equal " WARN  TestLogger : <Array> #{%w[a b c d]}\n", readline
+      assert_equal "DEBUG  TestLogger : the big log message\n", readline
+      assert_nil(readline)
+    end
+
     def test_append_error
       # setup an internal logger to capture error messages from the IO
       # appender
@@ -147,6 +167,15 @@ module TestAppenders
       assert_nil(readline)
     end
 
+    def test_clear
+      @appender << "this is a test message\n"
+      @appender << "this is another test message\n"
+
+      @appender.clear!
+      @appender.flush
+      assert_nil(readline)
+    end
+
     def test_immediate_at
       event = Logging::LogEvent.new('TestLogger', @levels['warn'],
                                     [1, 2, 3, 4], false)

data/test/appenders/test_file.rb

@@ -42,7 +42,7 @@ module TestAppenders
 
     def test_initialize
       log = File.join(TMP, 'file.log')
-      appender = Logging.appenders.file(NAME, 'filename' => log)
+      appender = Logging.appenders.file(NAME, :filename => log)
       assert_equal 'logfile', appender.name
       assert_equal ::File.expand_path(log), appender.filename
       appender << "This will be the first line\n"
@@ -82,7 +82,7 @@ module TestAppenders
 
     def test_changing_directories
       log = File.join(TMP, 'file.log')
-      appender = Logging.appenders.file(NAME, 'filename' => log)
+      appender = Logging.appenders.file(NAME, :filename => log)
 
       assert_equal 'logfile', appender.name
       assert_equal ::File.expand_path(log), appender.filename

data/test/appenders/test_rolling_file.rb

@@ -111,7 +111,7 @@ module TestAppenders
       Dir.glob(d_glob).each {|fn| ::File.delete fn}
       cleanup
 
-      ap = Logging.appenders.rolling_file(NAME, :filename => @fn, 'age' => 'daily')
+      ap = Logging.appenders.rolling_file(NAME, :filename => @fn, :age => 'daily')
       ap << "random message\n"
       assert_equal 1, Dir.glob(@glob).length
 
@@ -242,6 +242,67 @@ module TestAppenders
       cleanup
     end
 
+    def test_custom_numberd_filename
+      fn = File.expand_path('test.log{{.%d}}', TMP)
+      filename = File.expand_path('test.log', TMP)
+      glob = File.expand_path('test.log.*', TMP)
+
+      assert_equal [], Dir.glob(glob)
+      ap = Logging.appenders.rolling_file(NAME, :filename => fn, :size => 100, :keep => 2)
+
+      ap << 'X' * 100; ap.flush
+      assert_equal 0, Dir.glob(glob).length
+      assert_equal 100, File.size(filename)
+
+      # this character is appended to the log file (bringing its size to 101)
+      # and THEN the file is rolled resulting in a new, empty log file
+      ap << 'X'
+      assert_equal 1, Dir.glob(glob).length
+      assert_equal 0, File.size(filename)
+
+      ap << 'Y' * 100; ap.flush
+      assert_equal 1, Dir.glob(glob).length
+      assert_equal 100, File.size(filename)
+
+      ap << 'Y'
+      assert_equal 2, Dir.glob(glob).length
+      assert_equal 0, File.size(filename)
+
+      # now make sure we prune the correct file
+      ap << 'Z' * 101; ap.flush
+      files = Dir.glob(glob).sort
+      assert_equal 2, files.length
+      assert_equal 'Z'*101, ::File.read(files.first)
+      assert_equal 'Y'*101, ::File.read(files.last)
+
+      cleanup
+    end
+
+    def test_custom_timestamp_filename
+      fn = File.expand_path('test{{.%S:%M}}.log', TMP)
+      filename = File.expand_path('test.log', TMP)
+      age_file = filename + '.age'
+      glob = File.expand_path('test.*.log', TMP)
+
+      assert_equal [], Dir.glob(glob)
+      ap = Logging.appenders.rolling_file(NAME, :filename => fn, :age => 1, :keep => 2)
+
+      ap << "random message\n"
+      assert_equal 0, Dir.glob(glob).length
+
+      now = ::File.mtime(age_file)
+      start = now - 42
+      ::File.utime(start, start, age_file)
+      ap.instance_variable_set(:@age_fn_mtime, nil)
+      ap << "another random message\n"
+
+      files = Dir.glob(glob)
+      assert_equal 1, files.length
+      assert_match %r/test\.\d{2}:\d{2}\.log\z/, files.first
+
+      cleanup
+    end
+
   private
     def cleanup
       unless Logging.appenders[NAME].nil?

data/test/layouts/test_color_pattern.rb

@@ -77,7 +77,7 @@ module TestLayouts
       event = Logging::LogEvent.new('ArrayLogger', @levels['info'], 'log message', false)
 
       rgxp = Regexp.new(
-        '^\['+Regexp.escape(CS::BLUE)+'\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}'+Regexp.escape(CS::RESET)+
+        '^\['+Regexp.escape(CS::BLUE)+'\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}'+Regexp.escape(CS::RESET)+
         '\] INFO  -- '+Regexp.escape(CS::GREEN)+'ArrayLogger'+Regexp.escape(CS::RESET)+
         ' : '+Regexp.escape(CS::MAGENTA)+'log message'+Regexp.escape(CS::RESET)
       )

data/test/layouts/test_json.rb

@@ -98,6 +98,9 @@ module TestLayouts
       @layout.items = %w[method]
       assert_equal %Q[{"method":"method_name"}\n], @layout.format(event)
 
+      @layout.items = %w[hostname]
+      assert_equal %Q[{"hostname":"#{Socket.gethostname}"}\n], @layout.format(event)
+
       @layout.items = %w[pid]
       assert_match %r/\A\{"pid":\d+\}\n\z/, @layout.format(event)
 

data/test/layouts/test_pattern.rb

@@ -11,7 +11,7 @@ module TestLayouts
       super
       @layout = Logging.layouts.pattern({})
       @levels = Logging::LEVELS
-      @date_fmt = '\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}'
+      @date_fmt = '\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}'
       Thread.current[:name] = nil
     end
 
@@ -42,7 +42,7 @@ module TestLayouts
     end
 
     def test_date_pattern
-      assert_equal '%Y-%m-%d %H:%M:%S', @layout.date_pattern
+      assert_equal '%Y-%m-%dT%H:%M:%S', @layout.date_pattern
     end
 
     def test_date_pattern_eq
@@ -142,6 +142,10 @@ module TestLayouts
       Thread.current[:name] = "Main"
       assert_equal "Main", @layout.format(event)
 
+      @layout.pattern = '%h'
+      hostname = Socket.gethostname
+      assert_equal hostname, @layout.format(event)
+
       @layout.pattern = '%%'
       assert_equal '%', @layout.format(event)
 

data/test/layouts/test_yaml.rb

@@ -1,4 +1,4 @@
-
+require 'time'
 require File.expand_path('../setup', File.dirname(__FILE__))
 
 module TestLogging
@@ -88,6 +88,9 @@ module TestLayouts
       @layout.items = %w[method]
       assert_match %r/\A--- ?\nmethod: method_name\n/, @layout.format(event)
 
+      @layout.items = %w[hostname]
+      assert_match %r/\A--- ?\nhostname: #{Socket.gethostname}\n/, @layout.format(event)
+
       @layout.items = %w[pid]
       assert_match %r/\A--- ?\npid: \d+\n\z/, @layout.format(event)
 

data/test/test_appender.rb

@@ -40,6 +40,54 @@ module TestLogging
       assert_raise(RuntimeError) {@appender.append @event}
     end
 
+    def test_append_with_filter
+      ary = []
+      @appender.instance_variable_set :@ary, ary
+      def @appender.write(event)
+        @ary << event
+      end
+      @appender.level = :debug
+
+      # Excluded
+      @appender.filters = ::Logging::Filters::Level.new :info
+      @appender.append @event
+      assert_nil ary.pop
+
+      # Allowed
+      @appender.filters = ::Logging::Filters::Level.new :debug
+      @appender.append @event
+      assert_equal @event, ary.pop
+
+      # No filter
+      @appender.filters = nil
+      @appender.append @event
+      assert_equal @event, ary.pop
+    end
+
+    def test_append_with_modifying_filter
+      ary = []
+      @appender.instance_variable_set :@ary, ary
+      def @appender.write(event)
+        @ary << event
+      end
+      @appender.level = :debug
+      @appender.filters = [
+        ::Logging::Filters::Level.new(:debug, :info),
+        RedactFilter.new
+      ]
+
+      # data will be redacted
+      @appender.append @event
+      event = ary.pop
+      assert_not_same @event, event
+      assert_equal "REDACTED!", event.data
+
+      # event will be filtered out
+      @event.level = @levels['warn']
+      @appender.append @event
+      assert_nil ary.pop
+    end
+
     def test_close
       assert_equal false, @appender.closed?
 
@@ -149,3 +197,11 @@ module TestLogging
   end  # class TestAppender
 end  # module TestLogging
 
+class RedactFilter < ::Logging::Filter
+  def allow( event )
+    event = event.dup
+    event.data = "REDACTED!"
+    event
+  end
+end
+

data/test/test_filter.rb

@@ -0,0 +1,33 @@
+require File.expand_path('setup', File.dirname(__FILE__))
+
+module TestLogging
+
+  class TestFilter < Test::Unit::TestCase
+    include LoggingTestCase
+
+    def setup
+      super
+
+      ::Logging::init
+      @lf = ::Logging::Filters::Level.new :debug, :warn
+    end
+
+    def test_level_filter_includes_selected_level
+      debug_evt = event_for_level(:debug)
+      warn_evt = event_for_level(:warn)
+      assert_same debug_evt, @lf.allow(debug_evt), "Debug messages should be allowed"
+      assert_same warn_evt, @lf.allow(warn_evt), "Warn messages should be allowed"
+    end
+
+    def test_level_filter_excludes_unselected_level
+      event = event_for_level(:info)
+      assert_nil @lf.allow(event), "Info messages should be disallowed"
+    end
+
+    def event_for_level(level)
+      ::Logging::LogEvent.new('logger', ::Logging::LEVELS[level.to_s],
+                              'message', false)
+    end
+
+  end
+end

data/test/test_layout.rb

@@ -20,16 +20,16 @@ module TestLogging
 
       assert_equal :string, obj_format[@layout]
 
-      @layout = ::Logging::Layout.new 'format_as' => 'blah'
+      @layout = ::Logging::Layout.new :format_as => 'blah'
       assert_equal :string, obj_format[@layout]
 
       @layout = ::Logging::Layout.new :format_as => :inspect
       assert_equal :inspect, obj_format[@layout]
 
-      @layout = ::Logging::Layout.new 'format_as' => :json
+      @layout = ::Logging::Layout.new :format_as => :json
       assert_equal :json, obj_format[@layout]
 
-      @layout = ::Logging::Layout.new 'format_as' => :yaml
+      @layout = ::Logging::Layout.new :format_as => :yaml
       assert_equal :yaml, obj_format[@layout]
 
       @layout = ::Logging::Layout.new
@@ -85,11 +85,7 @@ module TestLogging
       assert_match %r/\A<Array> \n--- ?\n- one\n- two\n- three\n- four\n/, r
 
       r = @layout.format_obj Class
-      if defined? YAML::ENGINE and YAML::ENGINE.yamler == 'psych'
-        assert_equal "<Class> \n--- !ruby/class 'Class'\n", r
-      else
-        assert_equal "<Class> Class", r
-      end
+      assert_match %r/\A<Class> (\n--- !ruby\/class ')?Class('\n)?/, r
     end
 
     def test_format_obj_without_backtrace

data/test/test_log_event.rb

@@ -29,7 +29,7 @@ module TestLogging
     def test_file
       assert_equal '', @event.file
 
-      @logger.trace = true
+      @logger.caller_tracing = true
       @logger.warn 'warning message'
       assert_match %r/test_log_event.rb\z/, @appender.event.file
     end
@@ -46,7 +46,7 @@ module TestLogging
     def test_line
       assert_equal '', @event.file
 
-      @logger.trace = true
+      @logger.caller_tracing = true
       @logger.error 'error message'
       assert_equal __LINE__-1, @appender.event.line
     end
@@ -63,7 +63,7 @@ module TestLogging
     def test_method
       assert_equal '', @event.file
 
-      @logger.trace = true
+      @logger.caller_tracing = true
       @logger.debug 'debug message'
       assert_equal 'test_method', @appender.event.method
     end

data/test/test_logger.rb

@@ -406,6 +406,33 @@ module TestLogging
       assert_equal true,  logb.info?
     end
 
+    def test_level_with_filter
+      root = ::Logging::Logger[:root]
+      root.level = 'debug'
+
+      details_filter = ::Logging::Filters::Level.new :debug
+      error_filter = ::Logging::Filters::Level.new :error
+
+      a_detail = ::Logging::Appenders::StringIo.new 'detail', :filters => details_filter
+      a_error = ::Logging::Appenders::StringIo.new 'error', :filters => error_filter
+
+      root.add_appenders a_detail, a_error
+
+      log = ::Logging::Logger.new 'A Logger'
+
+      log.debug "debug level"
+      assert_equal "DEBUG  A Logger : debug level\n", a_detail.readline
+      assert_nil a_error.readline
+
+      log.error "error level"
+      assert_nil a_detail.readline
+      assert_equal "ERROR  A Logger : error level\n", a_error.readline
+
+      log.warn "warn level"
+      assert_nil a_detail.readline
+      assert_nil a_error.readline
+    end
+
     def test_log
       root = ::Logging::Logger[:root]
       root.level = 'info'
@@ -598,40 +625,40 @@ module TestLogging
       assert_raise(ArgumentError) {::Logging::Logger[:root] <=> 'string'}
     end
 
-    def test_trace
+    def test_caller_tracing
       log = ::Logging::Logger[:root]
-      assert_equal false, log.trace
+      assert_equal false, log.caller_tracing
 
-      log.trace = true
-      assert_equal true, log.trace
+      log.caller_tracing = true
+      assert_equal true, log.caller_tracing
 
       log = ::Logging::Logger['A']
-      assert_equal false, log.trace
+      assert_equal false, log.caller_tracing
 
-      log.trace = true
-      assert_equal true, log.trace
+      log.caller_tracing = true
+      assert_equal true, log.caller_tracing
     end
 
-    def test_trace_eq
+    def test_caller_trace_eq
       log = ::Logging::Logger.new 'A'
-      assert_equal false, log.trace
+      assert_equal false, log.caller_tracing
 
-      log.trace = true
-      assert_equal true, log.trace
+      log.caller_tracing = true
+      assert_equal true, log.caller_tracing
 
-      log.trace = false
-      assert_equal false, log.trace
+      log.caller_tracing = false
+      assert_equal false, log.caller_tracing
 
-      log.trace = 'true'
-      assert_equal true, log.trace
+      log.caller_tracing = 'true'
+      assert_equal true, log.caller_tracing
 
-      log.trace = 'false'
-      assert_equal false, log.trace
+      log.caller_tracing = 'false'
+      assert_equal false, log.caller_tracing
 
-      log.trace = nil
-      assert_equal false, log.trace
+      log.caller_tracing = nil
+      assert_equal false, log.caller_tracing
 
-      assert_raise(ArgumentError) {log.trace = Object}
+      assert_raise(ArgumentError) {log.caller_tracing = Object}
     end
 
     def test_dump_configuration
@@ -640,57 +667,54 @@ module TestLogging
       log_c = ::Logging::Logger['A-logger::B-logger::C-logger']
       log_d = ::Logging::Logger['A-logger::D-logger']
 
-      sio = StringIO.new
-      sio.extend ::Logging::Appenders::StringIo::IoToS
-
-      log_a._dump_configuration( sio )
-      assert_equal(
-        "A-logger  ........................................   debug  +A  -T\n", sio.to_s)
+      assert_equal \
+        "A-logger  ........................................   debug  +A  -T\n",
+        log_a._dump_configuration
 
-      log_b._dump_configuration( sio )
-      assert_equal(
-        "A-logger::B-logger  ..............................   debug  +A  -T\n", sio.to_s)
+      assert_equal \
+        "A-logger::B-logger  ..............................   debug  +A  -T\n",
+        log_b._dump_configuration
 
-      log_c._dump_configuration( sio )
-      assert_equal(
-        "A-logger::B-logger::C-logger  ....................   debug  +A  -T\n", sio.to_s)
+      assert_equal \
+        "A-logger::B-logger::C-logger  ....................   debug  +A  -T\n",
+        log_c._dump_configuration
 
-      log_d._dump_configuration( sio )
-      assert_equal(
-        "A-logger::D-logger  ..............................   debug  +A  -T\n", sio.to_s)
+      assert_equal \
+        "A-logger::D-logger  ..............................   debug  +A  -T\n",
+        log_d._dump_configuration
 
       log_b.level = :warn
-      log_b.trace = true
-      log_b._dump_configuration( sio )
-      assert_equal(
-        "A-logger::B-logger  ..............................   *warn  +A  +T\n", sio.to_s)
+      log_b.caller_tracing = true
+      assert_equal \
+        "A-logger::B-logger  ..............................   *warn  +A  +T\n",
+        log_b._dump_configuration
 
       log_c.additive = false
-      log_c._dump_configuration( sio )
-      assert_equal(
-        "A-logger::B-logger::C-logger  ....................    warn  -A  -T\n", sio.to_s)
+      assert_equal \
+        "A-logger::B-logger::C-logger  ....................    warn  -A  -T\n",
+        log_c._dump_configuration
 
       # with an indent specified
-      log_a._dump_configuration( sio, 4 )
-      assert_equal(
-        "    A-logger  ....................................   debug  +A  -T\n", sio.to_s)
+      assert_equal \
+        "    A-logger  ....................................   debug  +A  -T\n",
+        log_a._dump_configuration(4)
 
-      log_b._dump_configuration( sio, 8 )
-      assert_equal(
-        "        A-logger::B-logger  ......................   *warn  +A  +T\n", sio.to_s)
+      assert_equal \
+        "        A-logger::B-logger  ......................   *warn  +A  +T\n",
+        log_b._dump_configuration(8)
 
-      log_c._dump_configuration( sio, 10 )
-      assert_equal(
-        "          A-logger::B-logger::C-logger  ..........    warn  -A  -T\n", sio.to_s)
+      assert_equal \
+        "          A-logger::B-logger::C-logger  ..........    warn  -A  -T\n",
+        log_c._dump_configuration(10)
 
-      log_d._dump_configuration( sio, 22 )
-      assert_equal(
-        "                      A-logger::D-logger  ........   debug  +A  -T\n", sio.to_s)
+      assert_equal \
+        "                      A-logger::D-logger  ........   debug  +A  -T\n",
+        log_d._dump_configuration(22)
 
       log_c.level = 0
-      log_c._dump_configuration( sio, 26 )
-      assert_equal(
-        "                          A-logger::B...::C-logger  *debug  -A  -T\n", sio.to_s)
+      assert_equal \
+        "                          A-logger::B...::C-logger  *debug  -A  -T\n",
+        log_c._dump_configuration(26)
     end
 
   end  # class TestLogger