NAME
WWW::Mechanize::Cached - Cache response to be polite
VERSION
Version 1.28
$Header: /home/cvs/www-mechanize-cached/Cached.pm,v 1.13 2004/03/14 04:08:40 andy Exp $
SYNOPSIS
use WWW::Mechanize::Cached;
my $cacher = WWW::Mechanize::Cached->new;
$cacher->get( $url );
DESCRIPTION
Uses the Cache::Cache hierarchy to implement a caching Mech. This lets one perform repeated requests without hammering a server impolitely.
CONSTRUCTOR
new
Behaves like, and calls, WWW::Mechanize's new
method. Any parms passed in get passed to WWW::Mechanize's constructor.
You can pass in a cache => $cache_object
if you want. The $cache_object must have get()
and set()
methods like the Cache::Cache
family.
The cache parm used to be a set of parms that described how the cache object was to be initialized, but I think it makes more sense to have the user initialize the cache however she wants, and then pass it in.
METHODS
All methods are provided by WWW::Mechanize. See that module's documentation for details.
THANKS
Andy Lester (PETDANCE) for WWW::Mechanize.
ODDITIES
It may sometimes seem as if it's not caching something. And this may well be true. It uses the HTTP request, in string form, as the key to the cache entries, so any minor changes will result in a different key. This is most noticable when following links as WWW::Mechanize adds a Referer
header.
BUGS, REQUESTS, COMMENTS
Support for this module is provided via the CPAN RT system:
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-Mechanize-Cached
bug-www-mechanize-cached@rt.cpan.org
This makes it much easier for me to track things and thus means your problem is less likely to be neglected.
LICENCE AND COPYRIGHT
This module is copyright Iain Truskett and Andy Lester, 2004. All rights reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.000 or, at your option, any later version of Perl 5 you may have available.
The full text of the licences can be found in the Artistic and COPYING files included with this module, or in perlartistic and perlgpl as supplied with Perl 5.8.1 and later.
AUTHOR
Iain Truskett <spoon@cpan.org>, currently maintained by Andy Lester <petdance@cpan.org>