NAME

Plucene::TestCase - Handy functions when testing Plucene

SYNOPSIS

        use Test::More tests => 10;
        use Plucene::TestCase;

        new_index {
                add_document( foo => "bar" );
        };

        re_index {
                add_document( foo => "baz" );
        }

        with_reader {
                $READER->whatever;
        }

        my $hits = search("foo:ba*");

EXPORTS

$DIR

A directory which is created for the purposes of this test, in which the index will be placed. It will normally be cleaned up at the end of the test, unless $Plucene::TestCase::DEBUG is set to allow you to peruse the entrails.

$WRITER

A variable holding the current Index::Writer object, if there is one.

$READER

A variable holding the current Index::Reader object, if there is one.

$ANALYZER

A variable holding the class name of the desired Analysis::Analyzer class.

new_index BLOCK (Analyzer)

Create a new index, and do the following stuff in the block before closing the index writer. $WRITER is set for the duration of the block.

The optional parameter should be the class name of the analyzer to use; if not specified, the value from $ANALYZER, which in turn defaults to Plucene::Analysis::SimpleAnalyzer, will be used.

re_index BLOCK (Analyzer)

Same as new_index, but doesn't create a new index, rather re-uses an old one.

add_document( field1 => value1, ...)

Add a new document to the index, with the given fields and values

with_reader BLOCK

Opens an index reader in $READER and runs the block.

search

Searches for the query given. If any fields are not specified, they will be assumed to be the default text. Returns a Plucene::Search::Hits object. The value of $ANALYZER will be used to construct an analyzer for the query string.