NAME

WWW::Mechanize::Cached - Cache resposne to be polite

SYNOPSIS

    use WWW::Mechanize::Cached;

    my $cacher = WWW::Mechanize::Cached->new(
        cache => {
            class => "Cache::FileCache",
            args => {
               ...
            },
        },
    );

    $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.

Supports the additional key cache which should be a hashref containing any of two optional keys.

class

Should be the Cache::Cache based module to use. The default is Cache::FileCache.

args

Should be the arguments to pass to that module's own new constructor. Default contents are namespace (set to WWW::Mechanize::Cached) and default_expires_in (set to 1d).

METHODS

All methods are provided by WWW::Mechanize. See taht 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
    ( shorter URL: http://xrl.us/63i )

    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, 2003. 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>

SEE ALSO

perl, WWW::Mechanize.