by Tim P.
(the “Quixotic Starfish” release)
Logging is a flexible logging library for use in Ruby programs based
design of Java’s log4j library. It features a hierarchical logging
custom level names, multiple output destinations per log event, custom
formatting, and more.
This release addresses compatibility issues with Rails, seed
and one or two minor tweaks and bug fixes. See the changes section
the gory details. However, this release is not quite backwards
with the 0.6.* and earlier versions. The reason is the
method. It was reworked to semantically conform to the Ruby Standard
Library’s Logger#add method – this provides the Rails compatibility.
For users of earlier versions of logging, you will need to change any
of the Logging::Logger#add method to use the new
Logging::Logger#add_appenders method (it’s the old “add” method
renamed to “add_appenders”).
sudo gem install logging
== What’s Important
Logging provides a few niceties
- a rolling file appender than can handle multiple processes logging
to the same file
- a nice e-mail appender
- sending log messages to Growl (for those on the Mac platform)
- fine grained control over logging levels for specific classes
1 major enhancement
- Rails compatibility
- renamed Logger#add method to Logger#add_appenders
- renamed Logger#remove method to Logger#remove_appenders
- renamed Logger#clear method to Logger#clear_appenders
- added a new Logger#add method that conforms to the calling
semantics of the Ruby stdlib Logger
2 minor enhancements
- Speed improvements and test coverage
- Created a top-level Logging.init method that is used to
define the default logging levels
1 bug fix
- Tweaked windows detection code
== Fun Fact
A pregnant goldfish is called a “twit”.
== Post Script