LWP::ConsoleLogger::Easy - Easy LWP tracing and debugging
version 0.000018
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 );
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.
debug_ua
If you're able to install HTML::FormatText::Lynx then you'll get highly readable HTML to text conversions.
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 );
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.
If you have HTML::FormatText::Lynx installed, but you don't want to use it, override the default filter:
my $logger = debug_ua( $mech ); $logger->text_pre_filter( sub { return shift } );
Please see the "examples" folder in this distribution for more ideas on how to use this module.
Olaf Alders <olaf@wundercounter.com>
This software is Copyright (c) 2014 by MaxMind, Inc..
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
To install LWP::ConsoleLogger, copy and paste the appropriate command in to your terminal.
cpanm
cpanm LWP::ConsoleLogger
CPAN shell
perl -MCPAN -e shell install LWP::ConsoleLogger
For more information on module installation, please visit the detailed CPAN module installation guide.