sayso-thinking-sphinx 2.0.3.001

data/spec/thinking_sphinx/index/faux_column_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+describe ThinkingSphinx::Index::FauxColumn do  
+  describe "coerce class method" do
+    before :each do
+      @column = stub('column')
+      ThinkingSphinx::Index::FauxColumn.stub!(:new => @column)
+    end
+    
+    it "should return a single faux column if passed a string" do
+      ThinkingSphinx::Index::FauxColumn.coerce("string").should == @column
+    end
+    
+    it "should return a single faux column if passed a symbol" do
+      ThinkingSphinx::Index::FauxColumn.coerce(:string).should == @column
+    end
+    
+    it "should return an array of faux columns if passed an array of strings" do
+      ThinkingSphinx::Index::FauxColumn.coerce(["one", "two"]).should == [
+        @column, @column
+      ]
+    end
+    
+    it "should return an array of faux columns if passed an array of symbols" do
+      ThinkingSphinx::Index::FauxColumn.coerce([:one, :two]).should == [
+        @column, @column
+      ]
+    end
+  end
+  
+  describe '#to_ary' do
+    it "should return an array with the instance inside it" do
+      subject.to_ary.should == [subject]
+    end
+  end
+end

data/spec/thinking_sphinx/index_spec.rb

@@ -0,0 +1,183 @@
+require 'spec_helper'
+
+describe ThinkingSphinx::Index do
+  describe "prefix_fields method" do
+    before :each do
+      @index = ThinkingSphinx::Index.new(Person)
+      
+      @field_a = stub('field', :prefixes => true)
+      @field_b = stub('field', :prefixes => false)
+      @field_c = stub('field', :prefixes => true)
+      
+      @index.stub!(:fields => [@field_a, @field_b, @field_c])
+    end
+    
+    it "should return fields that are flagged as prefixed" do
+      @index.prefix_fields.should include(@field_a)
+      @index.prefix_fields.should include(@field_c)
+    end
+    
+    it "should not return fields that aren't flagged as prefixed" do
+      @index.prefix_fields.should_not include(@field_b)
+    end
+  end
+  
+  describe "infix_fields method" do
+    before :each do
+      @index = ThinkingSphinx::Index.new(Person)
+      
+      @field_a = stub('field', :infixes => true)
+      @field_b = stub('field', :infixes => false)
+      @field_c = stub('field', :infixes => true)
+      
+      @index.stub!(:fields => [@field_a, @field_b, @field_c])
+    end
+    
+    it "should return fields that are flagged as infixed" do
+      @index.infix_fields.should include(@field_a)
+      @index.infix_fields.should include(@field_c)
+    end
+    
+    it "should not return fields that aren't flagged as infixed" do
+      @index.infix_fields.should_not include(@field_b)
+    end
+  end
+  
+  describe '.name_for' do
+    it "should return the model's name downcased" do
+      ThinkingSphinx::Index.name_for(Alpha).should == 'alpha'
+    end
+    
+    it "should separate words by underscores" do
+      ThinkingSphinx::Index.name_for(ActiveRecord).should == 'active_record'
+    end
+    
+    it "should separate namespaces by underscores" do
+      ThinkingSphinx::Index.name_for(ActiveRecord::Base).
+        should == 'active_record_base'
+    end
+  end
+  
+  describe '#name' do
+    it "should return the downcased name of the index's model" do
+      ThinkingSphinx::Index.new(Alpha).name.should == 'alpha'
+    end
+    
+    it "should return a custom name if one is set" do
+      index = ThinkingSphinx::Index.new(Alpha)
+      index.name = 'custom'
+      index.name.should == 'custom'
+    end
+  end
+  
+  describe '#core_name' do
+    it "should take the index's name and append _core" do
+      ThinkingSphinx::Index.new(Alpha).core_name.should == 'alpha_core'
+    end
+  end
+  
+  describe '#delta_name' do
+    it "should take the index's name and append _delta" do
+      ThinkingSphinx::Index.new(Alpha).delta_name.should == 'alpha_delta'
+    end
+  end
+  
+  describe '#all_names' do
+    it "should return the core index name by default" do
+      ThinkingSphinx::Index.new(Alpha).all_names.should == ['alpha_core']
+    end
+    
+    it "should return both core and delta names if deltas are enabled" do
+      index = ThinkingSphinx::Index.new(Alpha)
+      index.delta_object = stub('delta')
+      
+      index.all_names.should == ['alpha_core', 'alpha_delta']
+    end
+    
+    it "should respect custom names" do
+      index = ThinkingSphinx::Index.new(Alpha)
+      index.name = 'custom'
+      
+      index.all_names.should == ['custom_core']
+    end
+    
+    it "should respect custom names when deltas are enabled" do
+      index = ThinkingSphinx::Index.new(Alpha)
+      index.name = 'custom'
+      index.delta_object = stub('delta')
+      
+      index.all_names.should == ['custom_core', 'custom_delta']
+    end
+  end
+  
+  describe '#to_riddle' do
+    it "should return two Riddle indexes if deltas are disabled" do
+      index = ThinkingSphinx::Index.new(Alpha)
+      
+      index.to_riddle(0).length.should == 2
+    end
+    
+    it "should return three Riddle indexes if deltas are enabled" do
+      index = ThinkingSphinx::Index.new(Beta)
+      index.delta_object = stub('delta')
+      
+      index.to_riddle(0).length.should == 3
+    end
+    
+    it "should include a distributed index" do
+      index = ThinkingSphinx::Index.new(Alpha)
+      
+      index.to_riddle(0).last.
+        should be_a(Riddle::Configuration::DistributedIndex)
+    end
+    
+    context 'core index' do
+      it "should use the core name" do
+        @index = ThinkingSphinx::Index.new(Alpha).to_riddle(0).first
+        @index.name.should == 'alpha_core'
+      end
+      
+      it "should not try to set disable_range on the index" do
+        ThinkingSphinx::Configuration.instance.
+          index_options[:disable_range] = true
+        
+        lambda {
+          @index = ThinkingSphinx::Index.new(Alpha).to_riddle(0).first
+        }.should_not raise_error(NoMethodError)
+      end
+    end
+    
+    context 'delta index' do
+      before :each do
+        index = ThinkingSphinx::Index.new(Beta)
+        index.delta_object = stub('delta')
+        @index = index.to_riddle(0)[1]
+      end
+      
+      it "should use the delta name" do
+        @index.name.should == 'beta_delta'
+      end
+    end
+    
+    context 'distributed index' do
+      it "should use the index's name" do
+        index = ThinkingSphinx::Index.new(Alpha)
+
+        index.to_riddle(0).last.name.should == 'alpha'
+      end
+      
+      it "should add the core index" do
+        index = ThinkingSphinx::Index.new(Alpha)
+
+        index.to_riddle(0).last.local_indexes.should include('alpha_core')
+      end
+      
+      it "should add the delta index if there is one" do
+        index = ThinkingSphinx::Index.new(Beta)
+        index.delta_object = stub('delta')
+
+        index.to_riddle(0).last.local_indexes.should include('beta_delta')
+      end
+    end
+  end
+end

