Setup ginger scenarios so we can test this gem against multiple versions of active record.

Author: myronmarston

.ginger

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

Rakefile

@@ -14,6 +14,8 @@ begin
 
     gem.add_dependency 'activerecord', '>= 2.0.0'
     gem.add_development_dependency "rspec", ">= 1.2.9"
+
+    gem.files.exclude 'vendor/ginger'
     # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
   end
   Jeweler::GemcutterTasks.new
@@ -38,7 +40,15 @@ end
 
 task :spec => :check_dependencies if defined?(Jeweler)
 
-task :default => :spec
+desc 'Run ginger tests'
+task :ginger do
+  $LOAD_PATH << File.join(*%w[vendor ginger lib])
+  ARGV.clear
+  ARGV << 'spec'
+  load File.join(*%w[vendor ginger bin ginger])
+end
+
+task :default => :ginger
 
 require 'rake/rdoctask'
 Rake::RDocTask.new do |rd|

ginger_scenarios.rb

@@ -0,0 +1,22 @@
+require 'ginger'
+ 
+def create_scenario(version)
+  scenario = Ginger::Scenario.new("Rails #{version}")
+  scenario[/^active_?record$/] = version
+  scenario[/^active_?support$/] = version
+  scenario
+end
+
+Ginger.configure do |config|
+  config.aliases["active_record"] = "activerecord"
+  config.aliases["active_support"] = "activesupport"
+
+  %w(
+  2.3.5 2.3.4 2.3.3 2.3.2
+  2.2.3 2.2.2
+  2.1.2 2.1.1 2.1.0
+  2.0.5 2.0.4 2.0.2 2.0.1 2.0.0
+  ).each do |version|
+    config.scenarios << create_scenario(version)
+  end
+end

spec/nulldb_spec.rb

@@ -1,5 +1,7 @@
 require 'rubygems'
 require 'spec'
+$LOAD_PATH << File.join(File.dirname(__FILE__), *%w[.. vendor ginger lib])
+require 'ginger'
 require 'active_record'
 $: << File.join(File.dirname(__FILE__), "..", "lib")
 

vendor/ginger/.gitignore

@@ -0,0 +1 @@
+ginger*.gem

vendor/ginger/LICENCE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Pat Allan
+
+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.

vendor/ginger/README.textile

@@ -0,0 +1,55 @@
+Ginger is a small gem that allows you to test your projects using multiple versions of gem libraries. The idea is from "Ian White's garlic":http://github.com/ianwhite/garlic/tree - hence the related name of this - but my approach is a bit different, since I don't test my plugins from within a rails application. Maybe they can be merged at some point - I just hacked this up quickly to fit my needs.
+
+To get it all working, you need to do four things. The first is, of course, to install this gem.
+
+<pre><code>sudo gem install ginger --source=http://gemcutter.org</code></pre>
+
+Next, add the following line of code to your @spec_helper.rb@ file (or equivalent):
+
+<pre><code>require 'ginger'</code></pre>
+
+You'll want to put it as high up as possible - in particular, before any @require@ calls to libraries you want to cover multiple versions of.
+
+Step number three is creating the sets of scenarios in a file called @ginger_scenarios.rb@, which should go in the root, spec or test directory of your project. Here's an example, showing off the syntax possibilities.
+
+<pre><code>require 'ginger'
+
+Ginger.configure do |config|
+  config.aliases["active_record"] = "activerecord"
+  
+  ar_1_2_6 = Ginger::Scenario.new
+  ar_1_2_6[/^active_?record$/] = "1.15.6"
+  
+  ar_2_0_2 = Ginger::Scenario.new
+  ar_2_0_2[/^active_?record$/] = "2.0.2"
+  
+  ar_2_1_1 = Ginger::Scenario.new
+  ar_2_1_1[/^active_?record$/] = "2.1.1"
+  
+  config.scenarios << ar_1_2_6 << ar_2_0_2 << ar_2_1_1
+end</code></pre>
+
+Above, I've added three different scenarios, for three different versions of ActiveRecord. I also added an alias, as people sometimes use the underscore, and sometimes don't. The gem's name has no underscore though, so the _value_ of the alias matches the gem name (whereas the key would be alternative usage).
+
+You can have multiple gems set in each scenario - and you don't have to use regular expressions, you can just use straight strings.
+
+<pre><code>sphinx_scenario = Ginger::Scenario.new
+sphinx_scenario["riddle"] = "0.9.8"
+sphinx_scenario["thinking_sphinx"] = "0.9.8"</code></pre>
+
+Don't forget to add them to @config@'s scenarios collection, else they're not saved anywhere.
+
+To better discern different defined scenarios you can create them with a name. The name will be output when the scenario runs as the title. 
+
+<pre><code>sphinx_scenario = Ginger::Scenario.new('Thinking Sphinx 0.9.8')</code></pre>
+
+And finally, you'll want to run the tests or specs for each scenario. This is done using the @ginger@ CLI tool, which parrots whatever parameters you give it onto @rake@. So just do something like:
+
+<pre><code>ginger spec
+ginger test
+ginger spec:unit</code></pre>
+
+h2. Contributors
+
+* "Adam Meehan":http://duckpunching.com/
+* "Darragh Curran":http://peelmeagrape.net/

