Class: Logger::Application
Overview
Description
Logger::Application — Add logging support to your application.
Usage
-
Define your application class as a sub-class of this class.
-
Override the
run
method in your class to do many things. -
Instantiate it and invoke #start.
Example
class FooApp < Logger::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
:call-seq: Logger::Application.new(appname = ”).
-
#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
:call-seq:
Logger::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.
770 771 772 773 774 775 |
# File 'lib/logger.rb', line 770 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.
755 756 757 |
# File 'lib/logger.rb', line 755 def appname @appname end |
Instance Method Details
#level=(level) ⇒ Object
Set the logging threshold, just like Logger#level=
.
825 826 827 828 |
# File 'lib/logger.rb', line 825 def level=(level) @level = level @log.level = @level end |
#log(severity, message = nil, &block) ⇒ Object
See Logger#add. This application’s appname
is used.
833 834 835 |
# File 'lib/logger.rb', line 833 def log(severity, = nil, &block) @log.add(severity, , @appname, &block) if @log end |
#log=(logdev) ⇒ Object
818 819 820 |
# File 'lib/logger.rb', line 818 def log=(logdev) set_log(logdev) end |
#logger ⇒ Object
Logger for this application. See the class Logger for an explanation.
794 795 796 |
# File 'lib/logger.rb', line 794 def logger @log end |
#logger=(logger) ⇒ Object
Sets the logger for this application. See the class Logger for an explanation.
802 803 804 805 806 |
# File 'lib/logger.rb', line 802 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.
812 813 814 815 816 |
# File 'lib/logger.rb', line 812 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.
780 781 782 783 784 785 786 787 788 789 790 791 |
# File 'lib/logger.rb', line 780 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 |