NAME

LWP::ConsoleLogger::Easy - Easy LWP tracing and debugging

VERSION

version 0.000016

SYNOPSIS

use LWP::ConsoleLogger::Easy qw( debug_ua );
use WWW::Mechanize;

my $mech = WWW::Mechanize->new;
my $logger = debug_ua( $mech );
$mech->get(...);

# now watch the console for debugging output

# ...
# stop dumping headers
$logger->dump_headers( 0 );

my $quiet_logger = debug_ua( $mech, 1 );

my $noisy_logger = debug_ua( $mech, 5 );

DESCRIPTION

This module gives you the easiest possible introduction to LWP::ConsoleLogger. It offers one wrappers around LWP::ConsoleLogger: debug_ua. This function allows you to get up and running quickly with just a couple of lines of code. It instantiates LWP logging and also returns a LWP::ConsoleLogger object, which you may then tweak to your heart's desire.

If you're able to install HTML::FormatText::Lynx then you'll get highly readable HTML to text conversions.

FUNCTIONS

debug_ua( $mech, $verbosity )

When called without a verbosity argument, this function turns on all logging. I'd suggest going with this to start with and then turning down the verbosity after that. This method returns an LWP::ConsoleLogger object, which you may tweak to your heart's desire.

my $ua_logger = debug_ua( $mech );
$ua_logger->content_pre_filter( sub {...} );
$ua_logger->logger( Log::Dispatch->new(...) );

$mech->get(...);

You can provide a verbosity level of 0 or more. (Currently 0 - 8 supported.) This will turn up the verbosity on your output gradually. A verbosity of 0 will display nothing. 8 will display all available outputs.

# don't get too verbose
my $ua_logger = debug_ua( $mech, 4 );

CAVEATS

Text formatting now defaults to attempting to use HTML::FormatText::Lynx to format HTML as text. If you do not have this installed, we'll fall back to using HTML::Restrict to remove any HTML tags which you have not specifically whitelisted.

EXAMPLES

Please see the "examples" folder in this distribution for more ideas on how to use this module.

AUTHOR

Olaf Alders <olaf@wundercounter.com>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2014 by MaxMind, Inc..

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)