/ 
KinoSearchX-Simple-0.02
/ KinoSearchX::Simple

NAME

KinoSearchX::Simple - Simple KinoSearch1 Interface, inspired by Plucene::Simple

SYNOPSIS

use KinoSearchX::Simple;

my $searcher = KinoSearchX::Simple->new(
    'index_path' => '/tmp/search_index',
    'schema' => [
        {
            'name' => 'title',
            'boost' => 3,
        },{
            'name' => 'description',
        },{
            'name' => 'id',
        },
    ],
    'search_fields' => ['title', 'description'],
    'search_boolop' => 'AND',
);

$searcher->create({
    'id' => 1,
    'title' => 'fibble',
    'description' => 'wibble',
});

#important - always commit after updating the index!
$searcher->commit;

my ( $results, $pager ) = $searcher->search( 'fibble' );

DESCRIPTION

Simple interface to KinoSearch1. Use if you want to use KinoSearch1 and are lazy :p

FUNCTIONS

search( $query_string, $page ) - search index

my ( $results, $pager ) = $searcher->search( $query, $page );

create( $document ) - add item to index

$searcher->create({
    'id' => 1,
    'title' => 'this is the title',
    'description' => 'this is the description',
});

update_or_create( $document, $pk, $pv ) - updates or creates document in the index

$searcher->update_or_create({
    'id' => 1,
    'title' => 'this is the updated title',
    'description' => 'this is the description',
}, 'id', 1);

$pk defaults to 'id' $pv defaults to $document->{'id'} if not provided

delete( $key, $value ) - remove document from the index

$searcher->delete( 'id', 1 );

finds $key with $value and removes from index

commit() - commits and optimises index after adding documents

$searcher->commit();

you must call this after you have finished adding items to the index

ADVANCED

when creating the KinoSearchX::Simple object you can specify some advanced options

language

set's language for default _analyser of KinoSearch1::Analysis::PolyAnalyzer

_analyser

set analyser, defualts to KinoSearch1::Analysis::PolyAnalyzer

search_fields

fields to search by default, takes an arrayref

search_boolop

can be OR or AND

search boolop, defaults to or. e.g the following query

"this is search query"

becomes

"this OR is OR search OR query"

can be changed to AND, in which case the above becomes

"this AND is AND search AND query"

resultclass

resultclass for results, defaults to KinoSearchX::Simple::Result which creates acessors for each key => value returned

entries_per_page

default is 100

SUPPORT

Bugs should always be submitted via the CPAN bug tracker

http://rt.cpan.org/NoAuth/ReportBug.html?Queue=KinoSearchX-Simple

For other issues, contact the maintainer

AUTHORS

n0body <n0body@thisaintnews.com>

SEE ALSO

http://thisaintnews.com, KinoSearch1, Data::Page, Moose

COPYRIGHT

Copyright 2010 n0body http://thisaintnews.com/ . All rights reserved.

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