Asp Forum - [ANN] logging (version 1.0.0

Tim Pease

4/18/2009 5:07:00 AM

Logging version 1.0.0
by Tim Pease
http://logging.ruby...

== DESCRIPTION

Logging is a flexible logging library for use in Ruby programs based
on the
design of Java's log4j library. It features a hierarchical logging
system,
custom level names, multiple output destinations per log event, custom
formatting, and more.

== CHANGES

2 major enhancements
- Refactored access to the appenders
- Created a much cleaner way to initialize the logging framework
3 minor enhancements
- Added a YAML layout option
- Added a JSON layout option
- Cration of an "examples" directory
1 bug fix
- Logging initialization happens implicitly when a logger, layout, or
appender is created

== NOTES

There are two new layouts for outputting logs as using parseable
formats --
JSON and YAML. This is very nice when you want to sift through very
large log
files looking for specific messages or sequences of messages. No more
messy
regular expressions. Just use a JSON parser or a YAML parser to ingest
the log
messages.

There are quite a few examples of how to use the logging framework in
the
"examples" directory. Please take a look at the source package to get
some
ideas and inspiration.

The examples also show the favored way for configuring the logging
framework.
Please take a look.

This release will introdcue backwards incompatabilities with regard to
accessing the STDOUT and STDERR appenders. The two lines below show
the old way
and the new way:

Logging::Appender.stdout # old way that no longer works
Logging.appenders.stdout # new way (similar for stderr)

== THANKS

Ara T. Howard gave a great talk about boulder.rb the other night.
Inspiration
from that meeting was the germ of this update.

Blessings,
TwP

2 Answers

Aaron Turner

4/18/2009 3:52:00 PM

On Fri, Apr 17, 2009 at 10:07 PM, Tim Pease <tim.pease@gmail.com> wrote:
> Logging version 1.0.0
> =A0 =A0by Tim Pease
> =A0 =A0http://logging.ruby...
>
> =3D=3D DESCRIPTION
>
> Logging is a flexible logging library for use in Ruby programs based on t=
he
> design of Java's log4j library. It features a hierarchical logging system=
,
> custom level names, multiple output destinations per log event, custom
> formatting, and more.

Hey Tim,
How does logging compare to log4r?

--=20
Aaron Turner
http://s...
http://tcpreplay.s... - Pcap editing and replay tools for Unix & Win=
dows
Those who would give up essential Liberty, to purchase a little temporary
Safety, deserve neither Liberty nor Safety.
-- Benjamin Franklin

Tim Pease

4/18/2009 5:43:00 PM

On Sat, Apr 18, 2009 at 9:52 AM, Aaron Turner <synfinatic@gmail.com> wrote:
> On Fri, Apr 17, 2009 at 10:07 PM, Tim Pease <tim.pease@gmail.com> wrote:
>> Logging version 1.0.0
>> =A0 =A0by Tim Pease
>> =A0 =A0http://logging.ruby...
>>
>> =3D=3D DESCRIPTION
>>
>> Logging is a flexible logging library for use in Ruby programs based on =
the
>> design of Java's log4j library. It features a hierarchical logging syste=
m,
>> custom level names, multiple output destinations per log event, custom
>> formatting, and more.
>
> Hey Tim,
> How does logging compare to log4r?
>

Let's find out

'logging' <=3D> 'log4r' #=3D> 1

Logging supports all the same features of log4r and some improvements
and nifty new things, too. The rolling log file appender in Logging is
safe to use from multiple processes; this is not the case with log4r's
rolling file outputter.

Logging supports parseable log formats -- messages can be output as
JSON or YAML formatted objects. This makes parsing your log files much
much easier.

Logging has a growl notification appender for those of you on Mac OS X.

Both support logger hierarchies.

Logging has a cleaner interface (in my opinion).

Check out the examples folder of the logging project to get a feel of
how to use it and what it is capable of.

http://github.com/TwP/logging/t...

Blessings,
TwP

comp.lang.ruby

[ANN] logging (version 1.0.0

Tim Pease

Aaron Turner

Tim Pease

x Login to ForumsZone