vendor/ginger/Rakefile

@@ -0,0 +1,6 @@
+require 'rubygems'
+
+require 'tasks/distribution'
+require 'tasks/testing'
+
+task :default => :spec

vendor/ginger/VERSION

@@ -0,0 +1 @@
+1.2.0

vendor/ginger/bin/ginger

@@ -0,0 +1,45 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'ginger'
+require 'rake'
+
+if ARGV.length == 0
+  puts <<-USAGE
+ginger #{Ginger::Version::String}
+Use ginger to run specs for each scenario defined. Scenarios must be set out in
+a file called ginger_scenarios.rb wherever this tool is run. Once they're
+defined, then you can run this tool and provide the rake task that would
+normally be called.
+
+Examples:
+  ginger spec
+  ginger test
+  ginger spec:models
+USAGE
+  exit 0
+end
+
+file_path = File.join Dir.pwd, ".ginger"
+
+File.delete(file_path) if File.exists?(file_path)
+
+scenarios = Ginger::Configuration.instance.scenarios
+puts "No Ginger Scenarios defined" if scenarios.empty?
+
+scenarios.each_with_index do |scenario, index|
+  puts <<-SCENARIO
+
+-------------------
+Ginger Scenario: #{scenario.name || index+1}
+-------------------
+  SCENARIO
+  
+  File.open('.ginger', 'w') { |f| f.write index.to_s }
+  
+  system("rake #{ARGV.join(" ")}")     || # Standard
+  system("rake.bat #{ARGV.join(" ")}") || # Windows
+  raise('Missing: rake or rake.bat. You might want to fix that.')
+end
+
+File.delete(file_path) if File.exists?(file_path)

vendor/ginger/ginger.gemspec

