stellr

stellr by Jens Kraemer and Benjamin Krause http://rubyforge.org/projects/stellr

== DESCRIPTION:

Stellr is a Ferret based standalone search server featuring a DRB and (soon to come) an http frontend. It can handle multiple indexes, including multi-index searches. A client library and a simple command line query tool are included with the gem.

== FEATURES:

• DRb frontend
• easy to use client library (see below)
• multi index search
• Index rotation Stellr always keeps two versions of your index around - one is used in a multi threaded, read only way to handle incoming search requests, while the other one is written to when you index something. Using the switch function you may decide when to switch over searching from the old index to the new one. Then, changes will be synced, and searches will see the new or updated data from before the switch call.
• Index synchronization Two kinds of synchronization methods are supported for now: rsync, using rsync two copy over the changes from one index to the other, and static, which will completely replace the old index with the new one. While the latter is suitable for indexes which you rebuild completely from time to time, the former is good for large indexes that are updated frequently or that are too large for frequent rebuilds.

== SYNOPSIS:

• start the server:

  stellr -c /path/to/config.yml start

• index something

  require 'stellr/client' stellr = Stellr::Client.new('druby://localhost:9010') config = { :collection => :static, # static collections are rebuilt from scratch everytime changes occur

  :collection => :rsync, # use the rsync collection for indexes that are updated frequently and/or are

                                # too large to be rebuilt from scratch every time they're updated
  

  :analyzer => 'My::Analyzer', :fields => { :title => { :boost => 5, :store => :yes }, :content => { :store => :no } } } collection = stellr.connect('my_collection', config) collection.add_record(:id => 1, :title => 'Some Title', :content => 'Content') collection.switch #

• command line search

  stellr-search my_collection 'query string'

  for now, this will display the first 10 hits only.

• search via the client library

  require 'stellr/client' stellr = Stellr::Client.new('druby://localhost:9010') collection = stellr.connect 'my_collection', :analyzer => 'My::Analyzer' # the analyzer to use for query parsing results = collection.search 'querystring', :page => 1, :per_page => 100, # built in pagination support :fields => [:title, :content], # the fields to search in :get_fields => [ :title ] # the fields to fetch for result display

• multi-collection search pass an array of collection names to search multiple collections at once:

  collection = stellr.connect [ 'my_collection', 'another_collection' ], :analyzer => 'My::Analyzer'

== REQUIREMENTS:

• Ferret (gem install ferret)
• daemons (gem install daemons)

== INSTALL:

• sudo gem install stellr

== LICENSE:

(The MIT License)

Copyright (c) 2008 Jens Kraemer, Benjamin Krause

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.