public
Description: Ambition adapter for Sphinx
Clone URL: git://github.com/technicalpickles/ambitious-sphinx.git
Josh Nichols (author)
Thu Feb 07 12:25:56 -0800 2008
commit  c629eb5cfdb2fe8d79017da6f277d201f3c8c41a
tree    4ede5165c09e3c2fa6d1ee6f9429fed13a561adf
parent  39c5237fbbaf832aa14eb6af436c5909c141e637
name age message
file .gitignore Thu Jan 24 19:12:53 -0800 2008 Ignore .gemspecs. [Josh Nichols]
file LICENSE Wed Jan 30 22:02:56 -0800 2008 Updated docs, added real license. [Josh Nichols]
file Manifest Thu Jan 24 19:11:00 -0800 2008 Imported ambitious sphinx. [Josh Nichols]
file README Thu Jan 31 08:04:19 -0800 2008 More readme. [Josh Nichols]
file Rakefile Wed Jan 30 22:04:22 -0800 2008 Added dependency on ultrasphinx. [Josh Nichols]
directory config/ Thu Jan 24 19:11:00 -0800 2008 Imported ambitious sphinx. [Josh Nichols]
directory lib/ Thu Feb 07 12:24:10 -0800 2008 Some slight wording changes. Updated =~ spec to... [Josh Nichols]
directory test/ Thu Feb 07 12:25:56 -0800 2008 Removed some unnecessary specs. [Josh Nichols]
README
An Ambitious Sphinx Adapter
===========================

Ever want to do some sexy full text searching?

How about finding all tweets that have "Obama" in the any of its attributes?

Tweet.select { "Obama" }

What about tweets with "McCain" and "Clinton"?

Tweet.select { "McCain" && "Clinton" }

"Edwards" or "Huckabee" ?

Tweet.select { "Edwards" || "Huckabee" }


### Big honking disclaimer



### Getting Started

You will need the following gems to use ambitious-sphinx:

  gem install ambition
  gem install ultrasphinx
  

  Now install it as ambitious-sphinx:

    sudo rake install
    
  Require our files somewhere, like at the end of config/environment.rb
  
    require 'ambition/adapters/ambitious_sphinx'
    
  You will also need to go through the motions of setting up ultrasphinx. This includes setting up sphinx itself, and 
  modifying your model to indicate what's to be indexed, and so on.

### Playing with the code base

In addition to the other dependencies, you'll need:

  gem install echoe redgreen mocha test-spec
  
Run the tests with:
  
  rake test
  

### More information on Sphinx:

 -> http://www.sphinxsearch.com/
 -> http://blog.evanweaver.com/articles/2007/07/09/ultrasphinx-searching-the-world-in-231-seconds/
 -> http://blog.evanweaver.com/files/doc/fauna/ultrasphinx/files/README.html

### More information on Ambition:

-> http://ambition.rubyforge.org
-> http://groups.google.com/group/ambition-rb/