@@ -0,0 +1,59 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{ginger}
+  s.version = "1.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Pat Allan"]
+  s.date = %q{2009-11-27}
+  s.default_executable = %q{ginger}
+  s.description = %q{Run rake tasks multiple times with different gem versions.}
+  s.email = %q{[email protected]}
+  s.executables = ["ginger"]
+  s.extra_rdoc_files = [
+    "README.textile"
+  ]
+  s.files = [
+    "LICENCE",
+     "README.textile",
+     "bin/ginger",
+     "lib/ginger.rb",
+     "lib/ginger/configuration.rb",
+     "lib/ginger/kernel.rb",
+     "lib/ginger/scenario.rb"
+  ]
+  s.homepage = %q{http://github.com/freelancing_god/ginger/tree}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Run rake tasks multiple times with different gem versions.}
+  s.test_files = [
+    "spec/ginger",
+     "spec/ginger/configuration_spec.rb",
+     "spec/ginger/kernel_spec.rb",
+     "spec/ginger/scenario_spec.rb",
+     "spec/ginger_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<yard>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<yard>, [">= 0"])
+  end
+end
+

vendor/ginger/lib/ginger.rb

@@ -0,0 +1,14 @@
+require 'rubygems'
+require 'ginger/configuration'
+require 'ginger/scenario'
+require 'ginger/kernel'
+
+module Ginger
+  def self.configure(&block)
+    yield Ginger::Configuration.instance
+  end
+end
+
+Kernel.send(:include, Ginger::Kernel)
+
+Ginger::Configuration.detect_scenario_file

vendor/ginger/lib/ginger/configuration.rb

@@ -0,0 +1,20 @@
+require 'singleton'
+
+module Ginger
+  class Configuration
+    include Singleton
+    
+    attr_accessor :scenarios, :aliases
+    
+    def initialize
+      @scenarios = []
+      @aliases   = {}
+    end
+    
+    def self.detect_scenario_file
+      ['.','spec','test'].each do |path|
+        require "#{path}/ginger_scenarios" and break if File.exists?("#{path}/ginger_scenarios.rb")
+      end
+    end
+  end
+end

vendor/ginger/lib/ginger/kernel.rb

@@ -0,0 +1,56 @@
+module Ginger
+  module Kernel
+    def self.included(base)
+      base.class_eval do
+        def require_with_ginger(req)
+          unless scenario = ginger_scenario
+            require_without_ginger(req)
+            return
+          end
+          
+          if scenario.version(req)
+            gem ginger_gem_name(req)
+          end
+          
+          require_without_ginger(req)
+        end
+
+        alias_method :require_without_ginger, :require
+        alias_method :require, :require_with_ginger
+        
+        def gem_with_ginger(gem_name, *version_requirements)
+          unless scenario = ginger_scenario
+            gem_without_ginger(gem_name, *version_requirements)
+            return
+          end
+          
+          if version_requirements.length == 0 &&
+             version = scenario.version(gem_name)
+            version_requirements << "= #{version}"
+          end
+          
+          gem_without_ginger(gem_name, *version_requirements)
+        end
+        
+        alias_method :gem_without_ginger, :gem
+        alias_method :gem, :gem_with_ginger
+        
+        private
+        
+        def ginger_scenario
+          return nil unless File.exists?(".ginger")
+          
+          scenario = nil
+          File.open('.ginger') { |f| scenario = f.read }
+          return nil unless scenario
+          
+          Ginger::Configuration.instance.scenarios[scenario.to_i]
+        end
+        
+        def ginger_gem_name(gem_name)
+          Ginger::Configuration.instance.aliases[gem_name] || gem_name
+        end
+      end
+    end
+  end
+end

vendor/ginger/lib/ginger/scenario.rb

@@ -0,0 +1,30 @@
+module Ginger
+  class Scenario < Hash
+    attr_accessor :name
+
+    def initialize(name=nil)
+      @name = name
+    end
+
+    def add(gem, version)
+      self[gem] = version
+    end
+    
+    def version(gem)
+      self.keys.each do |key|
+        case key
+        when String
+          return self[key] if gem == key
+        when Regexp
+          return self[key] if gem =~ key
+        end
+      end
+      
+      return nil
+    end
+    
+    def gems
+      self.keys
+    end
+  end
+end

vendor/ginger/spec/ginger/configuration_spec.rb

@@ -0,0 +1,7 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Ginger::Configuration do
+  it "should be a singleton class" do
+    Ginger::Configuration.should respond_to(:instance)
+  end
+end

vendor/ginger/spec/ginger/kernel_spec.rb

@@ -0,0 +1,7 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe "Ginger::Kernel" do
+  it "should description" do
+    #
+  end
+end