NAME

Email::Store::Plucene - Search your Email::Store with Plucene

SYNOPSIS

use Email::Store;
$Email::Store::Plucene::index_path = "/var/db/mailstore_index";
Email::Store::Mail->store($_) for @mails;
Email::Store::Plucene->optimize;

@some_mails = 
  Email::Store::Mail->plucene_search("from:dan list:perl6-internals");

@may_mails = Email::Store::Mail->plucene_search_during
          ("from:dan list:perl6-internals", "2004-05-01", "2004-05-31");

DESCRIPTION

This module adds Plucene indexing to Email::Store's indexing. Whenever a mail is indexed, an entry will be added in the Plucene index which is located at $Email::Store::Plucene::index_path. If you don't change this variable, you'll end up with an index called emailstore-index in the current directory.

METHODS

The module hooks into the store method in the usual way, and provides two new search methods:

plucene_search

This takes a query and returns a list of mails matching that query. The query terms are by default joined together with the OR operator.

plucene_search_during

As above, but also takes two ISO format dates, returning only mails in that period.

NOTES FOR PLUG-IN WRITERS

This module provides a hook called on_gather_plucene_fields. You should provide methods called on_gather_plucene_fields_order (a numeric ordering) and on_gather_plucene_fields. This last should expect a Email::Store::Mail object and a hash reference. Write into this hash reference any fields you want to be searchable:

package Email::Store::Annotations;
sub on_gather_plucene_fields_order { 10 }
sub on_gather_plucene_fields {
    my ($self, $mail, $hash);
    $hash->{notes} = join " ", $mail->annotations;
}

Now you should be able to use notes:foo to search for mails with "foo" in their annotations.

COPYRIGHT AND LICENSE

Copyright 2004 by Simon Cozens

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