debuglog

debuglog: zero-conf debug.log file for simple and hassle-free debugging

= SYNOPSIS

Debuglog gives you debug, trace and time methods that write their output to the file ./debug.log.

require 'debuglog'     # or require 'debuglog/auto'

debug "Creating #{n} connections"
trace "names.first", binding
time('Process config file') { Subsystem.configure(ARGV.shift) }

The log file (default ./debug.log) will look something like this:

DebugLog -- 2011-12-28 18:58:22 +1000
-------------------------------------
[00.3] Creating 14 connections
[00.8] names.first == "Sandy White"
[01.9] Process config file: 1.0831 sec

The [00.3] etc. is the number of seconds (rounded) since the program started (well, since require 'debuglog', anyway).

You can use different method names (to avoid a clash) and a different filename with some initial configuration.

require 'debuglog/manual'

DebugLog.configure(
  :debug => :my_debug,
  :trace => :my_trace,
  :time  => :my_time,
  :filename => 'log/xyz.log'
)

my_debug "Creating #{n} connections"
my_trace "names.first", binding
my_time('Process config file') { Subsystem.configure(ARGV.shift) }

= HOMEPAGE

See http://gsinclair.github.com/debuglog.html for full details.

MIT Licence