Mail::TempAddress::Addresses::Purgeable - manage and purge Mail::TempAddress::Address objects
This module is deprecated. It has been replaced by Mail::Action::Role::Purge, which adds a role to any subclass of Mail::Action::Storage, including Mail::TempAddress::Addresses and Mail::SimpleList::Aliases.
use Mail::TempAddress::Addresses::Purgeable; my $addresses = Mail::TempAddress::Addresses::Purgeable( '.addresses' );
Mail::TempAddress::Addresses::Purgeable extends Mail::TempAddress::Addresses to provide the ability to purge expired address data files.
purge( [ $min_expired_age ] )
The purge method iterates through each data file found in the addresses directory. Each data file is loaded into a Mail::TempAddress::Address object and it's expiry date (if any) is compared against the current time. Any object which is expired will have it's data file removed from the filesystem.
By default each object need only be expired. Passing the $min_expired_age requires that the object have been expired for at least that many seconds. The minimum age may also be passed using a freeform expression like '1h30m' or '2m1w'. See "Expires" in Mail::TempAddress for more details.
For example, if an address object is set to expire at Mon Oct 27 19:31:39 2003 and the purge() routine is run at 19:33 with an argument of 300, then the data file for the object will not be deleted. If the purge method were to be called at 19:36:40 or any time thereafter then the data file will be deleted.
addresses()
The <data_files> method returns a list or list reference (depending on calling context) of the addresses in the address directory.
James FitzGibbon <jfitz@CPAN.ORG>
Major things. chromatic's modules Mail::TempAddress and Mail::SimpleList have large quantities of similar code and he plans to factor that out into a separate base class. Once that happens, the functionality provided by this module would better be implemented as a mixin (see mixin).
Copyright (c) 2003, James FitzGibbon. All rights reserved. This module is distributed under the same terms as Perl itself.
To install Mail::TempAddress::Addresses::Purgeable, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Mail::TempAddress::Addresses::Purgeable
CPAN shell
perl -MCPAN -e shell install Mail::TempAddress::Addresses::Purgeable
For more information on module installation, please visit the detailed CPAN module installation guide.