Class: Logger::Application
Overview
Description
Application – Add logging support to your application.
Usage
-
Define your application class as a sub-class of this class.
-
Override ‘run’ method in your class to do many things.
-
Instantiate it and invoke ‘start’.
Example
class FooApp < Application
def initialize(foo_app, application_specific, arguments)
super('FooApp') # Name of the application.
end
def run
...
log(WARN, 'warning', 'my_method1')
...
@log.error('my_method2') { 'Error!' }
...
end
end
status = FooApp.new(....).start
Constant Summary
Constants included from Severity
Severity::DEBUG, Severity::ERROR, Severity::FATAL, Severity::INFO, Severity::UNKNOWN, Severity::WARN
Instance Attribute Summary collapse
-
#appname ⇒ Object
readonly
Name of the application given at initialize.
Instance Method Summary collapse
-
#initialize(appname = nil) ⇒ Application
constructor
Synopsis.
-
#level=(level) ⇒ Object
Set the logging threshold, just like
Logger#level=
. -
#log(severity, message = nil, &block) ⇒ Object
See Logger#add.
- #log=(logdev) ⇒ Object
-
#logger ⇒ Object
Logger for this application.
-
#logger=(logger) ⇒ Object
Sets the logger for this application.
-
#set_log(logdev, shift_age = 0, shift_size = 1024000) ⇒ Object
Sets the log device for this application.
-
#start ⇒ Object
Start the application.
Constructor Details
#initialize(appname = nil) ⇒ Application
Synopsis
Application.new(appname = '')
Args
appname
-
Name of the application.
Description
Create an instance. Log device is STDERR
by default. This can be changed with #set_log.
686 687 688 689 690 691 |
# File 'lib/logger.rb', line 686 def initialize(appname = nil) @appname = appname @log = Logger.new(STDERR) @log.progname = @appname @level = @log.level end |
Instance Attribute Details
#appname ⇒ Object (readonly)
Name of the application given at initialize.
670 671 672 |
# File 'lib/logger.rb', line 670 def appname @appname end |
Instance Method Details
#level=(level) ⇒ Object
Set the logging threshold, just like Logger#level=
.
740 741 742 743 |
# File 'lib/logger.rb', line 740 def level=(level) @level = level @log.level = @level end |
#log(severity, message = nil, &block) ⇒ Object
See Logger#add. This application’s appname
is used.
748 749 750 |
# File 'lib/logger.rb', line 748 def log(severity, = nil, &block) @log.add(severity, , @appname, &block) if @log end |
#log=(logdev) ⇒ Object
733 734 735 |
# File 'lib/logger.rb', line 733 def log=(logdev) set_log(logdev) end |
#logger ⇒ Object
Logger for this application. See the class Logger for an explanation.
710 711 712 |
# File 'lib/logger.rb', line 710 def logger @log end |
#logger=(logger) ⇒ Object
Sets the logger for this application. See the class Logger for an explanation.
717 718 719 720 721 |
# File 'lib/logger.rb', line 717 def logger=(logger) @log = logger @log.progname = @appname @log.level = @level end |
#set_log(logdev, shift_age = 0, shift_size = 1024000) ⇒ Object
Sets the log device for this application. See Logger.new
for an explanation of the arguments.
727 728 729 730 731 |
# File 'lib/logger.rb', line 727 def set_log(logdev, shift_age = 0, shift_size = 1024000) @log = Logger.new(logdev, shift_age, shift_size) @log.progname = @appname @log.level = @level end |
#start ⇒ Object
Start the application. Return the status code.
696 697 698 699 700 701 702 703 704 705 706 707 |
# File 'lib/logger.rb', line 696 def start status = -1 begin log(INFO, "Start of #{ @appname }.") status = run rescue log(FATAL, "Detected an exception. Stopping ... #{$!} (#{$!.class})\n" << $@.join("\n")) ensure log(INFO, "End of #{ @appname }. (status: #{ status.to_s })") end status end |