sunspot_rails 2.0.0.pre.120720 → 2.0.0.pre.120924

data/sunspot/spec/api/query/scope_examples.rb

@@ -0,0 +1,275 @@
+shared_examples_for "scoped query" do
+  it 'scopes by exact match with a string' do
+    search do
+      with :title, 'My Pet Post'
+    end
+    connection.should have_last_search_including(:fq, 'title_ss:My\ Pet\ Post')
+  end
+
+  it 'scopes by exact match with a special string' do
+    search do
+      with :title, 'OR'
+    end
+    connection.should have_last_search_including(:fq, 'title_ss:"OR"')
+  end
+
+  it 'scopes by exact match with time' do
+    time = Time.parse('1983-07-08 05:00:00 -0400')
+    search do
+      with :published_at, time
+    end
+    connection.should have_last_search_including(
+      :fq,
+      'published_at_dt:1983\-07\-08T09\:00\:00Z'
+    )
+  end
+
+  it 'scopes by exact match with date' do
+    date = Date.new(1983, 7, 8)
+    search do
+      with :expire_date, date
+    end
+    connection.should have_last_search_including(
+      :fq,
+      'expire_date_d:1983\-07\-08T00\:00\:00Z'
+    )
+  end
+  
+  it 'scopes by exact match with boolean' do
+    search do
+      with :featured, false
+    end
+    connection.should have_last_search_including(:fq, 'featured_bs:false')
+  end
+
+  it 'scopes by less than match with float' do
+    search do
+      with(:average_rating).less_than 3.0
+    end
+    connection.should have_last_search_including(:fq, 'average_rating_ft:{* TO 3\.0}')
+  end
+
+  it 'should quote string with space in a less than match' do
+    search do
+      with(:title).less_than('test value')
+    end
+    connection.should have_last_search_including(:fq, 'title_ss:{* TO "test\ value"}')
+  end
+
+  it 'scopes by greater than match with float' do
+    search do
+      with(:average_rating).greater_than 3.0
+    end
+    connection.should have_last_search_including(:fq, 'average_rating_ft:{3\.0 TO *}')
+  end
+
+  it 'scopes by short-form between match with integers' do
+    search do
+      with :blog_id, 2..4
+    end
+    connection.should have_last_search_including(:fq, 'blog_id_i:[2 TO 4]')
+  end
+
+  it 'scopes by between match with float' do
+    search do
+      with(:average_rating).between 2.0..4.0
+    end
+    connection.should have_last_search_including(:fq, 'average_rating_ft:[2\.0 TO 4\.0]')
+  end
+
+  it 'scopes by any match with integer' do
+    search do
+      with(:category_ids).any_of [2, 7, 12]
+    end
+    connection.should have_last_search_including(:fq, 'category_ids_im:(2 OR 7 OR 12)')
+  end
+
+  it 'scopes by short-form any-of match with integers' do
+    search do
+      with :category_ids, [2, 7, 12]
+    end
+    connection.should have_last_search_including(:fq, 'category_ids_im:(2 OR 7 OR 12)')
+  end
+
+  it 'scopes by all match with integer' do
+    search do
+      with(:category_ids).all_of [2, 7, 12]
+    end
+    connection.should have_last_search_including(:fq, 'category_ids_im:(2 AND 7 AND 12)')
+  end
+
+  it 'scopes by prefix match with string' do
+    search do
+      with(:title).starting_with('tes')
+    end
+    connection.should have_last_search_including(:fq, 'title_ss:tes*')
+  end
+
+  it 'scopes by not equal match with string' do
+    search do
+      without :title, 'Bad Post'
+    end
+    connection.should have_last_search_including(:fq, '-title_ss:Bad\ Post')
+  end
+
+  it 'scopes by not less than match with float' do
+    search do
+      without(:average_rating).less_than 3.0
+    end
+    connection.should have_last_search_including(:fq, '-average_rating_ft:{* TO 3\.0}')
+  end
+
+  it 'scopes by not greater than match with float' do
+    search do
+      without(:average_rating).greater_than 3.0
+    end
+    connection.should have_last_search_including(:fq, '-average_rating_ft:{3\.0 TO *}')
+  end
+  
+  it 'scopes by not between match with shorthand' do
+    search do
+      without(:blog_id, 2..4)
+    end
+    connection.should have_last_search_including(:fq, '-blog_id_i:[2 TO 4]')
+  end
+
+  it 'scopes by not between match with float' do
+    search do
+      without(:average_rating).between 2.0..4.0
+    end
+    connection.should have_last_search_including(:fq, '-average_rating_ft:[2\.0 TO 4\.0]')
+  end
+
+  it 'scopes by not any match with integer' do
+    search do
+      without(:category_ids).any_of [2, 7, 12]
+    end
+    connection.should have_last_search_including(:fq, '-category_ids_im:(2 OR 7 OR 12)')
+  end
+
+  it 'scopes by not all match with integer' do
+    search do
+      without(:category_ids).all_of [2, 7, 12]
+    end
+    connection.should have_last_search_including(:fq, '-category_ids_im:(2 AND 7 AND 12)')
+  end
+
+  it 'scopes by empty field' do
+    search do
+      with :average_rating, nil
+    end
+    connection.should have_last_search_including(:fq, '-average_rating_ft:[* TO *]')
+  end
+
+  it 'scopes by non-empty field' do
+    search do
+      without :average_rating, nil
+    end
+    connection.should have_last_search_including(:fq, 'average_rating_ft:[* TO *]')
+  end
+
+  it 'includes by object identity' do
+    post = Post.new
+    search do
+      with post
+    end
+    connection.should have_last_search_including(:fq, "id:(Post\\ #{post.id})")
+  end
+
+  it 'includes multiple objects passed as varargs by object identity' do
+    post1, post2 = Post.new, Post.new
+    search do
+      with post1, post2
+    end
+    connection.should have_last_search_including(
+      :fq, "id:(Post\\ #{post1.id} OR Post\\ #{post2.id})"
+    )
+  end
+
+  it 'includes multiple objects passed as array by object identity' do
+    posts = [Post.new, Post.new]
+    search do
+      with posts
+    end
+    connection.should have_last_search_including(
+      :fq, "id:(Post\\ #{posts.first.id} OR Post\\ #{posts.last.id})"
+    )
+  end
+
+  it 'excludes by object identity' do
+    post = Post.new
+    search do
+      without post
+    end
+    connection.should have_last_search_including(:fq, "-id:(Post\\ #{post.id})")
+  end
+
+  it 'excludes multiple objects passed as varargs by object identity' do
+    post1, post2 = Post.new, Post.new
+    search do
+      without post1, post2
+    end
+    connection.should have_last_search_including(
+      :fq,
+      "-id:(Post\\ #{post1.id} OR Post\\ #{post2.id})"
+    )
+  end
+
+  it 'excludes multiple objects passed as array by object identity' do
+    posts = [Post.new, Post.new]
+    search do
+      without posts
+    end
+    connection.should have_last_search_including(
+      :fq,
+      "-id:(Post\\ #{posts.first.id} OR Post\\ #{posts.last.id})"
+    )
+  end
+
+  it 'allows scoping on fields common to all types' do
+    time = Time.parse('1983-07-08 05:00:00 -0400')
+    search Post, Namespaced::Comment do
+      with :published_at, time
+    end
+    connection.should have_last_search_including(:fq, 'published_at_dt:1983\-07\-08T09\:00\:00Z')
+  end
+
+  it 'allows scoping on field not common to all types' do
+    search Post, Namespaced::Comment do
+      with :blog_id, 1
+    end
+    connection.should have_last_search_including(:fq, 'blog_id_i:1')
+  end
+
+  it 'raises Sunspot::UnrecognizedFieldError if search scoped to field configured differently between types' do
+    lambda do
+      search Post, Namespaced::Comment do
+        with :average_rating, 2.2 # this is a float in Post but an integer in Comment
+      end
+    end.should raise_error(Sunspot::UnrecognizedFieldError)
+  end
+
+  it 'raises Sunspot::UnrecognizedFieldError for nonexistant fields in block scope' do
+    lambda do
+      search do
+        with :bogus, 'Field'
+      end
+    end.should raise_error(Sunspot::UnrecognizedFieldError)
+  end
+
+  it 'raises NoMethodError if bogus operator referenced' do
+    lambda do
+      search do
+        with(:category_ids).resembling :bogus_condition
+      end
+    end.should raise_error(NoMethodError)
+  end
+
+  it 'should raise ArgumentError if more than two arguments passed to scope method' do
+    lambda do
+      search do
+        with(:category_ids, 4, 5)
+      end
+    end.should raise_error(ArgumentError)
+  end
+end

