The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Search-Mousse-0.32
River stage zero No dependents
++
/ Search::Mousse

NAME

Search::Mousse - A simple and fast inverted index

SYNOPSIS

  my $mousse = Search::Mousse->new(
    directory => $directory,
    name      => 'recipes',
  );
  my $recipe = $mousse->fetch("Hearty Russian Beet Soup");
  my @recipes = $mousse->search("crumb");
  my @recipe_keys = $mousse->search_keys("italian soup");

DESCRIPTION

Search::Mousse provides a simple and fast inverted index.

It is intended for constant databases (this is why it can be fast). Documents have a key, keywords (which the document can later be search for with) and a value (which can be a Perl data structure or object).

Use Search::Mousse::Writer to construct a database.

The default stemmer is:

  sub {
    my $words = lc shift;
    return uniq(split / /, $words);
  }

Why is it called Search::Mousse? Well, in culinary terms, mousses are simple to make, can include quite complicated ingredients, and are inverted before presentation.

CONSTRUCTOR

new

The constructor takes a few arguments: the directory to store files in, and a name for the database. If you have a custom stemmer, also pass it in:

  my $mousse = Search::Mousse->new(
    directory => $directory,
    name      => 'recipes',
  );
  
  my $mousse2 = Search::Mousse->new(
    directory => $directory,
    name      => 'photos',
    stemmer   => \&stemmer,
  );

METHODS

and

If this is set to true, query terms are ANDed by default. Thus "white bread" would be parsed the same as "+white +bread":

  $mousse->and(1);

fetch

Returns a value from the database, given a key:

  my $recipe = $mousse->fetch("Hearty Russian Beet Soup");

If you have used Search::Mousse::Writer::Related to analyse the database, the fetch_related() method returns a list of values that are similar to the given key:

  my @recipes = $mousse->fetch_related("Hearty Russian Beet Soup");

If you have used Search::Mousse::Writer::Related to analyse the database, the fetch_related_keys() method returns a list of keys that are similar to the given key:

  my @keys = $mousse->fetch_related_keys("Hearty Russian Beet Soup");

Returns a list of values that match the search terms (but see and()):

  my @white_or_bread = $mousse->search("white bread");
  my @white_bread    = $mousse->search("+white +bread");
  my @nonwhite_bread = $mousse->search("-white +bread");

search_keys

Returns a list of keys that have all the keywords passed:

  my @recipe_keys = $mousse->search_keys("italian soup");

SEE ALSO

Search::Mousse::Writer, Search::Mousse::Writer::Related

AUTHOR

Leon Brocard, <acme@astray.com>

COPYRIGHT

Copyright (C) 2005, Leon Brocard

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