NAME

Business::Shipping::KLogging - Simplified wrapper for Log::Log4perl

DESCRIPTION

Wrapper for Log::Log4perl. Must be initialized before use. Recommend usage is via your own wrapper. See Business::Shipping::Logging as an example wrapper.

Provides simple "dubug()", "error()", and etc. routines.

METHODS

debug

debug1

debug2

debug3

For long debug messages (entire XML output, etc.). Prepends "debug3" to the category, allowing the user to filter out very verbose debug messages in config/log4perl.conf.

trace

info

warn

error

fatal

subs()

Gives the name of all the subs that this module has.

init( %opt )

Arguments:

 file         => 'path/to/file',   # Required
 caller_depth => $interger,        # Optional
 once         => true/false        # Optional

caller_depth:

If you are using one wrapper on top of this module, the caller_depth should be set to 2. For example:

 Log::Log4perl
  |
  |
 Business::Shipping::KLogging
  |
  |
 MyNameSpace::Logging

once:

 If true, calls init_once (which ignores any settings if init has already been
 called once).

_log

Private function.

Automatically uses the package name and subroutine as the log4perl 'category'.

uneval( ... )

Takes any built-in object and returns the perl representation of it as a string of text. It was copied from Interchange http://www.icdevgroup.org, written by Mike Heins <mike@perusion.com>.

AUTHOR

Dan Browning <db@kavod.com>, Kavod Technologies, http://www.kavod.com.

COPYRIGHT AND LICENCE

Copyright (c) 2003-2004 Kavod Technologies, Dan Browning. All rights reserved. This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself. See LICENSE for more info.

Sub uneval copyright (c) 2002-2003 Interchange Development Group.