data/sunspot/spec/api/query/spatial_examples.rb

@@ -0,0 +1,27 @@
+require 'bigdecimal'
+
+shared_examples_for "spatial query" do
+  it 'filters by radius' do
+    search do
+      with(:coordinates_new).in_radius(23, -46, 100)
+    end
+
+    connection.should have_last_search_including(:fq, "{!geofilt sfield=coordinates_new_ll pt=23,-46 d=100}")
+  end
+
+  it 'filters by radius via bbox (inexact)' do
+    search do
+      with(:coordinates_new).in_radius(23, -46, 100, :bbox => true)
+    end
+
+    connection.should have_last_search_including(:fq, "{!bbox sfield=coordinates_new_ll pt=23,-46 d=100}")
+  end
+
+  it 'filters by bounding box' do
+    search do
+      with(:coordinates_new).in_bounding_box([45, -94], [46, -93])
+    end
+
+    connection.should have_last_search_including(:fq, "coordinates_new_ll:[45,-94 TO 46,-93]")
+  end
+end

data/sunspot/spec/api/query/spec_helper.rb

@@ -0,0 +1 @@
+require File.expand_path('spec_helper', File.join(File.dirname(__FILE__), '..'))

data/sunspot/spec/api/query/standard_spec.rb

@@ -0,0 +1,29 @@
+require File.expand_path('spec_helper', File.dirname(__FILE__))
+
+describe 'standard query', :type => :query do
+  it_should_behave_like "scoped query"
+  it_should_behave_like "query with advanced manipulation"
+  it_should_behave_like "query with connective scope"
+  it_should_behave_like "query with dynamic field support"
+  it_should_behave_like "facetable query"
+  it_should_behave_like "fulltext query"
+  it_should_behave_like "query with highlighting support"
+  it_should_behave_like "sortable query"
+  it_should_behave_like "query with text field scoping"
+  it_should_behave_like "geohash query"
+  it_should_behave_like "spatial query"
+
+  it 'adds a no-op query to :q parameter when no :q provided' do
+    session.search Post do
+      with :title, 'My Pet Post'
+    end
+    connection.should have_last_search_with(:q => '*:*')
+  end
+
+  private
+
+  def search(*classes, &block)
+    classes[0] ||= Post
+    session.search(*classes, &block)
+  end
+end

