Class: Webgen::Logger

Inherits:
Object
  • Object
show all
Defined in:
lib/webgen/logger.rb

Overview

The class used by a Website to do the logging and the normal output.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(outdev = $stdout, sync = false) ⇒ Logger

Create a new Logger object which uses outdev as output device. If sync is set to true, log messages are interspersed with normal output.



17
18
19
20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/webgen/logger.rb', line 17

def initialize(outdev=$stdout, sync=false)
  @sync = sync
  @outdev = outdev
  @logger = (@sync ? ::Logger.new(@outdev) : ::Logger.new(@logio = StringIO.new))
  @logger.formatter = Proc.new do |severity, timestamp, progname, msg|
    if self.level == ::Logger::DEBUG
      "%5s -- %s: %s\n" % [severity, progname, msg ]
    else
      "%5s -- %s\n" % [severity, msg]
    end
  end
  self.level = ::Logger::WARN
  self.verbosity = :normal
end

Instance Attribute Details

#sync ⇒ Object (readonly)

Specifies whether log output should be synchronous with normal output.



10
11
12
 
# File 'lib/webgen/logger.rb', line 10

def sync
  @sync
end

#verbosity ⇒ Object

Normal output verbosity (:normal, :verbose, :quiet).



13
14
15
 
# File 'lib/webgen/logger.rb', line 13

def verbosity
  @verbosity
end

Instance Method Details

#debug(source = '', &block) ⇒ Object

Utiltity method for logging a debug message.



68
 
# File 'lib/webgen/logger.rb', line 68

def debug(source='', &block); log(:debug, source, &block); end

#error(source = '', &block) ⇒ Object

Utiltity method for logging an error message.



59
 
# File 'lib/webgen/logger.rb', line 59

def error(source='', &block); log(:error, source, &block); end

#info(source = '', &block) ⇒ Object

Utiltity method for logging an informational message.



65
 
# File 'lib/webgen/logger.rb', line 65

def info(source='', &block); log(:info, source, &block); end

#level ⇒ Object

The severity threshold level.



38
39
40
 
# File 'lib/webgen/logger.rb', line 38

def level
  @logger.level
end

#level=(value) ⇒ Object

Set the severity threshold to value which can be one of the stdlib Logger severity levels.



43
44
45
 
# File 'lib/webgen/logger.rb', line 43

def level=(value)
  @logger.level = value
end

#log(sev_level, source = '', &block) ⇒ Object

Log a message of sev_level from source. The mandatory block has to return the message.



48
49
50
51
52
53
54
55
56
 
# File 'lib/webgen/logger.rb', line 48

def log(sev_level, source='', &block)
  if sev_level == :stdout
    @outdev.write(block.call + "\n") if @verbosity == :normal || @verbosity == :verbose
  elsif sev_level == :verbose
    @outdev.write(block.call + "\n") if @verbosity == :verbose
  else
    @logger.send(sev_level, source, &block)
  end
end

#log_output ⇒ Object

Returns the output of the logger when #sync is false. Otherwise an empty string is returned.



33
34
35
 
# File 'lib/webgen/logger.rb', line 33

def log_output
  @sync ? '' : @logio.string
end

#stdout(source = '', &block) ⇒ Object

Utiltity method for writing a normal output message.



71
 
# File 'lib/webgen/logger.rb', line 71

def stdout(source='', &block); log(:stdout, source, &block); end

#verbose(source = '', &block) ⇒ Object

Utiltity method for writing a verbose output message.



74
 
# File 'lib/webgen/logger.rb', line 74

def verbose(source='', &block); log(:verbose, source, &block); end

#warn(source = '', &block) ⇒ Object

Utiltity method for logging a warning message.



62
 
# File 'lib/webgen/logger.rb', line 62

def warn(source='', &block); log(:warn, source, &block); end