supernova 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,18 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+
+gem "thinking-sphinx", "2.0.3"
+
+group :development do
+  gem "autotest"
+  gem "autotest-growl"
+  gem "rspec", "~> 2.3.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.0"
+  gem "rcov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,53 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    ZenTest (4.5.0)
+    activemodel (3.0.8)
+      activesupport (= 3.0.8)
+      builder (~> 2.1.2)
+      i18n (~> 0.5.0)
+    activerecord (3.0.8)
+      activemodel (= 3.0.8)
+      activesupport (= 3.0.8)
+      arel (~> 2.0.10)
+      tzinfo (~> 0.3.23)
+    activesupport (3.0.8)
+    arel (2.0.10)
+    autotest (4.4.6)
+      ZenTest (>= 4.4.1)
+    autotest-growl (0.2.9)
+    builder (2.1.2)
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    i18n (0.5.0)
+    jeweler (1.6.2)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.9.2)
+    rcov (0.9.9)
+    riddle (1.3.3)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    thinking-sphinx (2.0.3)
+      activerecord (>= 3.0.3)
+      riddle (>= 1.2.2)
+    tzinfo (0.3.27)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  autotest
+  autotest-growl
+  bundler (~> 1.0.0)
+  jeweler (~> 1.6.0)
+  rcov
+  rspec (~> 2.3.0)
+  thinking-sphinx (= 2.0.3)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Tobias Schwab
+
+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.

data/README.rdoc