data/sunspot/spec/api/query/text_field_scoping_examples.rb

@@ -0,0 +1,30 @@
+shared_examples_for 'query with text field scoping' do
+  it 'should scope with a text field' do
+    search do
+      text_fields do
+        with(:body, 'test')
+      end
+    end
+    connection.should have_last_search_including(:fq, 'body_textsv:test')
+  end
+
+  it 'should raise an UnrecognizedFieldError if differently configured text field is used' do
+    lambda do
+      search(Post, Namespaced::Comment) do
+        text_fields do
+          with(:body, 'test')
+        end
+      end
+    end.should raise_error(Sunspot::UnrecognizedFieldError)
+  end
+
+  it 'should raise an UnrecognizedFieldError if no field exists' do
+    lambda do
+      search do
+        text_fields do
+          with(:bogus, 'test')
+        end
+      end
+    end.should raise_error(Sunspot::UnrecognizedFieldError)
+  end
+end

data/sunspot/spec/api/query/types_spec.rb

@@ -0,0 +1,20 @@
+describe 'typed query' do
+  it 'properly escapes namespaced type names' do
+    session.search(Namespaced::Comment)
+    connection.should have_last_search_with(:fq => ['type:Namespaced\:\:Comment'])
+  end
+
+  it 'builds search for multiple types' do
+    session.search(Post, Namespaced::Comment)
+    connection.should have_last_search_with(:fq => ['type:(Post OR Namespaced\:\:Comment)'])
+  end
+
+  it 'searches type of subclass when superclass is configured' do
+    session.search PhotoPost
+    connection.should have_last_search_with(:fq => ['type:PhotoPost'])
+  end
+
+  it 'raises an ArgumentError if no types given to search' do
+    lambda { session.search }.should raise_error(ArgumentError)
+  end
+end