data/spec/thinking_sphinx/search_methods_spec.rb

@@ -0,0 +1,156 @@
+require 'spec_helper'
+
+describe ThinkingSphinx::SearchMethods do
+  it "should be included into models with indexes" do
+    Alpha.included_modules.should include(ThinkingSphinx::SearchMethods)
+  end
+  
+  it "should not be included into models that don't have indexes" do
+    Gamma.included_modules.should_not include(ThinkingSphinx::SearchMethods)
+  end
+  
+  describe '.search_context' do
+    it "should return nil if not within a model" do
+      ThinkingSphinx.search_context.should be_nil
+    end
+    
+    it "should return the model if within one" do
+      Alpha.search_context.should == Alpha
+    end
+  end
+  
+  describe '.search' do
+    it "should return an instance of ThinkingSphinx::Search" do
+      Alpha.search.class.should == ThinkingSphinx::Search
+    end
+    
+    it "should set the classes option if not already set" do
+      search = Alpha.search
+      search.options[:classes].should == [Alpha]
+    end
+    
+    it "shouldn't set the classes option if already defined" do
+      search = Alpha.search :classes => [Beta]
+      search.options[:classes].should == [Beta]
+    end
+    
+    it "should default to nil for the classes options" do
+      ThinkingSphinx.search.options[:classes].should be_nil
+    end
+  end
+  
+  describe '.search_for_ids' do
+    it "should return an instance of ThinkingSphinx::Search" do
+      Alpha.search.class.should == ThinkingSphinx::Search
+    end
+    
+    it "should set the classes option if not already set" do
+      search = Alpha.search_for_ids
+      search.options[:classes].should == [Alpha]
+    end
+    
+    it "shouldn't set the classes option if already defined" do
+      search = Alpha.search_for_ids :classes => [Beta]
+      search.options[:classes].should == [Beta]
+    end
+    
+    it "should set ids_only to true" do
+      search = Alpha.search_for_ids
+      search.options[:ids_only].should be_true
+    end
+  end
+  
+  describe '.search_for_id' do
+    before :each do
+      @config = ThinkingSphinx::Configuration.instance
+      @client = Riddle::Client.new
+
+      @config.stub!(:client => @client)
+      @client.stub!(:query => {:matches => [], :total_found => 0})
+    end
+    
+    it "should set the id range to the given id value" do
+      ThinkingSphinx.search_for_id(101, 'alpha_core')
+      
+      @client.id_range.should == (101..101)
+    end
+    
+    it "should not make any calls to the database" do
+      Alpha.should_not_receive(:find)
+      
+      ThinkingSphinx.search_for_id(101, 'alpha_core', :classes => [Alpha])
+    end
+    
+    it "should return true if there is a record" do
+      @client.stub!(:query => {:matches => [
+        {:attributes => {'sphinx_internal_id' => 100}}
+      ], :total_found => 1})
+      
+      ThinkingSphinx.search_for_id(101, 'alpha_core').should be_true
+    end
+    
+    it "should return false if there isn't a record" do
+      ThinkingSphinx.search_for_id(101, 'alpha_core').should be_false
+    end
+  end
+  
+  describe '.count' do
+    before :each do
+      @config = ThinkingSphinx::Configuration.instance
+      @client = Riddle::Client.new
+
+      @config.stub!(:client => @client)
+      @client.stub!(:query => {:matches => [], :total_found => 42})
+    end
+    
+    it "should fall through to ActiveRecord if called on a class" do
+      @client.should_not_receive(:query)
+      
+      Alpha.count
+    end
+    
+    it "should return the total number of results if called globally" do
+      ThinkingSphinx.count.should == 42
+    end
+  end
+  
+  describe '.search_count' do
+    before :each do
+      @config = ThinkingSphinx::Configuration.instance
+      @client = Riddle::Client.new
+
+      @config.stub!(:client => @client)
+      @client.stub!(:query => {:matches => [], :total_found => 42})
+    end
+    
+    it "should return the total number of results" do
+      Alpha.search_count.should == 42
+    end
+    
+    it "should not make any calls to the database" do
+      Alpha.should_not_receive(:find)
+      
+      Alpha.search_count
+    end
+  end
+  
+  describe '.facets' do
+    before :each do
+      ThinkingSphinx::Search.stub!(:bundle_searches => [])
+    end
+    
+    it "should return a FacetSearch instance" do
+      Alpha.facets.should be_a(ThinkingSphinx::FacetSearch)
+    end
+    
+    it "should set the classes option if not already set" do
+      facets = Alpha.facets
+      facets.options[:classes].should == [Alpha]
+    end
+    
+    it "shouldn't set the classes option if already defined" do
+      facets = Alpha.facets :classes => [Beta]
+      facets.options[:classes].should == [Beta]
+    end
+  end
+end

data/spec/thinking_sphinx/search_spec.rb

