www::mechanize::gzip(3pm) [debian man page]

WWW::Mechanize::GZip(3pm)				User Contributed Perl Documentation				 WWW::Mechanize::GZip(3pm)

NAME

       WWW::Mechanize::GZip - tries to fetch webpages with gzip-compression

VERSION

       Version 0.10

SYNOPSIS

	   use WWW::Mechanize::GZip;

	   my $mech = WWW::Mechanize::GZip->new();
	   my $response = $mech->get( $url );

	   print "x-content-length (before unzip) = ", $response->header('x-content-length');
	   print "content-length (after unzip) = ", $response->header('content-length');

DESCRIPTION

       The WWW::Mechanize::GZip module tries to fetch a URL by requesting gzip-compression from the webserver.

       If the response contains a header with 'Content-Encoding: gzip', it decompresses the response in order to get the original (uncompressed)
       content.

       This module will help to reduce bandwith fetching webpages, if supported by the webeserver. If the webserver does not support gzip-
       compression, no decompression will be made.

       This modules is a direct subclass of WWW::Mechanize and will therefore support any methods provided by WWW::Mechanize.

       The decompression is handled by Compress::Zlib::memGunzip.

       There is a small webform, you can instantly test, whether a webserver supports gzip-compression on a particular URL:
       <http://www.computerhandlung.de/www-mechanize-gzip.htm>

   METHODS
       prepare_request
	 Adds 'Accept-Encoding' => 'gzip' to outgoing HTTP-headers before sending.

       send_request
	 Unzips response-body if 'content-encoding' is 'gzip' and corrects 'content-length' to unzipped content-length.

SEE ALSO

       WWW::Mechanize

       Compress::Zlib

AUTHOR

       Peter Giessner "cardb@planet-elektronik.de"

LICENCE AND COPYRIGHT

       Copyright (c) 2007, Peter Giessner "cardb@planet-elektronik.de".  All rights reserved.

       This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.10.0							    2009-06-24						 WWW::Mechanize::GZip(3pm)

WWW::Mechanize::TreeBuilder(3pm)			User Contributed Perl Documentation			  WWW::Mechanize::TreeBuilder(3pm)

NAME

       WWW::Mechanize::TreeBuilder - Module to optimize WWW::Mechanize and HTML::TreeBuilder use

SYNOPSIS

	use Test::More tests => 2;
	use Test::WWW::Mechanize;
	use WWW::Mechanize::TreeBuilder;
	# or
	# use WWW::Mechanize;
	# or
	# use Test::WWW::Mechanize::Catalyst 'MyApp';

	my $mech = Test::WWW::Mechanize->new;
	# or
	#my $mech = Test::WWW::Mechanize::Catalyst->new;
	# etc. etc.
	WWW::Mechanize::TreeBuilder->meta->apply($mech);

	$mech->get_ok('/');
	is( $mech->look_down(_tag => 'p')->as_trimmed_text, 'Some text', 'It worked' );

DESCRIPTION

       This module combines WWW::Mechanize and HTML::TreeBuilder. Why? Because I've seen too much code like the following:

	like($mech->content, qr{<p>some text</p>}, "Found the right tag");

       Which is just all flavours of wrong - its akin to processing XML with regexps.  Instead, do it like the following:

	ok($mech->look_down(_tag => 'p', sub { $_[0]->as_trimmed_text eq 'some text' })

       The anon-sub there is a bit icky, but this means that anyone should happen to add attributes to the "<p>" tag (such as an id or a class) it
       will still work and find the right tag.

       All of the methods available on HTML::Element (that aren't 'private' - i.e.  that don't begin with an underscore) such as "look_down" or
       "find" are automatically delegated to "$mech->tree" through the magic of Moose.

METHODS

       Everything in WWW::Mechanize (or which ever sub class you apply it to) and all public methods from HTML::Element except those where
       WWW::Mechanize and HTML::Element overlap. In the case where the two classes both define a method, the one from WWW::Mechanize will be used
       (so that the existing behaviour of Mechanize doesn't break.)

USING XPATH OR OTHER SUBCLASSES

       HTML::TreeBuilder::XPath allows you to use use xpath selectors to select elements in the tree. You can use that module by providing
       parameters to the moose role:

	with 'WWW::Mechanize::TreeBuilder' => {
	  tree_class => 'HTML::TreeBuilder::XPath'
	};

	# or

	# NOTE: No hashref using this method
	WWW::Mechanize::TreeBuilder->meta->apply($mech,
	  tree_class => 'HTML::TreeBuilder::XPath';
	);

       and class will be automatically loaded for you. This class will be used to construct the tree in the following manner:

	$tree = $tree_class->new_from_content($req->decoded_content)->elementify;

       You can also specify a "element_class" parameter which is the (HTML::Element sub)class that methods are proxied from. This module provides
       defaults for element_class when "tree_class" is "HTML::TreeBuilder" or "HTML::TreeBuilder::XPath" - it will warn otherwise.

AUTHOR

       Ash Berlin "<ash@cpan.org>"

LICENSE

       Same as Perl 5.8, or at your option any later version of Perl.

perl v5.10.1							    2010-12-16					  WWW::Mechanize::TreeBuilder(3pm)