data/sunspot/spec/api/search/dynamic_fields_spec.rb

@@ -0,0 +1,33 @@
+require File.expand_path('spec_helper', File.dirname(__FILE__))
+
+describe 'search with dynamic fields' do
+  it 'returns dynamic string facet' do
+    stub_facet(:"custom_string:test_ss", 'two' => 2, 'one' => 1)
+    result = session.search(Post) { dynamic(:custom_string) { facet(:test) }}
+    result.facet(:custom_string, :test).rows.map { |row| row.value }.should == ['two', 'one']
+  end
+
+  it 'returns dynamic field facet with custom label' do
+    stub_facet(:"bogus", 'two' => 2, 'one' => 1)
+    result = session.search(Post) { dynamic(:custom_string) { facet(:test, :name => :bogus) }}
+    result.facet(:bogus).rows.map { |row| row.value }.should == ['two', 'one']
+  end
+
+  it 'returns query facet specified in dynamic call' do
+    stub_query_facet(
+      'custom_string\:test_ss:(foo OR bar)' => 3
+    )
+    search = session.search(Post) do
+      dynamic :custom_string do
+        facet :test do
+          row :foo_bar do
+            with :test, %w(foo bar)
+          end
+        end
+      end
+    end
+    facet = search.facet(:test)
+    facet.rows.first.value.should == :foo_bar
+    facet.rows.first.count.should == 3
+  end
+end

data/sunspot/spec/api/search/faceting_spec.rb

