NAME

Mail::SimpleList::Aliases - manages Mail::SimpleList::Alias objects

SYNOPSIS

        use Mail::SimpleList::Aliases;
        my $aliases = Mail::SimpleList::Aliases->new( '.aliases' );

DESCRIPTION

Mail::SimpleList::Aliases manages the creation, loading, and saving of Mail::SimpleList::Alias objects. If you'd like to change how these objects are managed on your system, subclass or reimplement this module.

METHODS

• new( [ $alias_directory ] )

  Creates a new Mail::SimpleList::Aliases object. The single argument is optional but highly recommended. It should be the path to where Alias data files are stored. Beware that in filter mode, relative paths can be terribly ambiguous.

  If no argument is provided, this will default to ~/.aliases for the invoking user.

• storage_dir()

  Returns the directory where this object's Alias data files are stored.

• exists( $alias_name )

  Returns true or false if an alias with this name exists.

• fetch( $alias_name )

  Creates and returns a Mail::SimpleList::Alias object represented by this alias name. This can return nothing if the alias does not exist.

• create( $owner )

  Creates and returns a new Mail::SimpleList::Alias object, setting the owner. Note that you will need to save() the object yourself, if that's important to you.

• save( $alias, $alias_name )

  Saves a Mail::SimpleList::Alias object provided as $alias with the given name in $alias_name.

AUTHOR

chromatic, chromatic@wgz.org, with helpful suggestions from friends, family, and peers.

BUGS

None known.

TODO

No plans. It's pretty nice as it is.

SEE ALSO

Mail::Action::Storage, the parent class.

COPYRIGHT

Copyright (c) 2003, chromatic. All rights reserved. This module is distributed under the same terms as Perl itself. Convenient for you!