isolate-scenarios 0.0.2

data/.document

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

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/IsolateScenarios

@@ -0,0 +1,11 @@
+baseline do
+  gem 'puppet', '= 0.24.8'
+  gem 'facter', '>= 1.5.4'
+  gem 'highline', '>= 1.5.0'
+  gem 'builder', '>= 2.1.2'
+end
+
+gem_version_scenario 'activesupport',
+                     '2.1.2',
+                     '2.2.3',
+                     '2.3.5'

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Joshua Nichols
+
+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,101 @@
+= isolate-scenarios
+
+When you're developing libraries that interact with Rails, or any other large project, it can be difficult to know if you are compatible with any specific version, and to make sure you remain compatible.
+
+isolate (http://github.com/jbarnette/isolate) was released as a way to help sandbox the gems available to your project. This is pretty great, because it lets you know for sure that only the gems as well as the specific version you care about.
+
+The only thing this is missing is the ability to define the gem version scenarios you care about, and be able run your test suite against each scenario. And that is where isolate-scenarios comes into place.
+
+== Getting started
+
+You need the gem first:
+
+  gem install isolate-scenarios
+
+Now head over to your project. There are two additions you'll need. First, you need an IsolateScenario file, which describes your gem dependencies, as well as the gem you'll want to test different versions of:
+
+ baseline do
+   # This is the same syntax as isolate's Isolate file
+   gem 'puppet', '= 0.24.8'
+   gem 'facter', '>= 1.5.4'
+   gem 'highline', '>= 1.5.0'
+   gem 'builder', '>= 2.1.2'
+ end
+
+ # This is the gem we'll be testing different versions of
+ # first arg is the gem name, and all other args are versions to test
+ gem_version_scenario 'activesupport',
+   '2.1.2',
+   '2.2.3',
+   '2.3.5',
+   '2.3.8',
+   '3.0.0.beta4'
+
+To verify this is setup, you can use 'isolate-scenarios list' to show them:
+
+ activesupport:
+ * 2.1.2
+ * 2.2.3
+ * 2.3.5
+ * 2.3.8
+ * 3.0.0.beta4
+
+Next, you'll need to update your test suite's helper, typically spec/spec_helper.rb or test/test_helper.rb. You need to place this line as soon as you can in the file:
+
+  require 'isolate/scenarios/now'
+
+Now, when you run your tests, it will default to using the last version you specified. For example:
+
+  $ rake spec
+  (in shadow_puppet)
+  Activating scenario: activesupport-3.0.0.beta4
+  # omitted
+
+If you want to test against a specific scenario, you can specify it as an environment variable:
+
+  $ rake spec ISOLATE_SCENARIO=2.3.8
+  (in shadow_puppet)
+  Activating scenario: activesupport-2.3.8
+  # omitted
+   
+This is cool and all, but we still would love to test all the scenarios in one shot. 'isolate-scenarios rake' lets you just do that. This will iterate over each scenario, and invoke rake with any args you pass it.
+
+
+  $ isolate-scenarios rake spec
+  (in shadow_puppet)
+  Activating scenario: activesupport-2.1.2
+  # omitted
+
+  (in shadow_puppet)
+  Activating scenario: activesupport-2.2.3
+  # omitted
+
+  (in shadow_puppet)
+  Activating scenario: activesupport-2.3.5
+  # omitted
+
+  (in shadow_puppet)
+  Activating scenario: activesupport-2.3.8
+  # omitted
+
+== Limitations
+
+Most projects I've worked on that need something like this only vary across one gem. As a result, gem_version_scenario only works for specifying one gem that varies. I tried coming up for some better defining multiple ones, but not having run into that situation, I passed for now.
+
+Some of the API may be slightly limited because I was going for the simplest case that worked to test in isolation for a project. The 'now!' method, and others, aren't nearly as flexible as isolate proper.
+
+There can be a bit of redudancy in gem dependency, ie you might specify them in your Rakefile via jeweler, or in Gemfile, or in Isolate, etc. isolate-scenarios doesn't try to reduce that redudancy at all yet.
+
+0 tests. I'm sorry, but I'm a bad bad man wanting to spike out an initial version. I'm pretty much sure I'll be rewriting parts of this, and having tests going forward.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 Joshua Nichols. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,48 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "isolate-scenarios"
+    gem.version = "0.0.2"
+    gem.summary = %Q{Tool for testing libraries using different senarios of gem versions}
+    gem.description = %Q{Tool for testing libraries using different senarios of gem versions}
+    gem.email = "josh@technicalpickles.com"
+    gem.homepage = "http://github.com/technicalpickles/isolate-scenarios"
+    gem.authors = ["Joshua Nichols"]
+    gem.add_dependency "thor"
+    gem.add_dependency "isolate"
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "isolate-scenarios #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/bin/isolate-scenarios

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require 'isolate/scenarios'
+
+Isolate::Scenarios::Cli.start

data/isolate-scenarios.gemspec

@@ -0,0 +1,68 @@
+# 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{isolate-scenarios}
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Joshua Nichols"]
+  s.date = %q{2010-07-01}
+  s.default_executable = %q{isolate-scenarios}
+  s.description = %q{Tool for testing libraries using different senarios of gem versions}
+  s.email = %q{josh@technicalpickles.com}
+  s.executables = ["isolate-scenarios"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "IsolateScenarios",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "bin/isolate-scenarios",
+     "isolate-scenarios.gemspec",
+     "lib/isolate-scenarios.rb",
+     "lib/isolate/scenarios.rb",
+     "lib/isolate/scenarios/cli.rb",
+     "lib/isolate/scenarios/now.rb",
+     "lib/isolate/scenarios/sandbox.rb",
+     "spec/isolate-scenarios_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/technicalpickles/isolate-scenarios}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Tool for testing libraries using different senarios of gem versions}
+  s.test_files = [
+    "spec/isolate-scenarios_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_runtime_dependency(%q<thor>, [">= 0"])
+      s.add_runtime_dependency(%q<isolate>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+    else
+      s.add_dependency(%q<thor>, [">= 0"])
+      s.add_dependency(%q<isolate>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    end
+  else
+    s.add_dependency(%q<thor>, [">= 0"])
+    s.add_dependency(%q<isolate>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+  end
+end
+

data/lib/isolate/scenarios/cli.rb

@@ -0,0 +1,30 @@
+require 'thor'
+module Isolate
+  module Scenarios
+    class Cli < Thor
+      include Thor::Actions
+
+      desc "list", "list scenarios"
+      def list
+        sandbox = Isolate::Scenarios::Sandbox.new
+
+        puts "#{sandbox.gem_to_vary}:"
+        sandbox.versions.each do |version|
+          puts "* #{sandbox.gem_to_vary}-#{version}"
+        end
+      end
+
+      desc "rake", "rake for each scenarios"
+      def rake(*)
+        ARGV.delete('rake')
+
+        sandbox = Isolate::Scenarios::Sandbox.new
+
+        sandbox.versions.each do |version|
+          system "rake ISOLATE_SCENARIO=#{sandbox.gem_to_vary}-#{version} #{ARGV.join(' ')}"
+        end
+      end
+    end
+
+  end
+end

data/lib/isolate/scenarios/now.rb

@@ -0,0 +1,2 @@
+require 'isolate/scenarios'
+Isolate::Scenarios.now!

data/lib/isolate/scenarios/sandbox.rb

@@ -0,0 +1,43 @@
+module Isolate
+  module Scenarios
+    class Sandbox
+      attr_accessor :gem_to_vary, :versions
+
+      def current_scenario
+        if ENV['ISOLATE_SCENARIO']
+          scenario = versions.detect do |version|
+            ENV['ISOLATE_SCENARIO']== "#{gem_to_vary}-#{version}"
+          end
+          scenario || raise("No scenario defined for #{ENV['ISOLATE_SCENARIO']}")
+        else
+          versions.last
+        end
+      end
+
+      def initialize
+        file = "IsolateScenarios"
+        instance_eval IO.read(file), file, 1
+      end
+
+      def baseline(&block)
+        @baseline_sandbox = Isolate::Sandbox.new(&block)
+      end
+
+      def gem_version_scenario(gem, *versions)
+        @gem_to_vary = gem
+        @versions = versions.flatten
+      end
+
+      def activate
+        puts "Activating scenario: #{gem_to_vary}-#{current_scenario}"
+
+        @baseline_sandbox ||= Isolate::Sandbox.new
+        @baseline_sandbox.gem gem_to_vary, current_scenario
+
+        @baseline_sandbox.activate(Isolate.env)
+      end
+
+    end
+  end
+end
+

data/lib/isolate/scenarios.rb

@@ -0,0 +1,12 @@
+require 'isolate'
+require 'isolate/scenarios/sandbox'
+require 'isolate/scenarios/cli'
+
+module Isolate
+  module Scenarios
+    def self.now!
+      @@sandbox = Isolate::Scenarios::Sandbox.new
+      @@sandbox.activate
+    end
+  end
+end

data/lib/isolate-scenarios.rb

@@ -0,0 +1 @@
+require 'isolate/scenarios'

data/spec/isolate-scenarios_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Isolate::Scenarios do
+  it "doesn't have test" do
+    fail "I'm a naughty little project without tests"
+  end
+end

data/spec/spec.opts

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

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'spec'
+require 'spec/autorun'
+
+require 'isolate-scenarios'
+Isolate::Scenarios.now!
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification 
+name: isolate-scenarios
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Joshua Nichols
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-01 00:00:00 -04:00
+default_executable: isolate-scenarios
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: thor
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: isolate
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id003
+description: Tool for testing libraries using different senarios of gem versions
+email: josh@technicalpickles.com
+executables: 
+- isolate-scenarios
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- IsolateScenarios
+- LICENSE
+- README.rdoc
+- Rakefile
+- bin/isolate-scenarios
+- isolate-scenarios.gemspec
+- lib/isolate-scenarios.rb
+- lib/isolate/scenarios.rb
+- lib/isolate/scenarios/cli.rb
+- lib/isolate/scenarios/now.rb
+- lib/isolate/scenarios/sandbox.rb
+- spec/isolate-scenarios_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/technicalpickles/isolate-scenarios
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Tool for testing libraries using different senarios of gem versions
+test_files: 
+- spec/isolate-scenarios_spec.rb
+- spec/spec_helper.rb