@@ -0,0 +1,360 @@
+require File.expand_path('spec_helper', File.dirname(__FILE__))
+
+describe 'faceting', :type => :search do
+  it 'returns field name for facet' do
+    stub_facet(:title_ss, {})
+    result = session.search Post do
+      facet :title
+    end
+    result.facet(:title).field_name.should == :title
+  end
+
+  it 'returns facet specified by string' do
+    stub_facet(:title_ss, {})
+    result = session.search Post do
+      facet :title
+    end
+    result.facet('title').field_name.should == :title
+  end
+
+  it 'returns all facets specified by search' do
+    stub_facet(:title_ss, { 'Author 1' => 1 })
+    stub_facet(:blog_id_i, { '1' => 3 })
+    result = session.search(Post) do
+      facet :title
+      facet :blog_id
+    end
+    result.facets.first.field_name.should == :title
+    result.facets.last.field_name.should == :blog_id
+  end
+
+  it 'returns string facet' do
+    stub_facet(:title_ss, 'Author 1' => 2, 'Author 2' => 1)
+    result = session.search Post do
+      facet :title
+    end
+    facet_values(result, :title).should == ['Author 1', 'Author 2']
+  end
+
+  it 'returns counts for facet' do
+    stub_facet(:title_ss, 'Author 1' => 2, 'Author 2' => 1)
+    result = session.search Post do
+      facet :title
+    end
+    facet_counts(result, :title).should == [2, 1]
+  end
+
+  it 'returns integer facet' do
+    stub_facet(:blog_id_i, '3' => 2, '1' => 1)
+    result = session.search Post do
+      facet :blog_id
+    end
+    facet_values(result, :blog_id).should == [3, 1]
+  end
+
+  it 'returns float facet' do
+    stub_facet(:average_rating_ft, '9.3' => 2, '1.1' => 1)
+    result = session.search Post do
+      facet :average_rating
+    end
+    facet_values(result, :average_rating).should == [9.3, 1.1]
+  end
+
+  it 'returns time facet' do
+    stub_facet(
+      :published_at_dt,
+      '2009-04-07T20:25:23Z' => 3,
+      '2009-04-07T20:26:19Z' => 2,
+      '2050-04-07T20:27:15Z' => 1
+    )
+    result = session.search Post do
+      facet :published_at
+    end
+    # In JRuby, Time doesn't have 32-bit range constraint, apparently.
+    future_time =
+      begin
+        Time.gm(2050, 4, 7, 20, 27, 15)
+      rescue ArgumentError
+        DateTime.civil(2050, 4, 7, 20, 27, 15)
+      end
+    facet_values(result, :published_at).should ==
+      [Time.gm(2009, 4, 7, 20, 25, 23),
+       Time.gm(2009, 4, 7, 20, 26, 19),
+       future_time]
+  end
+
+  it 'returns date facet' do
+    stub_facet(
+      :expire_date_d,
+      '2009-07-13T00:00:00Z' => 3,
+      '2009-04-01T00:00:00Z' => 1
+    )
+    result = session.search(Post) do
+      facet :expire_date
+    end
+    facet_values(result, :expire_date).should ==
+      [Date.new(2009, 07, 13),
+       Date.new(2009, 04, 01)]
+  end
+
+  it 'returns trie integer facet' do
+    stub_facet(:size_it, '3' => 2, '1' => 1)
+    result = session.search Photo do
+      facet :size
+    end
+    facet_values(result, :size).should == [3, 1]
+  end
+
+  it 'returns float facet' do
+    stub_facet(:average_rating_ft, '9.3' => 2, '1.1' => 1)
+    result = session.search Photo do
+      facet :average_rating
+    end
+    facet_values(result, :average_rating).should == [9.3, 1.1]
+  end
+
+  it 'returns time facet' do
+    stub_facet(
+      :created_at_dt,
+      '2009-04-07T20:25:23Z' => 3,
+      '2009-04-07T20:26:19Z' => 1
+    )
+    result = session.search Photo do
+      facet :created_at
+    end
+    facet_values(result, :created_at).should ==
+      [Time.gm(2009, 04, 07, 20, 25, 23),
+       Time.gm(2009, 04, 07, 20, 26, 19)]
+  end
+
+  it 'returns boolean facet' do
+    stub_facet(:featured_bs, 'true' => 3, 'false' => 1)
+    result = session.search(Post) { facet(:featured) }
+    facet_values(result, :featured).should == [true, false]
+  end
+
+
+  { 'string' => 'blog', 'symbol' => :blog }.each_pair do |type, name|
+    it "returns field facet with #{type} custom name" do
+      stub_facet(:blog, '2' => 1, '1' => 4)
+      result = session.search(Post) { facet(:blog_id, :name => name) }
+      facet_values(result, :blog).should == [1, 2]
+    end
+
+    it "assigns #{type} custom name to field facet" do
+      stub_facet(:blog, '2' => 1)
+      result = session.search(Post) { facet(:blog_id, :name => name) }
+      result.facet(:blog).name.should == :blog
+    end
+
+    it "retains field name for #{type} custom-named field facet" do
+      stub_facet(:blog, '2' => 1)
+      result = session.search(Post) { facet(:blog_id, :name => name) }
+      result.facet(:blog).field_name.should == :blog_id
+    end
+  end
+
+  it 'returns class facet' do
+    stub_facet(:class_name, 'Post' => 3, 'Namespaced::Comment' => 1)
+    result = session.search(Post) { facet(:class) }
+    facet_values(result, :class).should == [Post, Namespaced::Comment]
+  end
+
+  it 'returns special :any facet' do
+    stub_query_facet(
+      'category_ids_im:[* TO *]' => 3
+    )
+    search = session.search(Post) { facet(:category_ids, :extra => :any) }
+    row = search.facet(:category_ids).rows.first
+    row.value.should == :any
+    row.count.should == 3
+  end
+
+  it 'returns special :none facet' do
+    stub_query_facet(
+      '-category_ids_im:[* TO *]' => 3
+    )
+    search = session.search(Post) { facet(:category_ids, :extra => :none) }
+    row = search.facet(:category_ids).rows.first
+    row.value.should == :none
+    row.count.should == 3
+  end
+
+  it 'returns date range facet' do
+    stub_date_facet(:published_at_dt, 60*60*24, '2009-07-08T04:00:00Z' => 2, '2009-07-07T04:00:00Z' => 1)
+    start_time = Time.utc(2009, 7, 7, 4)
+    end_time = start_time + 2*24*60*60
+    result = session.search(Post) { facet(:published_at, :time_range => start_time..end_time) }
+    facet = result.facet(:published_at)
+    facet.rows.first.value.should == (start_time..(start_time+24*60*60))
+    facet.rows.last.value.should == ((start_time+24*60*60)..end_time)
+  end
+
+  it 'returns date range facet sorted by count' do
+    stub_date_facet(:published_at_dt, 60*60*24, '2009-07-08T04:00:00Z' => 2, '2009-07-07T04:00:00Z' => 1)
+    start_time = Time.utc(2009, 7, 7, 4)
+    end_time = start_time + 2*24*60*60
+    result = session.search(Post) { facet(:published_at, :time_range => start_time..end_time, :sort => :count) }
+    facet = result.facet(:published_at)
+    facet.rows.first.value.should == ((start_time+24*60*60)..end_time)
+    facet.rows.last.value.should == (start_time..(start_time+24*60*60))
+  end
+
+  it 'returns query facet' do
+    stub_query_facet(
+      'average_rating_ft:[3\.0 TO 5\.0]' => 3,
+      'average_rating_ft:[1\.0 TO 3\.0]' => 1
+    )
+    search = session.search(Post) do
+      facet :average_rating do
+        row 3.0..5.0 do
+          with :average_rating, 3.0..5.0
+        end
+        row 1.0..3.0 do
+          with :average_rating, 1.0..3.0
+        end
+      end
+    end
+    facet = search.facet(:average_rating)
+    facet.rows.first.value.should == (3.0..5.0)
+    facet.rows.first.count.should == 3
+    facet.rows.last.value.should == (1.0..3.0)
+    facet.rows.last.count.should == 1
+  end
+
+  describe 'query facet option handling' do
+    def facet_values_from_options(options = {})
+      session.search(Post) do
+        facet :average_rating, options do
+          row(1) { with(:average_rating, 1.0..2.0) }
+          row(3) { with(:average_rating, 3.0..4.0) }
+          row(2) { with(:average_rating, 2.0..3.0) }
+          row(4) { with(:average_rating, 4.0..5.0) }
+        end
+      end.facet(:average_rating).rows.map { |row| row.value }
+    end
+
+    before :each do
+      stub_query_facet(
+        'average_rating_ft:[1\.0 TO 2\.0]' => 2,
+        'average_rating_ft:[2\.0 TO 3\.0]' => 3,
+        'average_rating_ft:[3\.0 TO 4\.0]' => 1,
+        'average_rating_ft:[4\.0 TO 5\.0]' => 0
+      )
+    end
+
+    it 'sorts in order of specification if no limit is given' do
+      facet_values_from_options.should == [1, 3, 2]
+    end
+
+    it 'sorts lexically if lexical option is specified' do
+      facet_values_from_options(:sort => :index).should == [1, 2, 3]
+    end
+
+    it 'sorts by count by default if limit is given' do
+      facet_values_from_options(:limit => 2).should == [2, 1]
+    end
+
+    it 'sorts by count if count option is specified' do
+      facet_values_from_options(:sort => :count).should == [2, 1, 3]
+    end
+
+    it 'sorts lexically if lexical option is specified even if limit is given' do
+      facet_values_from_options(:sort => :index, :limit => 2).should == [1, 2]
+    end
+
+    it 'limits facets if limit option is given' do
+      facet_values_from_options(:limit => 1).should == [2]
+    end
+
+    it 'does not limit facets if limit option is negative' do
+      facet_values_from_options(:limit => -2).should == [1, 3, 2]
+    end
+
+    it 'returns all facets if limit greater than number of facets' do
+      facet_values_from_options(:limit => 10).should == [2, 1, 3]
+    end
+
+    it 'allows zero count if specified' do
+      facet_values_from_options(:zeros => true).should == [1, 3, 2, 4]
+    end
+
+    it 'sets minimum count' do
+      facet_values_from_options(:minimum_count => 2).should == [1, 2]
+    end
+  end
+
+  it 'returns limited field facet' do
+    stub_query_facet(
+      'category_ids_im:1' => 3,
+      'category_ids_im:3' => 1
+    )
+    search = session.search(Post) do
+      facet :category_ids, :only => [1, 3, 5]
+    end
+    facet = search.facet(:category_ids)
+    facet.rows.first.value.should == 1
+    facet.rows.first.count.should == 3
+    facet.rows.last.value.should == 3
+    facet.rows.last.count.should == 1
+  end
+
+  it 'returns instantiated facet values' do
+    blogs = Array.new(2) { Blog.new }
+    stub_facet(:blog_id_i, blogs[0].id.to_s => 2, blogs[1].id.to_s => 1)
+    search = session.search(Post) { facet(:blog_id) }
+    search.facet(:blog_id).rows.map { |row| row.instance }.should == blogs
+  end
+
+  it 'returns all instantiated facet rows, whether or not the instances exist' do
+    blogs = Array.new(2) { Blog.new }
+    blogs.last.destroy
+    stub_facet(:blog_id_i, blogs[0].id.to_s => 2, blogs[1].id.to_s => 1)
+    search = session.search(Post) { facet(:blog_id) }
+    search.facet(:blog_id).rows.map { |row| row.instance }.should == [blogs.first, nil]
+  end
+
+  it 'returns only rows with available instances if specified' do
+    blogs = Array.new(2) { Blog.new }
+    blogs.last.destroy
+    stub_facet(:blog_id_i, blogs[0].id.to_s => 2, blogs[1].id.to_s => 1)
+    search = session.search(Post) { facet(:blog_id) }
+    search.facet(:blog_id).rows(:verify => true).map { |row| row.instance }.should == blogs[0..0]
+  end
+
+  it 'returns both verified and unverified rows from the same facet' do
+    blogs = Array.new(2) { Blog.new }
+    blogs.last.destroy
+    stub_facet(:blog_id_i, blogs[0].id.to_s => 2, blogs[1].id.to_s => 1)
+    search = session.search(Post) { facet(:blog_id) }
+    search.facet(:blog_id).rows(:verify => true).map { |row| row.instance }.should == blogs[0..0]
+    search.facet(:blog_id).rows.map { |row| row.instance }.should == [blogs.first, nil]
+  end
+
+  it 'ignores :verify option if facet not a reference facet' do
+    stub_facet(:category_ids_im, '1' => 2, '2' => 1)
+    search = session.search(Post) { facet(:category_ids) }
+    search.facet(:category_ids).should have(2).rows(:verify => true)
+  end
+
+  it 'returns instantiated facet values for limited field facet' do
+    blogs = Array.new(2) { Blog.new }
+    stub_query_facet(
+      "blog_id_i:#{blogs[0].id}" => 3,
+      "blog_id_i:#{blogs[1].id}" => 1
+    )
+    search = session.search(Post) do
+      facet(:blog_id, :only => blogs.map { |blog| blog.id })
+    end
+    search.facet(:blog_id).rows.map { |row| row.instance }.should == blogs
+  end
+
+  it 'only queries the persistent store once for an instantiated facet' do
+    query_count = Blog.query_count
+    blogs = Array.new(2) { Blog.new }
+    stub_facet(:blog_id_i, blogs[0].id.to_s => 2, blogs[1].id.to_s => 1)
+    result = session.search(Post) { facet(:blog_id) }
+    result.facet(:blog_id).rows.each { |row| row.instance }
+    (Blog.query_count - query_count).should == 1
+  end
+end