Memoize::Saves

Memoize::Saves is a plug-in module for Memoize. It allows the user to
specify which values should be cached or which should be dumped. Please
read the manual for Memoize for background information.

Use the CACHE option to specify a list of return values which should be
memoized. All other values will need to be recomputed each time.

Use the DUMP option to specify a list of return values which should not
be memoized. Only these values will need to be recomputed each time.

Use the REGEX option to specify a Regular Expression which must match
for the return value to be saved. You can supply either a plain text
string or a compiled regular expression using qr//. Obviously the second
method is prefered.

Specifying multiple options will result in the least common denominator
being saved.

You can use the HASH option to string multiple Memoize Plug-ins
together:

   tie my %disk_hash => 'GDBM_File', $filename, O_RDWR|O_CREAT, 0666;
   tie my %expiring_cache => 'Memoize::Expire',
              LIFETIME => 5, HASH => \%disk_cache;
   tie my %cache => 'Memoize::Saves',
              REGEX => qr/my/, HASH => \%expiring_cache;

   memoize ('printme', SCALAR_CACHE => [HASH => \%cache]);

INSTALLATION

This is a Perl module distribution. It should be installed with
whichever tool you use to manage your installation of Perl, e.g. any of

  cpanm .
  cpan  .
  cpanp -i .

Consult http://www.cpan.org/modules/INSTALL.html for further
instruction. Should you wish to install this module manually, the
procedure is

  perl Makefile.PL
  make
  make test
  make install

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Joshua Gerth.

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