@@ -0,0 +1,1387 @@
+require 'spec_helper'
+require 'will_paginate/collection'
+
+describe ThinkingSphinx::Search do
+  before :each do
+    @config = ThinkingSphinx::Configuration.instance
+    @client = Riddle::Client.new
+    
+    @config.stub!(:client => @client)
+    @client.stub!(:query => {:matches => [], :total_found => 41, :total => 41})
+  end
+  
+  it "not request results from the client if not accessing items" do
+    @config.should_not_receive(:client)
+    
+    ThinkingSphinx::Search.new.class
+  end
+  
+  it "should request results if access is required" do
+    @config.should_receive(:client)
+    
+    ThinkingSphinx::Search.new.first
+  end
+  
+  describe '#respond_to?' do
+    it "should respond to Array methods" do
+      ThinkingSphinx::Search.new.respond_to?(:each).should be_true
+    end
+    
+    it "should respond to Search methods" do
+      ThinkingSphinx::Search.new.respond_to?(:per_page).should be_true
+    end
+  end
+  
+  describe '#populated?' do
+    before :each do
+      @search = ThinkingSphinx::Search.new
+    end
+    
+    it "should be false if the client request has not been made" do
+      @search.populated?.should be_false
+    end
+    
+    it "should be true once the client request has been made" do
+      @search.first
+      @search.should be_populated
+    end
+    
+    it "should be populated if :populate is set to true" do
+      search = ThinkingSphinx::Search.new(:populate => true)
+      search.should be_populated
+    end
+  end
+  
+  describe '#error?' do
+    before :each do
+      @search = ThinkingSphinx::Search.new
+    end
+    
+    it "should be false if client requests have not resulted in an error" do
+      @search.should_receive(:error).and_return(nil)
+      @search.error?.should_not be_true
+    end
+    
+    it "should be true when client requests result in an error" do
+      @search.should_receive(:error).and_return("error message")
+      @search.error?.should be_true
+    end
+  end
+  
+  describe '#warning?' do
+    before :each do
+      @search = ThinkingSphinx::Search.new
+    end
+    
+    it "should be false if client requests have not resulted in a warning" do
+      @search.should_receive(:warning).and_return(nil)
+      @search.warning?.should_not be_true
+    end
+    
+    it "should be true when client requests result in an error" do
+      @search.should_receive(:warning).and_return("warning message")
+      @search.warning?.should be_true
+    end
+  end
+  
+  describe '#results' do
+    it "should populate search results before returning" do
+      @search = ThinkingSphinx::Search.new
+      @search.populated?.should be_false
+      
+      @search.results
+      @search.populated?.should be_true
+    end
+  end
+  
+  describe '#method_missing' do
+    before :each do
+      Alpha.sphinx_scope(:by_name) { |name|
+        {:conditions => {:name => name}}
+      }
+      Alpha.sphinx_scope(:ids_only) { {:ids_only => true} }
+    end
+    
+    after :each do
+      Alpha.remove_sphinx_scopes
+    end
+    
+    it "should handle Array methods" do
+      ThinkingSphinx::Search.new.private_methods.should be_an(Array)
+    end
+    
+    it "should raise a NoMethodError exception if unknown method" do
+      lambda {
+        ThinkingSphinx::Search.new.foo
+      }.should raise_error(NoMethodError)
+    end
+    
+    it "should not request results from client if method does not exist" do
+      @client.should_not_receive(:query)
+      
+      lambda {
+        ThinkingSphinx::Search.new.foo
+      }.should raise_error(NoMethodError)
+    end
+    
+    it "should accept sphinx scopes" do
+      search = ThinkingSphinx::Search.new(:classes => [Alpha])
+      
+      lambda {
+        search.by_name('Pat')
+      }.should_not raise_error(NoMethodError)
+    end
+    
+    it "should return itself when using a sphinx scope" do
+      search = ThinkingSphinx::Search.new(:classes => [Alpha])
+      search.by_name('Pat').object_id.should == search.object_id
+    end
+    
+    it "should keep the same search object when chaining multiple scopes" do
+      search = ThinkingSphinx::Search.new(:classes => [Alpha])
+      search.by_name('Pat').ids_only.object_id.should == search.object_id
+    end
+  end
+  
+  describe '.search' do
+    it "return the output of ThinkingSphinx.search" do
+      @results = [] # to confirm same object
+      ThinkingSphinx.stub!(:search => @results)
+
+      ActiveSupport::Deprecation.silence do
+        ThinkingSphinx::Search.search.object_id.should == @results.object_id
+      end
+    end
+  end
+  
+  describe '.search_for_ids' do
+    it "return the output of ThinkingSphinx.search_for_ids" do
+      @results = [] # to confirm same object
+      ThinkingSphinx.stub!(:search_for_ids => @results)
+
+      ActiveSupport::Deprecation.silence do
+        ThinkingSphinx::Search.search_for_ids.object_id.
+          should == @results.object_id
+      end
+    end
+  end
+  
+  describe '.search_for_id' do
+    it "return the output of ThinkingSphinx.search_for_ids" do
+      @results = [] # to confirm same object
+      ThinkingSphinx.stub!(:search_for_id => @results)
+
+      ActiveSupport::Deprecation.silence do
+        ThinkingSphinx::Search.search_for_id.object_id.
+          should == @results.object_id
+      end
+    end
+  end
+  
+  describe '.count' do
+    it "return the output of ThinkingSphinx.search" do
+      @results = [] # to confirm same object
+      ThinkingSphinx.stub!(:count => @results)
+
+      ActiveSupport::Deprecation.silence do
+        ThinkingSphinx::Search.count.object_id.should == @results.object_id
+      end
+    end
+  end
+  
+  describe '.facets' do
+    it "return the output of ThinkingSphinx.facets" do
+      @results = [] # to confirm same object
+      ThinkingSphinx.stub!(:facets => @results)
+
+      ActiveSupport::Deprecation.silence do
+        ThinkingSphinx::Search.facets.object_id.should == @results.object_id
+      end
+    end
+  end
+  
+  describe '.matching_fields' do
+    it "should return objects with indexes matching 1's in the bitmask" do
+      fields = ['alpha', 'beta', 'gamma', 'delta', 'epsilon', 'zeta', 'eta']
+      ThinkingSphinx::Search.matching_fields(fields, 85).
+        should == ['alpha', 'gamma', 'epsilon', 'eta']
+      
+      ThinkingSphinx::Search.matching_fields(fields, 42).
+        should == ['beta', 'delta', 'zeta']
+    end
+  end
+  
+  describe '#populate' do
+    before :each do
+      @alpha_a, @alpha_b  = Alpha.new,  Alpha.new
+      @beta_a, @beta_b    = Beta.new,   Beta.new
+      
+      @alpha_a.stub! :id => 1, :read_attribute => 1
+      @alpha_b.stub! :id => 2, :read_attribute => 2
+      @beta_a.stub!  :id => 1, :read_attribute => 1
+      @beta_b.stub!  :id => 2, :read_attribute => 2
+      
+      @client.stub! :query => {
+        :matches => minimal_result_hashes(@alpha_a, @beta_b, @alpha_b, @beta_a),
+        :fields  => ["one", "two", "three", "four", "five"]
+      }
+      Alpha.stub! :find => [@alpha_a, @alpha_b]
+      Beta.stub!  :find => [@beta_a, @beta_b]
+    end
+    
+    it "should issue only one select per model" do
+      Alpha.should_receive(:find).once.and_return([@alpha_a, @alpha_b])
+      Beta.should_receive(:find).once.and_return([@beta_a, @beta_b])
+      
+      ThinkingSphinx::Search.new.first
+    end
+    
+    it "should mix the results from different models" do
+      search = ThinkingSphinx::Search.new
+      search[0].should be_a(Alpha)
+      search[1].should be_a(Beta)
+      search[2].should be_a(Alpha)
+      search[3].should be_a(Beta)
+    end
+    
+    it "should maintain the Xoopit ordering for results" do
+      search = ThinkingSphinx::Search.new
+      search[0].id.should == 1
+      search[1].id.should == 2
+      search[2].id.should == 2
+      search[3].id.should == 1
+    end
+    
+    it "should use the requested classes to generate the index argument" do
+      @client.should_receive(:query) do |query, index, comment|
+        index.should == 'alpha_core,beta_core,beta_delta'
+      end
+      
+      ThinkingSphinx::Search.new(:classes => [Alpha, Beta]).first
+    end
+    
+    it "should restrict includes to the relevant classes" do
+      Alpha.should_receive(:find) do |type, options|
+        options[:include].should == [:betas]
+        [@alpha_a, @alpha_b]
+      end
+      
+      Beta.should_receive(:find) do |type, options|
+        options[:include].should == [:gammas]
+        [@beta_a, @beta_b]
+      end
+      
+      ThinkingSphinx::Search.new(:include => [:betas, :gammas]).first
+    end
+    
+    it "should restrict single includes to the relevant classes" do
+      Alpha.should_receive(:find) do |type, options|
+        options[:include].should == :betas
+        [@alpha_a, @alpha_b]
+      end
+      
+      Beta.should_receive(:find) do |type, options|
+        options[:include].should be_nil
+        [@beta_a, @beta_b]
+      end
+      
+      ThinkingSphinx::Search.new(:include => :betas).first
+    end
+
+    it "should respect complex includes" do
+      Alpha.should_receive(:find) do |type, options|
+        options[:include].should == [:thetas, {:betas => :gammas}]
+        [@alpha_a, @alpha_b]
+      end
+
+      Beta.should_receive(:find) do |type, options|
+        options[:include].should be_nil
+        [@beta_a, @beta_b]
+      end
+
+      ThinkingSphinx::Search.new(:include => [:thetas, {:betas => :gammas}]).first
+    end
+    
+    it "should respect hash includes" do
+      Alpha.should_receive(:find) do |type, options|
+        options[:include].should == {:betas => :gammas}
+        [@alpha_a, @alpha_b]
+      end
+      
+      Beta.should_receive(:find) do |type, options|
+        options[:include].should be_nil
+        [@beta_a, @beta_b]
+      end
+      
+      ThinkingSphinx::Search.new(:include => {:betas => :gammas}).first
+    end
+    
+    it "should respect includes for single class searches" do
+      Alpha.should_receive(:find) do |type, options|
+        options[:include].should == {:betas => :gammas}
+        [@alpha_a, @alpha_b]
+      end
+      
+      ThinkingSphinx::Search.new(
+        :include => {:betas => :gammas},
+        :classes => [Alpha]
+      ).first
+    end
+    
+    describe 'query' do
+      it "should concatenate arguments with spaces" do
+        @client.should_receive(:query) do |query, index, comment|
+          query.should == 'two words'
+        end
+        
+        ThinkingSphinx::Search.new('two', 'words').first
+      end
+      
+      it "should append conditions to the query" do
+        @client.should_receive(:query) do |query, index, comment|
+          query.should == 'general @focused specific'
+        end
+        
+        ThinkingSphinx::Search.new('general', :conditions => {
+          :focused => 'specific'
+        }).first
+      end
+      
+      it "append multiple conditions together" do
+        @client.should_receive(:query) do |query, index, comment|
+          query.should match(/general.+@foo word/)
+          query.should match(/general.+@bar word/)
+        end
+        
+        ThinkingSphinx::Search.new('general', :conditions => {
+          :foo => 'word', :bar => 'word'
+        }).first
+      end
+      
+      it "should apply stars if requested, and handle full extended syntax" do
+        input    = %{a b* c (d | e) 123 5&6 (f_f g) !h "i j" "k l"~10 "m n"/3 @o p -(q|r)}
+        expected = %{*a* b* *c* (*d* | *e*) *123* *5*&*6* (*f_f* *g*) !*h* "i j" "k l"~10 "m n"/3 @o *p* -(*q*|*r*)}
+        
+        @client.should_receive(:query) do |query, index, comment|
+          query.should == expected
+        end
+        
+        ThinkingSphinx::Search.new(input, :star => true).first
+      end
+
+      it "should default to /\w+/ as token for auto-starring" do
+        @client.should_receive(:query) do |query, index, comment|
+          query.should == '*foo*@*bar*.*com*'
+        end
+        
+        ThinkingSphinx::Search.new('foo@bar.com', :star => true).first
+      end
+
+      it "should honour custom star tokens" do
+        @client.should_receive(:query) do |query, index, comment|
+          query.should == '*foo@bar.com* -*foo-bar*'
+        end
+        
+        ThinkingSphinx::Search.new(
+          'foo@bar.com -foo-bar', :star => /[\w@.-]+/u
+        ).first
+      end
+      
+      it "should ignore multi-field limitations" do
+        @client.should_receive(:query) do |query, index, comment|
+          query.should == '@(foo,bar) *baz*'
+        end
+        
+        ThinkingSphinx::Search.new('@(foo,bar) baz', :star => true).first
+      end
+      
+      it "should ignore multi-field limitations with spaces" do
+        @client.should_receive(:query) do |query, index, comment|
+          query.should == '@(foo bar) *baz*'
+        end
+        
+        ThinkingSphinx::Search.new('@(foo bar) baz', :star => true).first
+      end
+      
+      it "should ignore multi-field limitations in the middle of queries" do
+        @client.should_receive(:query) do |query, index, comment|
+          query.should == '*baz* @foo *bar* @(foo,bar) *baz*'
+        end
+        
+        ThinkingSphinx::Search.new(
+          'baz @foo bar @(foo,bar) baz', :star => true
+        ).first
+      end
+    end
+    
+    describe 'comment' do
+      it "should add comment if explicitly provided" do
+        @client.should_receive(:query) do |query, index, comment|
+          comment.should == 'custom log'
+        end
+        
+        ThinkingSphinx::Search.new(:comment => 'custom log').first
+      end
+      
+      it "should default to a blank comment" do
+        @client.should_receive(:query) do |query, index, comment|
+          comment.should == ''
+        end
+        
+        ThinkingSphinx::Search.new.first
+      end
+    end
+    
+    describe 'match mode' do
+      it "should default to :all" do
+        ThinkingSphinx::Search.new.first
+        
+        @client.match_mode.should == :all
+      end
+      
+      it "should default to :extended if conditions are supplied" do
+        ThinkingSphinx::Search.new('general', :conditions => {
+          :foo => 'word', :bar => 'word'
+        }).first
+        
+        @client.match_mode.should == :extended
+      end
+      
+      it "should use explicit match modes" do
+        ThinkingSphinx::Search.new('general', :conditions => {
+          :foo => 'word', :bar => 'word'
+        }, :match_mode => :extended2).first
+        
+        @client.match_mode.should == :extended2
+      end
+    end
+
+    describe 'sphinx_select' do
+      it "should default to *" do
+        ThinkingSphinx::Search.new.first
+        
+        @client.select.should == "*"
+      end
+      
+      it "should get set on the client if specified" do
+        ThinkingSphinx::Search.new('general',
+          :sphinx_select => "*, foo as bar"
+        ).first
+        
+        @client.select.should == "*, foo as bar"
+      end
+
+    end
+    
+    describe 'pagination' do
+      it "should set the limit using per_page" do
+        ThinkingSphinx::Search.new(:per_page => 30).first
+        @client.limit.should == 30
+      end
+      
+      it "should set the offset if pagination is requested" do
+        ThinkingSphinx::Search.new(:page => 3).first
+        @client.offset.should == 40
+      end
+      
+      it "should set the offset by the per_page value" do
+        ThinkingSphinx::Search.new(:page => 3, :per_page => 30).first
+        @client.offset.should == 60
+      end
+    end
+    
+    describe 'filters' do
+      it "should filter out deleted values by default" do
+        ThinkingSphinx::Search.new.first
+        
+        filter = @client.filters.last
+        filter.values.should == [0]
+        filter.attribute.should == 'sphinx_deleted'
+        filter.exclude?.should be_false
+      end
+      
+      it "should add class filters for explicit classes" do
+        ThinkingSphinx::Search.new(:classes => [Alpha, Beta]).first
+        
+        filter = @client.filters.last
+        filter.values.should == [Alpha.to_crc32, Beta.to_crc32]
+        filter.attribute.should == 'class_crc'
+        filter.exclude?.should be_false
+      end
+      
+      it "should add class filters for subclasses of requested classes" do
+        ThinkingSphinx::Search.new(:classes => [Person]).first
+        
+        filter = @client.filters.last
+        filter.values.should == [
+          Parent.to_crc32, Admin::Person.to_crc32,
+          Child.to_crc32, Person.to_crc32
+        ]
+        filter.attribute.should == 'class_crc'
+        filter.exclude?.should be_false
+      end
+      
+      it "should append inclusive filters of integers" do
+        ThinkingSphinx::Search.new(:with => {:int => 1}).first
+        
+        filter = @client.filters.last
+        filter.values.should    == [1]
+        filter.attribute.should == 'int'
+        filter.exclude?.should be_false
+      end
+      
+      it "should append inclusive filters of floats" do
+        ThinkingSphinx::Search.new(:with => {:float => 1.5}).first
+        
+        filter = @client.filters.last
+        filter.values.should    == [1.5]
+        filter.attribute.should == 'float'
+        filter.exclude?.should be_false
+      end
+      
+      it "should append inclusive filters of booleans" do
+        ThinkingSphinx::Search.new(:with => {:boolean => true}).first
+        
+        filter = @client.filters.last
+        filter.values.should    == [true]
+        filter.attribute.should == 'boolean'
+        filter.exclude?.should be_false
+      end
+      
+      it "should append inclusive filters of arrays" do
+        ThinkingSphinx::Search.new(:with => {:ints => [1, 2, 3]}).first
+        
+        filter = @client.filters.last
+        filter.values.should    == [1, 2, 3]
+        filter.attribute.should == 'ints'
+        filter.exclude?.should be_false
+      end
+      
+      it "should treat nils in arrays as 0" do
+        ThinkingSphinx::Search.new(:with => {:ints => [nil, 1, 2, 3]}).first
+        
+        filter = @client.filters.last
+        filter.values.should    == [0, 1, 2, 3]
+      end
+      
+      it "should append inclusive filters of time ranges" do
+        first, last = 1.week.ago, Time.now
+        ThinkingSphinx::Search.new(:with => {
+          :time => first..last
+        }).first
+        
+        filter = @client.filters.last
+        filter.values.should    == (first.to_i..last.to_i)
+        filter.attribute.should == 'time'
+        filter.exclude?.should be_false
+      end
+      
+      it "should append exclusive filters of integers" do
+        ThinkingSphinx::Search.new(:without => {:int => 1}).first
+        
+        filter = @client.filters.last
+        filter.values.should    == [1]
+        filter.attribute.should == 'int'
+        filter.exclude?.should be_true
+      end
+      
+      it "should append exclusive filters of floats" do
+        ThinkingSphinx::Search.new(:without => {:float => 1.5}).first
+        
+        filter = @client.filters.last
+        filter.values.should    == [1.5]
+        filter.attribute.should == 'float'
+        filter.exclude?.should be_true
+      end
+      
+      it "should append exclusive filters of booleans" do
+        ThinkingSphinx::Search.new(:without => {:boolean => true}).first
+        
+        filter = @client.filters.last
+        filter.values.should    == [true]
+        filter.attribute.should == 'boolean'
+        filter.exclude?.should be_true
+      end
+      
+      it "should append exclusive filters of arrays" do
+        ThinkingSphinx::Search.new(:without => {:ints => [1, 2, 3]}).first
+        
+        filter = @client.filters.last
+        filter.values.should    == [1, 2, 3]
+        filter.attribute.should == 'ints'
+        filter.exclude?.should be_true
+      end
+      
+      it "should append exclusive filters of time ranges" do
+        first, last = 1.week.ago, Time.now
+        ThinkingSphinx::Search.new(:without => {
+          :time => first..last
+        }).first
+        
+        filter = @client.filters.last
+        filter.values.should    == (first.to_i..last.to_i)
+        filter.attribute.should == 'time'
+        filter.exclude?.should be_true
+      end
+      
+      it "should add separate filters for each item in a with_all value" do
+        ThinkingSphinx::Search.new(:with_all => {:ints => [1, 2, 3]}).first
+        
+        filters = @client.filters[-3, 3]
+        filters.each do |filter|
+          filter.attribute.should == 'ints'
+          filter.exclude?.should be_false
+        end
+        
+        filters[0].values.should == [1]
+        filters[1].values.should == [2]
+        filters[2].values.should == [3]
+      end
+      
+      it "should filter out specific ids using :without_ids" do
+        ThinkingSphinx::Search.new(:without_ids => [4, 5, 6]).first
+        
+        filter = @client.filters.last
+        filter.values.should    == [4, 5, 6]
+        filter.attribute.should == 'sphinx_internal_id'
+        filter.exclude?.should be_true
+      end
+    end
+    
+    describe 'sort mode' do
+      it "should use :relevance as a default" do
+        ThinkingSphinx::Search.new.first
+        @client.sort_mode.should == :relevance
+      end
+
+      it "should use :attr_asc if a symbol is supplied to :order" do
+        ThinkingSphinx::Search.new(:order => :created_at).first
+        @client.sort_mode.should == :attr_asc
+      end
+
+      it "should use :attr_desc if :desc is the mode" do
+        ThinkingSphinx::Search.new(
+          :order => :created_at, :sort_mode => :desc
+        ).first
+        @client.sort_mode.should == :attr_desc
+      end
+
+      it "should use :extended if a string is supplied to :order" do
+        ThinkingSphinx::Search.new(:order => "created_at ASC").first
+        @client.sort_mode.should == :extended
+      end
+
+      it "should use :expr if explicitly requested" do
+        ThinkingSphinx::Search.new(
+          :order => "created_at ASC", :sort_mode => :expr
+        ).first
+        @client.sort_mode.should == :expr
+      end
+
+      it "should use :attr_desc if explicitly requested" do
+        ThinkingSphinx::Search.new(
+          :order => "created_at", :sort_mode => :desc
+        ).first
+        @client.sort_mode.should == :attr_desc
+      end
+    end
+    
+    describe 'sort by' do
+      it "should presume order symbols are attributes" do
+        ThinkingSphinx::Search.new(:order => :created_at).first
+        @client.sort_by.should == 'created_at'
+      end
+      
+      it "replace field names with their sortable attributes" do
+        ThinkingSphinx::Search.new(:order => :name, :classes => [Alpha]).first
+        @client.sort_by.should == 'name_sort'
+      end
+      
+      it "should replace field names in strings" do
+        ThinkingSphinx::Search.new(
+          :order => "created_at ASC, name DESC", :classes => [Alpha]
+        ).first
+        @client.sort_by.should == 'created_at ASC, name_sort DESC'
+      end
+    end
+    
+    describe 'max matches' do
+      it "should use the global setting by default" do
+        ThinkingSphinx::Search.new.first
+        @client.max_matches.should == 1000
+      end
+      
+      it "should use explicit setting" do
+        ThinkingSphinx::Search.new(:max_matches => 2000).first
+        @client.max_matches.should == 2000
+      end
+    end
+    
+    describe 'field weights' do
+      it "should set field weights as provided" do
+        ThinkingSphinx::Search.new(
+          :field_weights => {'foo' => 10, 'bar' => 5}
+        ).first
+        
+        @client.field_weights.should == {
+          'foo' => 10, 'bar' => 5
+        }
+      end
+      
+      it "should use field weights set in the index" do
+        ThinkingSphinx::Search.new(:classes => [Alpha]).first
+        
+        @client.field_weights.should == {'name' => 10}
+      end
+    end
+    
+    describe 'index weights' do
+      it "should send index weights through to the client" do
+        ThinkingSphinx::Search.new(:index_weights => {'foo' => 100}).first
+        @client.index_weights.should == {'foo' => 100}
+      end
+      
+      it "should convert classes to their core and delta index names" do
+        ThinkingSphinx::Search.new(:index_weights => {Alpha => 100}).first
+        @client.index_weights.should == {
+          'alpha_core'  => 100,
+          'alpha_delta' => 100
+        }
+      end
+    end
+    
+    describe 'grouping' do
+      it "should convert group into group_by and group_function" do
+        ThinkingSphinx::Search.new(:group => :edition).first
+        
+        @client.group_function.should == :attr
+        @client.group_by.should == "edition"
+      end
+      
+      it "should pass on explicit grouping arguments" do
+        ThinkingSphinx::Search.new(
+          :group_by       => 'created_at',
+          :group_function => :attr,
+          :group_clause   => 'clause',
+          :group_distinct => 'distinct'
+        ).first
+        
+        @client.group_by.should       == 'created_at'
+        @client.group_function.should == :attr
+        @client.group_clause.should   == 'clause'
+        @client.group_distinct.should == 'distinct'
+      end
+    end
+    
+    describe 'anchor' do
+      it "should detect lat and lng attributes on the given model" do
+        ThinkingSphinx::Search.new(
+          :geo     => [1.0, -1.0],
+          :classes => [Alpha]
+        ).first
+        
+        @client.anchor[:latitude_attribute].should == 'lat'
+        @client.anchor[:longitude_attribute].should == 'lng'
+      end
+      
+      it "should detect lat and lon attributes on the given model" do
+        ThinkingSphinx::Search.new(
+          :geo     => [1.0, -1.0],
+          :classes => [Beta]
+        ).first
+        
+        @client.anchor[:latitude_attribute].should == 'lat'
+        @client.anchor[:longitude_attribute].should == 'lon'
+      end
+      
+      it "should detect latitude and longitude attributes on the given model" do
+        ThinkingSphinx::Search.new(
+          :geo     => [1.0, -1.0],
+          :classes => [Person]
+        ).first
+        
+        @client.anchor[:latitude_attribute].should == 'latitude'
+        @client.anchor[:longitude_attribute].should == 'longitude'
+      end
+      
+      it "should accept manually defined latitude and longitude attributes" do
+        ThinkingSphinx::Search.new(
+          :geo            => [1.0, -1.0],
+          :classes        => [Alpha],
+          :latitude_attr  => :updown,
+          :longitude_attr => :leftright
+        ).first
+        
+        @client.anchor[:latitude_attribute].should == 'updown'
+        @client.anchor[:longitude_attribute].should == 'leftright'
+      end
+      
+      it "should accept manually defined latitude and longitude attributes in the given model" do
+        ThinkingSphinx::Search.new(
+          :geo     => [1.0, -1.0],
+          :classes => [Friendship]
+        ).first
+        
+        @client.anchor[:latitude_attribute].should == 'person_id'
+        @client.anchor[:longitude_attribute].should == 'person_id'
+      end
+      
+      it "should accept geo array for geo-position values" do
+        ThinkingSphinx::Search.new(
+          :geo     => [1.0, -1.0],
+          :classes => [Alpha]
+        ).first
+        
+        @client.anchor[:latitude].should == 1.0
+        @client.anchor[:longitude].should == -1.0
+      end
+      
+      it "should accept lat and lng options for geo-position values" do
+        ThinkingSphinx::Search.new(
+          :lat     => 1.0,
+          :lng     => -1.0,
+          :classes => [Alpha]
+        ).first
+        
+        @client.anchor[:latitude].should == 1.0
+        @client.anchor[:longitude].should == -1.0
+      end
+    end
+    
+    describe 'sql ordering' do
+      before :each do
+        @client.stub! :query => {
+          :matches => minimal_result_hashes(@alpha_b, @alpha_a)
+        }
+        Alpha.stub! :find => [@alpha_a, @alpha_b]
+      end
+      
+      it "shouldn't re-sort SQL results based on Sphinx information" do
+        search = ThinkingSphinx::Search.new(
+          :classes    => [Alpha],
+          :sql_order  => 'id'
+        )
+        search.first.should == @alpha_a
+        search.last.should  == @alpha_b
+      end
+      
+      it "should use the option for the ActiveRecord::Base#find calls" do
+        Alpha.should_receive(:find) do |mode, options|
+          options[:order].should == 'id'
+        end
+        
+        ThinkingSphinx::Search.new(
+          :classes    => [Alpha],
+          :sql_order  => 'id'
+        ).first
+      end
+    end
+    
+    describe ':only option' do
+      it "returns the requested attribute as an array" do
+        ThinkingSphinx::Search.new(:only => :class_crc).first.
+          should == Alpha.to_crc32
+      end
+      
+      it "returns multiple attributes as hashes with values" do
+        ThinkingSphinx::Search.new(
+          :only => [:class_crc, :sphinx_internal_id]
+        ).first.should == {
+          :class_crc          => Alpha.to_crc32,
+          :sphinx_internal_id => @alpha_a.id
+        }
+      end
+      
+      it "handles strings for a single attribute name" do
+        ThinkingSphinx::Search.new(:only => 'class_crc').first.
+          should == Alpha.to_crc32
+      end
+      
+      it "handles strings for multiple attribute names" do
+        ThinkingSphinx::Search.new(
+          :only => ['class_crc', 'sphinx_internal_id']
+        ).first.should == {
+          :class_crc          => Alpha.to_crc32,
+          :sphinx_internal_id => @alpha_a.id
+        }
+      end
+    end
+    
+    context 'result objects' do
+      describe '#excerpts' do
+        before :each do
+          @search = ThinkingSphinx::Search.new
+        end
+      
+        it "should add excerpts method if objects don't already have one" do
+          @search.first.should respond_to(:excerpts)
+        end
+      
+        it "should return an instance of ThinkingSphinx::Excerpter" do
+          @search.first.excerpts.should be_a(ThinkingSphinx::Excerpter)
+        end
+      
+        it "should not add excerpts method if objects already have one" do
+          @search.last.excerpts.should_not be_a(ThinkingSphinx::Excerpter)
+        end
+        
+        # Fails in Ruby 1.9 (or maybe it's an RSpec update). Not sure why.
+        it "should set up the excerpter with the instances and search" do
+          [@alpha_a, @beta_b, @alpha_b, @beta_a].each do |object|
+            ThinkingSphinx::Excerpter.should_receive(:new).with(@search, object)
+          end
+          
+          @search.first
+        end
+      end
+    
+      describe '#sphinx_attributes' do
+        before :each do
+          @search = ThinkingSphinx::Search.new
+        end
+        
+        it "should add sphinx_attributes method if objects don't already have one" do
+          @search.last.should respond_to(:sphinx_attributes)
+        end
+        
+        it "should return a hash" do
+          @search.last.sphinx_attributes.should be_a(Hash)
+        end
+        
+        it "should not add sphinx_attributes if objects have a method of that name already" do
+          @search.first.sphinx_attributes.should_not be_a(Hash)
+        end
+        
+        it "should pair sphinx_attributes with the correct hash" do
+          hash = @search.last.sphinx_attributes
+          hash['sphinx_internal_id'].should == @search.last.id
+          hash['class_crc'].should == @search.last.class.to_crc32
+        end
+      end
+      
+      describe '#matching_fields' do
+        it "should add matching_fields method if using fieldmask ranking mode" do
+          search = ThinkingSphinx::Search.new :rank_mode => :fieldmask
+          search.first.should respond_to(:matching_fields)
+        end
+        
+        it "should not add matching_fields method if object already have one" do
+          search = ThinkingSphinx::Search.new :rank_mode => :fieldmask
+          search.last.matching_fields.should_not be_an(Array)
+        end
+        
+        it "should return an array" do
+          search = ThinkingSphinx::Search.new :rank_mode => :fieldmask
+          search.first.matching_fields.should be_an(Array)
+        end
+        
+        it "should return the fields that the bitmask match" do
+          search = ThinkingSphinx::Search.new :rank_mode => :fieldmask
+          search.first.matching_fields.should == ['one', 'three', 'five']
+        end
+      end
+    end
+    
+    context 'Sphinx errors' do
+      describe '#error?' do
+        before :each do
+          @client.stub! :query => {
+            :error => @warning = "Not good"
+          }
+          # @search.should_receive(:error).and_return(nil)
+        end
+        it "should raise an error" do
+          lambda{
+            ThinkingSphinx::Search.new.first
+          }.should raise_error(ThinkingSphinx::SphinxError)
+        end
+        it "should not raise an error when ignore_errors is true" do
+          lambda{
+            ThinkingSphinx::Search.new(:ignore_errors => true).first
+          }.should_not raise_error(ThinkingSphinx::SphinxError)
+        end
+      end
+    end
+  end
+  
+  describe '#current_page' do
+    it "should return 1 by default" do
+      ThinkingSphinx::Search.new.current_page.should == 1
+    end
+    
+    it "should handle string page values" do
+      ThinkingSphinx::Search.new(:page => '2').current_page.should == 2
+    end
+    
+    it "should handle empty string page values" do
+      ThinkingSphinx::Search.new(:page => '').current_page.should == 1
+    end
+    
+    it "should return the requested page" do
+      ThinkingSphinx::Search.new(:page => 10).current_page.should == 10
+    end
+  end
+  
+  describe '#per_page' do
+    it "should return 20 by default" do
+      ThinkingSphinx::Search.new.per_page.should == 20
+    end
+    
+    it "should allow for custom values" do
+      ThinkingSphinx::Search.new(:per_page => 30).per_page.should == 30
+    end
+    
+    it "should prioritise :limit over :per_page if given" do
+      ThinkingSphinx::Search.new(
+        :per_page => 30, :limit => 40
+      ).per_page.should == 40
+    end
+    
+    it "should allow for string arguments" do
+      ThinkingSphinx::Search.new(:per_page => '10').per_page.should == 10
+    end
+  end
+  
+  describe '#total_pages' do
+    it "should calculate the total pages depending on per_page and total_entries" do
+      ThinkingSphinx::Search.new.total_pages.should == 3
+    end
+    
+    it "should allow for custom per_page values" do
+      ThinkingSphinx::Search.new(:per_page => 30).total_pages.should == 2
+    end
+    
+    it "should not overstep the max_matches implied limit" do
+      @client.stub!(:query => {
+        :matches => [], :total_found => 41, :total => 40
+      })
+      
+      ThinkingSphinx::Search.new.total_pages.should == 2
+    end
+    
+    it "should return 0 if there is no index and therefore no results" do
+      @client.stub!(:query => {
+        :matches => [], :total_found => nil, :total => nil
+      })
+      
+      ThinkingSphinx::Search.new.total_pages.should == 0
+    end
+  end
+  
+  describe '#next_page' do
+    it "should return one more than the current page" do
+      ThinkingSphinx::Search.new.next_page.should == 2
+    end
+    
+    it "should return nil if on the last page" do
+      ThinkingSphinx::Search.new(:page => 3).next_page.should be_nil
+    end
+  end
+  
+  describe '#previous_page' do
+    it "should return one less than the current page" do
+      ThinkingSphinx::Search.new(:page => 2).previous_page.should == 1
+    end
+    
+    it "should return nil if on the first page" do
+      ThinkingSphinx::Search.new.previous_page.should be_nil
+    end
+  end
+  
+  describe '#total_entries' do
+    it "should return the total number of results, not just the amount on the page" do
+      ThinkingSphinx::Search.new.total_entries.should == 41
+    end
+    
+    it "should return 0 if there is no index and therefore no results" do
+      @client.stub!(:query => {
+        :matches => [], :total_found => nil
+      })
+      
+      ThinkingSphinx::Search.new.total_entries.should == 0
+    end
+  end
+  
+  describe '#offset' do
+    it "should default to 0" do
+      ThinkingSphinx::Search.new.offset.should == 0
+    end
+    
+    it "should increase by the per_page value for each page in" do
+      ThinkingSphinx::Search.new(:per_page => 25, :page => 2).offset.should == 25
+    end
+
+    it "should prioritise explicit :offset over calculated if given" do
+      ThinkingSphinx::Search.new(:offset => 5).offset.should == 5
+    end
+  end
+  
+  describe '#indexes' do
+    it "should default to '*'" do
+      ThinkingSphinx::Search.new.indexes.should == '*'
+    end
+    
+    it "should use given class to determine index name" do
+      ThinkingSphinx::Search.new(:classes => [Alpha]).indexes.
+        should == 'alpha_core'
+    end
+    
+    it "should add both core and delta indexes for given classes" do
+      ThinkingSphinx::Search.new(:classes => [Alpha, Beta]).indexes.
+        should == 'alpha_core,beta_core,beta_delta'
+    end
+    
+    it "should respect the :index option" do
+      ThinkingSphinx::Search.new(:classes => [Alpha], :index => '*').indexes.
+        should == '*'
+    end
+  end
+  
+  describe '.each_with_groupby_and_count' do
+    before :each do
+      @alpha = Alpha.new
+      @alpha.stub!(:id => 1, :read_attribute => 1)
+      
+      @client.stub! :query => {
+        :matches => [{
+          :attributes => {
+            'sphinx_internal_id' => @alpha.id,
+            'class_crc'          => Alpha.to_crc32,
+            '@groupby'           => 101,
+            '@count'             => 5
+          }
+        }]
+      }
+      Alpha.stub!(:find => [@alpha])
+    end
+    
+    it "should yield the match, group and count" do
+      search = ThinkingSphinx::Search.new
+      search.each_with_groupby_and_count do |obj, group, count|
+        obj.should    == @alpha
+        group.should  == 101
+        count.should  == 5
+      end
+    end
+    
+    it "should be aliased to each_with_group_and_count" do
+      search = ThinkingSphinx::Search.new
+      search.each_with_group_and_count do |obj, group, count|
+        obj.should    == @alpha
+        group.should  == 101
+        count.should  == 5
+      end
+    end
+  end
+  
+  describe '.each_with_weighting' do
+    before :each do
+      @alpha = Alpha.new
+      @alpha.stub!(:id => 1, :read_attribute => 1)
+      
+      @client.stub! :query => {
+        :matches => [{
+          :attributes => {
+            'sphinx_internal_id' => @alpha.id,
+            'class_crc'          => Alpha.to_crc32
+          }, :weight => 12
+        }]
+      }
+      Alpha.stub!(:find => [@alpha])
+    end
+    
+    it "should yield the match and weight" do
+      search = ThinkingSphinx::Search.new
+      search.each_with_weighting do |obj, weight|
+        obj.should    == @alpha
+        weight.should == 12
+      end
+    end
+  end
+  
+  describe '.each_with_*' do
+    before :each do
+      @alpha = Alpha.new
+      @alpha.stub!(:id => 1, :read_attribute => 1)
+      
+      @client.stub! :query => {
+        :matches => [{
+          :attributes => {
+            'sphinx_internal_id' => @alpha.id,
+            'class_crc'          => Alpha.to_crc32,
+            '@geodist'           => 101,
+            '@groupby'           => 102,
+            '@count'             => 103
+          }, :weight => 12
+        }]
+      }
+      Alpha.stub!(:find => [@alpha])
+      
+      @search = ThinkingSphinx::Search.new
+    end
+    
+    it "should yield geodist if requested" do
+      @search.each_with_geodist do |obj, distance|
+        obj.should      == @alpha
+        distance.should == 101
+      end
+    end
+    
+    it "should yield count if requested" do
+      @search.each_with_count do |obj, count|
+        obj.should    == @alpha
+        count.should  == 103
+      end
+    end
+    
+    it "should yield groupby if requested" do
+      @search.each_with_groupby do |obj, group|
+        obj.should    == @alpha
+        group.should  == 102
+      end
+    end
+    
+    it "should still use the array's each_with_index" do
+      @search.each_with_index do |obj, index|
+        obj.should   == @alpha
+        index.should == 0
+      end
+    end
+  end
+  
+  describe '#excerpt_for' do
+    before :each do
+      @client.stub!(:excerpts => ['excerpted string'])
+      @client.stub!(:query => {
+        :matches => [],
+        :words => {'one' => {}, 'two' => {}}
+      })
+      @search = ThinkingSphinx::Search.new(:classes => [Alpha])
+    end
+    
+    it "should return the Sphinx excerpt value" do
+      @search.excerpt_for('string').should == 'excerpted string'
+    end
+    
+    it "should use the given model's core index" do
+      @client.should_receive(:excerpts) do |options|
+        options[:index].should == 'alpha_core'
+      end
+      
+      @search.excerpt_for('string')
+    end
+    
+    it "should respect the provided index option" do
+      @search = ThinkingSphinx::Search.new(:classes => [Alpha], :index => 'foo')
+      @client.should_receive(:excerpts) do |options|
+        options[:index].should == 'foo'
+      end
+      
+      @search.excerpt_for('string')
+    end
+    
+    it "should optionally take a second argument to allow for multi-model searches" do
+      @client.should_receive(:excerpts) do |options|
+        options[:index].should == 'beta_core'
+      end
+      
+      @search.excerpt_for('string', Beta)
+    end
+    
+    it "should join the words together" do
+      @client.should_receive(:excerpts) do |options|
+        options[:words].should == @search.results[:words].keys.join(' ')
+      end
+      
+      @search.excerpt_for('string', Beta)
+    end
+    
+    it "should use the correct index in STI situations" do
+      @client.should_receive(:excerpts) do |options|
+        options[:index].should == 'person_core'
+      end
+      
+      @search.excerpt_for('string', Parent)
+    end
+  end
+  
+  describe '#search' do
+    before :each do
+      @search = ThinkingSphinx::Search.new('word',
+        :conditions => {:field  => 'field'},
+        :with       => {:int    => 5}
+      )
+    end
+    
+    it "should return itself" do
+      @search.search.object_id.should == @search.object_id
+    end
+    
+    it "should merge in arguments" do
+      @client.should_receive(:query) do |query, index, comments|
+        query.should == 'word more @field field'
+      end
+      
+      @search.search('more').first
+    end
+    
+    it "should merge conditions" do
+      @client.should_receive(:query) do |query, index, comments|
+        query.should match(/@name plato/)
+        query.should match(/@field field/)
+      end
+      
+      @search.search(:conditions => {:name => 'plato'}).first
+    end
+    
+    it "should merge filters" do
+      @search.search(:with => {:float => 1.5}).first
+      
+      @client.filters.detect { |filter|
+        filter.attribute == 'float'
+      }.should_not be_nil
+      @client.filters.detect { |filter|
+        filter.attribute == 'int'
+      }.should_not be_nil
+    end
+  end
+  
+  describe '#freeze' do
+    before :each do
+      @search = ThinkingSphinx::Search.new
+    end
+    
+    it "should populate the result set" do
+      @search.freeze
+      @search.should be_populated
+    end
+    
+    it "should freeze the underlying array" do
+      @search.freeze
+      @search.to_a.should be_frozen
+    end
+    
+    it "should return the Search object" do
+      @search.freeze.should be_a(ThinkingSphinx::Search)
+    end
+  end
+  
+  describe '#client' do
+    let(:client) { Riddle::Client.new }
+    it "should respect the client in options" do
+      search = ThinkingSphinx::Search.new :client => client
+      search.client.should == client
+    end
+    
+    it "should get a new client from the configuration singleton by default" do
+      ThinkingSphinx::Configuration.instance.stub!(:client => client)
+      ThinkingSphinx::Search.new.client.should == client
+    end
+  end
+end
+
+describe ThinkingSphinx::Search, "playing nice with Search model" do
+  it "should not conflict with models called Search" do
+    lambda { Search.find(:all) }.should_not raise_error
+  end
+end