@@ -0,0 +1,55 @@
+= supernova
+
+== Setup
+
+require "supernova"
+require "supernova/thiking_sphinx"
+
+class class Offer
+  include Supernova::ThinkingSphinx
+end
+
+=== Anonymous Scopes
+
+scope = Offer.order("popularity desc").with(:city => "Hamburg").paginate(:page => 2, :per_page => 10)
+
+# no query sent yet
+# query is sent e.g. when
+
+scope.each { |offer| puts offer.city }                            # objects of current page are iterated
+scope.total_entries                                               # no objects loaded though
+scope.ids                                                         # no objects loaded, only ids are returned
+scope.first or scope.last                                         # all objects are loaded, only first or last in "page" is returned
+
+=== Named Scopes
+
+class Offer
+  include Supernova::ThinkingSphinx
+  
+  named_search_scope :popular do
+    order("popularity desc")
+  end
+  
+  named_search_scope :for_artists do |ids|
+    with(:artist_id => ids)
+  end
+end
+
+Offer.popular.for_artists([1, 2, 3])                              # various named scopes can be combined
+Offer.popular.for_artists([1, 2, 3]).with(:available => true)     # named scopes can also be combined with anonymous scopes
+
+== Contributing to search_scopes
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Tobias Schwab. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "supernova"
+  # gem.homepage = "http://github.com/dynport/supernova"
+  gem.license = "MIT"
+  gem.summary = %Q{Unified search scopes}
+  gem.description = %Q{Unified search scopes}
+  gem.email = "tobias.schwab@dynport.de"
+  gem.authors = ["Tobias Schwab"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "search_scope #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/autotest/discover.rb

@@ -0,0 +1 @@
+Autotest.add_discovery { "rspec2" }

data/lib/supernova.rb

@@ -0,0 +1,20 @@
+module Supernova
+  module ClassMethods
+    attr_accessor :criteria_class, :defined_named_search_scopes
+    
+    def search_scope
+      self.criteria_class.new(self)
+    end
+    
+    def named_search_scope(name, &block)
+      self.class.send(:define_method, name) do |*args|
+        self.search_scope.instance_exec(*args, &block)
+      end
+      self.defined_named_search_scopes ||= []
+      self.defined_named_search_scopes << name
+    end
+  end
+end
+
+require "supernova/criteria"
+require "supernova/thinking_sphinx"

data/lib/supernova/criteria.rb

@@ -0,0 +1,114 @@
+class Supernova::Criteria
+  attr_accessor :filters, :options, :clazz
+
+  class << self
+    def method_missing(*args)
+      scope = self.new
+      if scope.respond_to?(args.first)
+        scope.send(*args)
+      else
+        super
+      end
+    end
+  
+    def select(*args)
+      self.new.send(:select, *args)
+    end
+  end
+
+  def initialize(clazz = nil)
+    self.clazz = clazz
+    self.filters = {}
+    self.options = {}
+  end
+
+  def for_classes(clazzes)
+    merge_filters :classes, [clazzes].flatten
+  end
+
+  def order(order_option)
+    merge_options :order, order_option
+  end
+
+  def limit(limit_option)
+    merge_options :limit, limit_option
+  end
+
+  def group_by(group_option)
+    merge_options :group_by, group_option
+  end
+
+  def search(query)
+    merge_filters :search, query
+  end
+
+  def with(filters)
+    merge_filters :with, filters
+  end
+
+  def select(fields)
+    merge_options :select, fields
+  end
+
+  def conditions(filters)
+    merge_filters :conditions, filters
+  end
+
+  def paginate(options)
+    merge_options :pagination, options
+  end
+
+  def merge_filters(key, value)
+    merge_filters_or_options(self.filters, key, value)
+  end
+
+  def merge_options(key, value)
+    merge_filters_or_options(self.options, key, value)
+  end
+
+  def merge_filters_or_options(reference, key, value)
+    if value.is_a?(Hash)
+      reference[key] ||= Hash.new
+      reference[key].merge!(value)
+    else
+      reference[key] = value
+    end
+    self
+  end
+
+  def to_parameters
+    implement_in_subclass
+  end
+
+  def to_a
+    implement_in_subclass
+  end
+
+  def implement_in_subclass
+    raise "implement in subclass"
+  end
+  
+  def merge(other_criteria)
+    other_criteria.filters.each do |key, value|
+      self.merge_filters(key, value)
+    end
+    other_criteria.options.each do |key, value|
+      self.merge_options(key, value)
+    end
+    self
+  end
+
+  def method_missing(*args, &block)
+    if args.length == 1 && Array.new.respond_to?(args.first)
+      to_a.send(args.first, &block)
+    elsif self.named_scope_defined?(args.first)
+      self.merge(self.clazz.send(*args)) # merge named scope and current criteria
+    else
+      super
+    end
+  end
+  
+  def named_scope_defined?(name)
+    self.clazz && self.clazz.respond_to?(:defined_named_search_scopes) && clazz.defined_named_search_scopes.respond_to?(:include?) && clazz.defined_named_search_scopes.include?(name)
+  end
+end

data/lib/supernova/thinking_sphinx.rb

@@ -0,0 +1,8 @@
+require "supernova/thinking_sphinx_criteria"
+
+module Supernova::ThinkingSphinx
+  def self.included(base)
+    base.extend(Supernova::ClassMethods)
+    base.criteria_class = Supernova::ThinkingSphinxCriteria
+  end
+end

data/lib/supernova/thinking_sphinx_criteria.rb

@@ -0,0 +1,32 @@
+require "thinking_sphinx"
+
+class Supernova::ThinkingSphinxCriteria < Supernova::Criteria
+  def self.index_statement_for(field_name, column = nil)
+    column ||= field_name
+    [%(CONCAT("#{field_name}_", #{column})), { :as => :"indexed_#{field_name}" }]
+  end
+  
+  def to_params
+    sphinx_options = { :match_mode => :boolean, :with => {}, :conditions => {} }
+    sphinx_options[:order] = self.options[:order] if self.options[:order]
+    sphinx_options[:limit] = self.options[:limit] if self.options[:limit]
+    sphinx_options[:select] = self.options[:select] if self.options[:select]
+    sphinx_options[:group_by] = self.options[:group_by] if self.options[:group_by]
+    sphinx_options.merge!(self.options[:pagination]) if self.options[:pagination].is_a?(Hash)
+    sphinx_options[:classes] = self.filters[:classes] if self.filters[:classes]
+    sphinx_options[:conditions].merge!(self.filters[:conditions]) if self.filters[:conditions]
+    [self.filters[:search], sphinx_options]
+  end
+  
+  def to_a
+    ThinkingSphinx.search(*self.to_params)
+  end
+  
+  def ids
+    ThinkingSphinx.search_for_ids(*self.to_params)
+  end
+  
+  def total_entries
+    ids.total_entries
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'supernova'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end
+
+
+class Offer
+end
+
+class Host
+end

data/spec/supernova/criteria_spec.rb

@@ -0,0 +1,245 @@
+require File.expand_path("../spec_helper", File.dirname(__FILE__))
+
+describe "Supernova::Criteria" do
+  let(:scope) { Supernova::Criteria.new }
+  
+  
+  describe "#initialize" do
+    it "can be initialized" do
+      Supernova::Criteria.new.should be_an_instance_of(Supernova::Criteria)
+    end
+    
+    it "sets the clazz_name" do
+      Supernova::Criteria.new(Offer).clazz.should == Offer
+    end
+  end
+  
+  [
+    [:order, "popularity desc"],
+    [:group_by, "title"],
+    [:search, "query"],
+    [:limit, 10],
+    [:with, { :stars => 2 }],
+    [:conditions, { :stars => 2 }],
+    [:paginate, { :stars => 2 }],
+    [:select, %w(stars)]
+  ].each do |args|
+    it "returns the scope itself for #{args.first}" do
+      scope.send(*args).should == scope
+    end
+    
+    it "delegates all methods to the instance when responding to" do
+      scope_double = Supernova::Criteria.new
+      Supernova::Criteria.should_receive(:new).and_return scope_double
+      scope_double.should_receive(args.first).with(*args[1..-1])
+      Supernova::Criteria.send(*args)
+    end
+  end
+  
+  describe "#order" do
+    it "sets the order statement" do
+      scope.order("popularity desc").options[:order].should == "popularity desc"
+    end
+  end
+  
+  describe "#group_by" do
+    it "sets the group option" do
+      scope.group_by("name").options[:group_by].should == "name"
+    end
+  end
+  
+  it "sets the limit option" do
+    scope.limit(77).options[:limit].should == 77
+  end
+  
+  describe "#search" do
+    it "sets the query" do
+      scope.search("title").filters[:search].should == "title"
+    end
+  end
+  
+  describe "#for_classes" do
+    it "sets the correct classes" do
+      scope.for_classes([Offer, Host]).filters[:classes].should == [Offer, Host]
+    end
+    
+    it "also sets single classes" do
+      scope.for_classes(Offer).filters[:classes].should == [Offer]
+    end
+  end
+  
+  [:with, :conditions].each do |method|
+    describe "##{method}" do
+      it "adds all filters to the #{method} block" do
+        scope.send(method, { :length => 3, :height => 99 }).filters[method].should == { :length => 3, :height => 99 }
+      end
+    
+      it "overwrites before set filters" do
+        scope.send(method, { :length => 3, :height => 88 }).send(method, { :length => 4 }).filters[method].should == { :length => 4, :height => 88 }
+      end
+    end
+  end
+  
+  it "sets select option" do
+    scope.select(%w(a b)).options[:select].should == %w(a b)
+  end
+  
+  it "sets the correct pagination fields" do
+    scope.paginate(:page => 9, :per_page => 2).options[:pagination].should == { :page => 9, :per_page => 2 }
+  end
+  
+  it "to_parameters raises an implement in subclass error" do
+    lambda {
+      scope.to_parameters
+    }.should raise_error("implement in subclass")
+  end
+  
+  it "to_a raises an implement in subclass error" do
+    lambda {
+      scope.to_a
+    }.should raise_error("implement in subclass")
+  end
+  
+  describe "with to_a stubbed" do
+    let(:array_double) { double("array") }
+    
+    before(:each) do
+      scope.stub!(:to_a).and_return array_double
+    end
+    
+    [ :first, :each, :count, :last ].each do |method|
+      it "forwards #{method} to array" do
+        ret = double("ret")
+        array_double.should_receive(method).and_return ret
+        scope.send(method)
+      end
+    end
+    
+    it "hands given blocks in" do
+      array = [1, 2, 3]
+      scope.stub!(:to_a).and_return array
+      called = []
+      scope.each do |i|
+        called << i
+      end
+      called.should == array
+    end
+    
+    it "does raise errors when array does not respond" do
+      lambda {
+        scope.rgne
+      }.should raise_error(NoMethodError)
+      
+    end
+  end
+  
+  describe "#method_missing" do
+    it "raises a no method error when methd not defined" do
+      lambda {
+        scope.method_missing(:rgne)
+      }.should raise_error(NoMethodError)
+    end
+    
+    it "calls named_scope_defined" do
+      scope.should_receive(:named_scope_defined?).with(:rgne).and_return false
+      scope.method_missing(:rgne) rescue nil
+    end
+    
+    it "does not call named scopes when named_scope_defined? returns false" do
+      clazz = double("clazz")
+      scope = Supernova::Criteria.new(clazz)
+      scope.stub(:named_scope_defined?).and_return false
+      clazz.should_not_receive(:rgne)
+    end
+    
+    it "it calls merge with self and returned scope" do
+      clazz = double("clazz")
+      scope = Supernova::Criteria.new(clazz)
+      scope.stub(:named_scope_defined?).and_return true
+      rge_scope = double("rgne_scope")
+      scope_ret = double("ret")
+      clazz.should_receive(:rgne).with(1, 2).and_return scope_ret
+      merge_ret = double("merge_ret")
+      scope.should_receive(:merge).with(scope_ret).and_return merge_ret
+      scope.method_missing(:rgne, 1, 2).should == merge_ret
+    end
+  end
+  
+  describe "#merge" do
+    let(:criteria) { Supernova::Criteria.new.order("popularity asc").with(:a => 1).conditions(:b => 2).search("New Search") }
+    let(:new_crit) { Supernova::Criteria.new.order("popularity desc").with(:c => 8).conditions(:e => 9).search("Search") }
+    
+    it "it returns the original criteria" do
+      new_crit.merge(criteria).should == new_crit
+    end
+    
+    it "merges e.g. the order" do
+      new_crit.merge(criteria).options[:order].should == "popularity asc"
+    end
+    
+    it "merges e.g. the with filters" do
+      new_crit.merge(criteria).filters[:with].should == { :c => 8, :a => 1 }
+    end
+    
+    it "merges e.g. the conditions filters" do
+      new_crit.merge(criteria).filters[:conditions].should == { :b => 2, :e => 9 }
+    end
+    
+    it "merges search search" do
+      new_crit.merge(criteria).filters[:search].should == "New Search"
+    end
+    
+    it "calls merge on options" do
+      criteria.stub!(:options).and_return({ :x => 2, :y => 9 })
+      new_crit.stub!(:options).and_return({ :z => 3, :c => 1 })
+      new_crit.should_receive(:merge_options).with(:x, 2)
+      new_crit.should_receive(:merge_options).with(:y, 9)
+      new_crit.merge(criteria)
+    end
+    
+    it "calls merge filters on all filters" do
+      criteria.stub!(:filters).and_return({ :a => 1, :c => 3 })
+      new_crit.stub!(:filters).and_return({ :b => 2, :e => 1 })
+      new_crit.should_receive(:merge_filters).with(:a, 1)
+      new_crit.should_receive(:merge_filters).with(:c, 3)
+      new_crit.merge(criteria)
+    end
+  end
+  
+  describe "#named_scope_defined?" do
+    it "returns false when clazz is nil" do
+      Supernova::Criteria.new.should_not be_named_scope_defined(:rgne)
+    end
+    
+    it "returns false when clazz is present but not responding to defined_search_scopes" do
+      Supernova::Criteria.new("test").should_not be_named_scope_defined(:rgne)
+    end
+    
+    it "returns false when clazz is responding to defined_search_scopes but empty" do
+      clazz = Class.new
+      class << clazz
+        attr_accessor :defined_named_search_scopes
+      end
+      clazz.defined_named_search_scopes = nil
+      Supernova::Criteria.new(clazz).should_not be_named_scope_defined(:rgne)
+    end
+    
+    it "returns false when clazz is responding to defined_search_scopes but not included" do
+      clazz = Class.new
+      class << clazz
+        attr_accessor :defined_named_search_scopes
+      end
+      clazz.defined_named_search_scopes = [:some_other]
+      Supernova::Criteria.new(clazz).should_not be_named_scope_defined(:rgne)
+    end
+    
+    it "returns true when clazz is responding to defined_search_scopes and included" do
+      clazz = Class.new
+      class << clazz
+        attr_accessor :defined_named_search_scopes
+      end
+      clazz.defined_named_search_scopes = [:rgne]
+      Supernova::Criteria.new(clazz).should be_named_scope_defined(:rgne)
+    end
+  end
+end

data/spec/supernova/thinking_sphinx_criteria_spec.rb

@@ -0,0 +1,84 @@
+require 'spec_helper'
+
+describe "Supernova::ThinkingSphinxCriteria" do
+  let(:scope) { Supernova::ThinkingSphinxCriteria.new }
+  
+  describe "#to_params" do
+    it "returns an array" do
+      scope.to_params.should be_an_instance_of(Array)
+    end
+    
+    it "sets the correct order query" do
+      scope.order("title desc").to_params.at(1)[:order].should == "title desc"
+    end
+    
+    it "sets the correct group_by statement" do
+      scope.group_by("title").to_params.at(1)[:group_by].should == "title"
+    end
+    
+    it "sets the match_mode to boolean" do
+      scope.to_params.at(1)[:match_mode].should == :boolean
+    end
+    
+    it "does not set the classes field by default" do
+      scope.to_params.at(1).should_not have_key(:classes)
+    end
+    
+    it "sets the classes field when classes set" do
+      scope.for_classes(Offer).to_params.at(1)[:classes].should == [Offer]
+    end
+    
+    it "sets the search query when present" do
+      scope.search("some test").to_params.at(0).should == "some test"
+    end
+    
+    it "sets a set limit" do
+      scope.limit(88).to_params.at(1)[:limit].should == 88
+    end
+    
+    it "calls sphinx with select fields" do
+      scope.select(%w(id title name)).to_params.at(1)[:select].should == %w(id title name)
+    end
+    
+    { :page => 8, :per_page => 1 }.each do |key, value|
+      it "sets pagination pagination #{key} to #{value}" do
+        scope.paginate(key => value).to_params.at(1)[key].should == value
+      end
+    end
+  end
+  
+  describe "with to_params mockes" do
+    let(:query) { double("query") }
+    let(:options) { double("options") }
+    let(:sphinx_response) { double("sphinx_respons") }
+    
+    before(:each) do
+      scope.stub!(:to_params).and_return([query, options])
+    end
+    
+    describe "#to_a" do
+      it "returns the sphinx search" do
+        ThinkingSphinx.stub!(:search).and_return sphinx_response
+        scope.to_a.should == sphinx_response
+      end
+
+      it "calls ThinkingSphinx with what to_params returns" do
+        ThinkingSphinx.should_receive(:search).with(query, options).and_return sphinx_response
+        scope.to_a.should == sphinx_response
+      end
+    end
+
+    it "forwards ids to search_for_ids" do
+      ids_response = double("id response")
+      ThinkingSphinx.should_receive(:search_for_ids).with(query, options).and_return ids_response
+      scope.ids
+    end
+    
+    it "forwards total_entries to search_for_ids" do
+      ids_response = double("id response")
+      ThinkingSphinx.should_receive(:search_for_ids).with(query, options).and_return ids_response
+      ids_response.should_receive(:total_entries).and_return 88
+      scope.total_entries.should == 88
+    end
+  end
+end

data/spec/supernova_spec.rb

@@ -0,0 +1,87 @@
+require 'spec_helper'
+
+describe Supernova do
+  let(:clazz) do
+    clazz = Class.new
+    clazz.send(:include, Supernova::ThinkingSphinx)
+  end
+  
+  describe "#including" do
+    it "can be includes" do
+      Class.new.send(:include, Supernova::ThinkingSphinx)
+    end
+
+    it "defines a named_search_scope method" do
+      clazz.send(:include, Supernova)
+      clazz.should be_respond_to(:named_search_scope)
+    end
+  end
+  
+  describe "#search_scope" do
+    it "returns a new criteria" do
+      clazz.search_scope.should be_an_instance_of(Supernova::ThinkingSphinxCriteria)
+    end
+    
+    it "sets the correct clazz" do
+      clazz.search_scope.clazz.should == clazz
+    end
+  end
+  
+  describe "#named_search_scope" do
+    before(:each) do
+      clazz.named_search_scope :popular do
+        order("popularity desc")
+      end
+    end
+    
+    describe "without parameters" do
+      it "defines a new method" do
+        clazz.should respond_to(:popular)
+      end
+
+      it "returns a new criteria" do
+        clazz.popular.should be_an_instance_of(Supernova::ThinkingSphinxCriteria)
+      end
+
+      it "sets the clazz attribute" do
+        clazz.popular.clazz.should == clazz
+      end
+
+      it "sets the correct order option" do
+        clazz.popular.options[:order].should == "popularity desc"
+      end
+      
+      it "adds the name of the scope to the defined_named_search_scopes array" do
+        clazz.defined_named_search_scopes.should == [:popular]
+      end
+    end
+    
+    describe "chaining" do
+      it "calls merge with both scopes" do
+        scope = Supernova::ThinkingSphinxCriteria.new(clazz)
+        scope.should_receive(:merge).with(instance_of(Supernova::ThinkingSphinxCriteria))
+        scope.popular
+      end
+      # Supernova::ThinkingSphinxCriteria.new(clazz).popular.should be_an_instance_of()
+    end
+    
+    describe "with parameters" do
+      before(:each) do
+        clazz.named_search_scope :for_artists do |artist_ids|
+          with(:artist_id => artist_ids)
+        end
+        clazz.named_search_scope :popular do
+          order("popularity desc")
+        end
+      end
+      
+      it "sets the correct filters" do
+        clazz.for_artists(%w(1 3 2)).filters[:with][:artist_id].should == %w(1 3 2)
+      end
+      
+      it "allows chaining of named_search_scopes" do
+        clazz.for_artists(%w(1 3 2)).popular.options[:order].should == "popularity desc"
+      end
+    end
+  end
+end

data/supernova.gemspec

@@ -0,0 +1,74 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{supernova}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Tobias Schwab"]
+  s.date = %q{2011-06-08}
+  s.description = %q{Unified search scopes}
+  s.email = %q{tobias.schwab@dynport.de}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "autotest/discover.rb",
+    "lib/supernova.rb",
+    "lib/supernova/criteria.rb",
+    "lib/supernova/thinking_sphinx.rb",
+    "lib/supernova/thinking_sphinx_criteria.rb",
+    "spec/spec_helper.rb",
+    "spec/supernova/criteria_spec.rb",
+    "spec/supernova/thinking_sphinx_criteria_spec.rb",
+    "spec/supernova_spec.rb",
+    "supernova.gemspec"
+  ]
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.7.2}
+  s.summary = %q{Unified search scopes}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<thinking-sphinx>, ["= 2.0.3"])
+      s.add_development_dependency(%q<autotest>, [">= 0"])
+      s.add_development_dependency(%q<autotest-growl>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.0"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<thinking-sphinx>, ["= 2.0.3"])
+      s.add_dependency(%q<autotest>, [">= 0"])
+      s.add_dependency(%q<autotest-growl>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.0"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<thinking-sphinx>, ["= 2.0.3"])
+    s.add_dependency(%q<autotest>, [">= 0"])
+    s.add_dependency(%q<autotest-growl>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.0"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

metadata

@@ -0,0 +1,188 @@
+--- !ruby/object:Gem::Specification 
+name: supernova
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Tobias Schwab
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-08 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 9
+        segments: 
+        - 2
+        - 0
+        - 3
+        version: 2.0.3
+  version_requirements: *id001
+  name: thinking-sphinx
+  prerelease: false
+  type: :runtime
+- !ruby/object:Gem::Dependency 
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id002
+  name: autotest
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id003
+  name: autotest-growl
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 3
+        - 0
+        version: 2.3.0
+  version_requirements: *id004
+  name: rspec
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  version_requirements: *id005
+  name: bundler
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 6
+        - 0
+        version: 1.6.0
+  version_requirements: *id006
+  name: jeweler
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id007
+  name: rcov
+  prerelease: false
+  type: :development
+description: Unified search scopes
+email: tobias.schwab@dynport.de
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- autotest/discover.rb
+- lib/supernova.rb
+- lib/supernova/criteria.rb
+- lib/supernova/thinking_sphinx.rb
+- lib/supernova/thinking_sphinx_criteria.rb
+- spec/spec_helper.rb
+- spec/supernova/criteria_spec.rb
+- spec/supernova/thinking_sphinx_criteria_spec.rb
+- spec/supernova_spec.rb
+- supernova.gemspec
+homepage: 
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.7.2
+signing_key: 
+specification_version: 3
+summary: Unified search scopes
+test_files: []
+