Debug::Simple 0.10

Debug::Simple is a Perl module which provides a very simple way to provide debug/verbose/warning messages. It is also trivially controlled via Getopt::Long.<br /><br />The idea is to be able to put a bunch of debugging print statements throughout your code that you can enable or disable.<br /><br />debuglevels(\%OPT)<br /><br /> debuglevels registers the hashref HASH as the place to read values used to control whether text is output to the screen or not. There are 4 values read from this hash: quiet, debug, verbose, and test.<br /><br /> quiet<br /><br /> If non-zero, this will repress all output from Debug::Simple<br /> debug<br /><br /> This indicates the level of debug messages desired. A debug level of 4 prints all the debug messages from levels 1 to 4.<br /> verbose<br /><br /> Like debug, this sets the level of verboseness. A verbose level of 3 prints all verbose messages from 1 to 3.<br /> test<br /><br /> If non-zero, the code passed to test() will be printed to the screen instead of being executed.<br /><br />warning(STRING)<br /><br /> warning prints the STRING to stdout in YELLOW unless the "quiet" level is non-zero (see debuglevels). STRING is prefaced with "Warning:".<br />debug(LEVEL, STRING, [NAME => REF])<br /><br /> debug prints a debugging message to stdout as long as LEVEL is at or below the "debug" level. (see < debuglevels).<br /><br /> The debug message is printed in BOLD. It starts with "Debug: ", then STRING, and then optionally uses Data::Dumper to dump a data structure referred to by REF. NAME is just a human readable name for REF passed to Data::Dumper.<br />verbose(LEVEL, STRING)<br /><br /> verbose prints STRING to stdout as long as LEVEL is at or below the "verbose" level. (see debuglevels).<br />test(CODE)<br /><br /> test executes CODE according to the "test" level. (see debuglevels). If the "test" level is non-zero the code is printed to stdout instead of being executed.<br /><br />SYNOPSIS<br /><br /> use Debug::Simple;<br /><br /> my %opt = (quiet = > 0, debug = > 4, verbose = > 1, test = > 0);<br /> Debug::Simple::debuglevels(\%opt);<br /><br /> warning("This is a warning\m");<br /> debug(1, "This is a level 3 debug message\n");<br /> debug(2, "This is a level 2 debug message with a Dump", NAME => \%opt);<br /> verbose(1, "This is a verbose message\n");<br /> test('print "test code"');

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Debug,  Debug Simple,  Debuglevels,  Debugsimple,  Level,  Message,  Messagequot,  Messages,  Nonzero,  Printed,  Prints,  Quiet,  Quottestquot,  Quotthis,  Screen,  Simple,  Stdout,  String,  Verbose
Users rating:	0/10