ruby-virtualenv 0.5.0

data/.autotest

@@ -0,0 +1,13 @@
+Autotest.add_hook :initialize do |at|
+  
+  # Ignore the ._* files TextMate likes to leave about.
+  at.add_exception(/\/\._[^\/]*$/)
+  
+  %w{ .git .svn svn-commit .DS_Store
+      .autotest Rakefile Capfile README doc
+      spec/spec.opts spec/rcov.opts
+    }.each { |exception| at.add_exception( exception ) }
+  
+  at.find_directories = [ 'lib', 'spec' ]
+  
+end

data/.gitignore

@@ -0,0 +1,6 @@
+pkg
+doc
+coverage
+tmp
+Manifest
+.DS_Store

data/CHANGELOG

@@ -0,0 +1,17 @@
+v0.5.0 Forked and renamed the project
+  Current rubygem name "sandbox" has already been taken, so we have
+  renamed the project to "ruby-virtualenv".
+
+  Cleaned and refactored code.
+
+  Updated gem stuff.
+
+v0.2.0 Functional basic version.
+  Requires rubygems and only installs environment (with optional gem installs).
+
+v0.1.2 Branched fullversion from master.
+  Full version will include ruby and rubygems installs.
+
+v0.1.1 Adding rspec and cucumber
+ 
+v0.1.0 First version

data/Gemfile

@@ -0,0 +1,4 @@
+source 'http://rubygems.org'
+
+# Specify your gem's dependencies in ruby-virtualenv.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,28 @@
+PATH
+  remote: .
+  specs:
+    ruby-virtualenv (0.5.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.3)
+    metaclass (0.0.1)
+    mocha (0.10.0)
+      metaclass (~> 0.0.1)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  mocha (~> 0.10.0)
+  rspec (~> 2.6.0)
+  ruby-virtualenv!

data/README.md

@@ -0,0 +1,120 @@
+Sandbox
+=======
+
+* http://github.com/nkryptic/sandbox
+
+DESCRIPTION:
+------------
+
+Inspired by Python's [virtualenv](http://pypi.python.org/pypi/virtualenv)
+project, Ruby-Virtualenv is a utility to create sandboxed Ruby/Rubygems
+environments.
+
+It is meant to address the following issues:
+
+* Conflicts with unspecified gem dependency versions.
+* Applications can have their own gem repositories.
+* Permissions for installing your own gems.
+* Ability to try gems out without installing into your global repository.
+* A Simple way to enable this.
+
+Running from your own gem repositories is fairly straight-forward, but
+managing the necessary environment is a pain. This utility will create
+a new environment which may be activated by the script `bin/activate` in
+your sandbox directory.
+
+Run the script with the following to enable your new environment:
+
+    $ source bin/activate
+
+When you want to leave the environment:
+
+    $ deactivate
+
+NOTES:
+------
+
+* It creates an environment that has its own installation directory for Gems.
+* It doesn't share gems with other sandbox environments.
+* It (optionally) doesn't use the globally installed gems either.
+* It will use a local to the sandbox .gemrc file
+
+FEATURES/PROBLEMS:
+------------------
+
+Activating your sandbox environment will change your HOME directory
+temporarily to the sandbox directory. Other environment variables are
+set to enable this funtionality, so if you may experience odd behavior.
+Everything should be reset when you deactivate the sandbox.
+
+USAGE:
+------
+
+Create a new virtualenv (verbose output by default):
+
+    $ ruby-virtualenv ~/.ruby-virtualenvs/my-new-sandbox
+    creating new sandbox in /home/nkryptic/ruby-projects/my-new-sandbox
+    installing activation script
+    installing .gemrc
+    installing gems:
+      nothing to do
+
+Create a new sandbox with no output:
+
+    $ ruby-virtualenv ~/.ruby-virtualenvs/my-new-sandbox -q
+
+Create a new sandbox with specific gems:
+
+    $ ruby-virtualenv ~/.ruby-virtualenvs/my-new-sandbox -g rake,rails
+    creating new sandbox in /home/nkryptic/ruby-projects/my-new-sandbox
+    installing activation script
+    installing .gemrc
+    installing gems:
+      gem: rake
+      gem: rails
+
+FUTURE PLANS:
+-------------
+
+I hope to expand the full version branch to allow for installing both
+rubygems and ruby as part of the sandbox. This would enable experimentation
+with different versions of both and exclude the requirement on needing
+rubygems in the first place.
+
+REQUIREMENTS:
+-------------
+
+* ruby
+* rubygems
+
+INSTALL:
+--------
+
+    $ gem install ruby-virtualenv
+
+LICENSE:
+--------
+
+(The MIT License)
+
+Copyright (c) 2011 Francesc Esplugas
+Copyright (c) 2008 Jacob Radford
+
+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/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/TODO

@@ -0,0 +1,68 @@
+TODO: fix dependencies in rake files
+TODO: put in timeout when installing gems
+TODO: check for network connection
+TODO: perhaps look in installed rubygems cache first
+TODO: make rubygems dependency fail immediately and gracefully?
+      * in bin/sandbox?
+TODO: replace backticks for gem installs with open4 library?
+TODO: allow for sandbox to be rerun against existing sandbox to update it?
+TODO: test against various OS platforms
+      * BSD
+      * OSX
+      * Gentoo
+      * Debian/Ubuntu
+      * Could it work on Windows?
+      * ?
+TODO: test against other shells
+      * csh
+      * zsh
+TODO: test against other ruby versions?
+      * jruby
+TODO: allow gem versions to be specified when installing
+TODO: better documentation
+      * of the codebase
+      * in the readme
+TODO: improve ui output
+      * use verbosity level
+      * include more messages about status
+TODO: user config
+      * set list of ruby variants to query?
+      * list of gems to install
+          ~/.sandbox/config
+TODO: allow for install of ruby/rubygems
+      * how
+        * select dynamically?
+        * preset in config file?
+      * MRI, JRuby, Rubinius?
+        * each would have their own install method
+        * rubygems install would vary then
+TODO: perhaps the following could be added to the activate script???
+      # function not_sourced() {
+      #   ## ZSH source check
+      #   test -n "$ZSH_NAME" -a "$HISTCMD" = "0" && return 0
+      #   ## BASH source check
+      #   test "`basename $1 2>/dev/null`" = "activate" && return 0
+      #   ## script was not sourced
+      #   return 1
+      # }
+      # function exit_with_warning() {
+      #   echo "You must source this script (ie. source bin/activate)"
+      #   exit 1
+      # }
+      # not_sourced $0 && exit_with_warning
+      # unset not_sourced
+      # unset exit_with_warning
+      
+      # OTHER WAYS
+      # ====
+      # ONLY WORKS FOR BASH
+      # if [[ "$BASH_SOURCE" == "$0" ]]
+      # then
+      #    echo "script was executed, not sourced"
+      # fi
+      # ====
+      # COULD WORK FOR BASH:
+      # if [ -n `readlink -f $0` ]; then
+      #    echo "script was executed, not sourced"
+      # fi
+

data/bin/ruby-virtualenv

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.dirname(__FILE__) + '/../lib') unless $:.include?(File.dirname(__FILE__) + '/../lib')
+
+require 'sandbox/cli'
+Sandbox::CLI.execute(ARGV)

data/features/development.feature

@@ -0,0 +1,13 @@
+Feature: Development processes of newgem itself (rake tasks)
+
+  As a Newgem maintainer or contributor
+  I want rake tasks to maintain and release the gem
+  So that I can spend time on the tests and code, and not excessive time on maintenance processes
+    
+  Scenario: Generate RubyGem
+    Given this project is active project folder
+    And 'pkg' folder is deleted
+    When task 'rake gem' is invoked
+    Then folder 'pkg' is created
+    And file with name matching 'pkg/*.gem' is created else you should run "rake manifest" to fix this
+    And gem spec key 'rdoc_options' contains /--mainREADME.rdoc/

data/features/steps/common.rb

@@ -0,0 +1,174 @@
+def in_project_folder(&block)
+  project_folder = @active_project_folder || @tmp_root
+  FileUtils.chdir(project_folder, &block)
+end
+
+def in_home_folder(&block)
+  FileUtils.chdir(@home_path, &block)
+end
+
+Given %r{^a safe folder} do
+  FileUtils.rm_rf   @tmp_root = File.dirname(__FILE__) + "/../../tmp"
+  FileUtils.mkdir_p @tmp_root
+  FileUtils.mkdir_p @home_path = File.expand_path(File.join(@tmp_root, "home"))
+  @lib_path = File.expand_path(File.dirname(__FILE__) + '/../../lib')
+  Given "env variable $HOME set to '#{@home_path}'"
+end
+
+Given %r{^this project is active project folder} do
+  Given "a safe folder"
+  @active_project_folder = File.expand_path(File.dirname(__FILE__) + "/../..")
+end
+
+Given %r{^env variable \$([\w_]+) set to '(.*)'} do |env_var, value|
+  ENV[env_var] = value
+end
+
+def force_local_lib_override(project_name = @project_name)
+  rakefile = File.read(File.join(project_name, 'Rakefile'))
+  File.open(File.join(project_name, 'Rakefile'), "w+") do |f|
+    f << "$:.unshift('#{@lib_path}')\n"
+    f << rakefile
+  end
+end
+
+def setup_active_project_folder project_name
+  @active_project_folder = File.join(@tmp_root, project_name)
+  @project_name = project_name
+end
+
+Given %r{'(.*)' folder is deleted} do |folder|
+  in_project_folder do
+    FileUtils.rm_rf folder
+  end
+end
+
+When %r{^'(.*)' generator is invoked with arguments '(.*)'$} do |generator, arguments|
+  FileUtils.chdir(@active_project_folder) do
+    if Object.const_defined?("APP_ROOT")
+      APP_ROOT.replace(FileUtils.pwd)
+    else 
+      APP_ROOT = FileUtils.pwd
+    end
+    run_generator(generator, arguments.split(' '), SOURCES)
+  end
+end
+
+When %r{run executable '(.*)' with arguments '(.*)'} do |executable, arguments|
+  @stdout = File.expand_path(File.join(@tmp_root, "executable.out"))
+  FileUtils.chdir(@active_project_folder) do
+    system "ruby #{executable} #{arguments} > #{@stdout}"
+  end
+end
+
+When %r{^task 'rake (.*)' is invoked$} do |task|
+  @stdout = File.expand_path(File.join(@tmp_root, "tests.out"))
+  FileUtils.chdir(@active_project_folder) do
+    system "rake #{task} --trace > #{@stdout} 2> #{@stdout}"
+  end
+end
+
+Then %r{^folder '(.*)' is created} do |folder|
+  in_project_folder do
+    File.exists?(folder).should be_true
+  end
+end
+
+Then %r{^file '(.*)' (is|is not) created} do |file, is|
+  in_project_folder do
+    File.exists?(file).should(is == 'is' ? be_true : be_false)
+  end
+end
+
+Then %r{^file with name matching '(.*)' is created} do |pattern|
+  in_project_folder do
+    Dir[pattern].should_not be_empty
+  end
+end
+
+Then %r{gem file '(.*)' and generated file '(.*)' should be the same} do |gem_file, project_file|
+  File.exists?(gem_file).should be_true
+  File.exists?(project_file).should be_true
+  gem_file_contents = File.read(File.dirname(__FILE__) + "/../../#{gem_file}")
+  project_file_contents = File.read(File.join(@active_project_folder, project_file))
+  project_file_contents.should == gem_file_contents
+end
+
+Then %r{^output same as contents of '(.*)'$} do |file|
+  expected_output = File.read(File.join(File.dirname(__FILE__) + "/../expected_outputs", file))
+  actual_output = File.read(File.dirname(__FILE__) + "/../../tmp/#{@stdout}")
+  actual_output.should == expected_output
+end
+
+Then %r{^(does|does not) invoke generator '(.*)'$} do |does_invoke, generator|
+  actual_output = File.read(File.dirname(__FILE__) + "/../../tmp/#{@stdout}")
+  does_invoke == "does" ?
+    actual_output.should(match(/dependency\s+#{generator}/)) :
+    actual_output.should_not(match(/dependency\s+#{generator}/))
+end
+
+Then %r{help options '(.*)' and '(.*)' are displayed} do |opt1, opt2|
+  actual_output = File.read(@stdout)
+  actual_output.should match(/#{opt1}/)
+  actual_output.should match(/#{opt2}/)
+end
+
+Then %r{^output (does|does not) match \/(.*)\/} do |does, regex|
+  actual_output = File.read(@stdout)
+  (does == 'does') ?
+    actual_output.should(match(/#{regex}/)) :
+    actual_output.should_not(match(/#{regex}/)) 
+end
+
+Then %r{^contents of file '(.*)' (does|does not) match \/(.*)\/} do |file, does, regex|
+  in_project_folder do
+    actual_output = File.read(file)
+    (does == 'does') ?
+      actual_output.should(match(/#{regex}/)) :
+      actual_output.should_not(match(/#{regex}/))
+  end
+end
+
+Then %r{^all (\d+) tests pass} do |expected_test_count|
+  expected = %r{^#{expected_test_count} tests, \d+ assertions, 0 failures, 0 errors}
+  actual_output = File.read(@stdout)
+  actual_output.should match(expected)
+end
+
+Then %r{^all (\d+) examples pass} do |expected_test_count|
+  expected = %r{^#{expected_test_count} examples?, 0 failures}
+  actual_output = File.read(@stdout)
+  actual_output.should match(expected)
+end
+
+Then %r{^yaml file '(.*)' contains (\{.*\})} do |file, yaml|
+  in_project_folder do
+    yaml = eval yaml
+    YAML.load(File.read(file)).should == yaml
+  end
+end
+
+Then %r{^Rakefile can display tasks successfully} do
+  @stdout = File.expand_path(File.join(@tmp_root, "rakefile.out"))
+  FileUtils.chdir(@active_project_folder) do
+    system "rake -T > #{@stdout} 2> #{@stdout}"
+  end
+  actual_output = File.read(@stdout)
+  actual_output.should match(/^rake\s+\w+\s+#\s.*/)
+end
+
+Then %r{^task 'rake (.*)' is executed successfully} do |task|
+  @stdout.should_not be_nil
+  actual_output = File.read(@stdout)
+  actual_output.should_not match(/^Don't know how to build task '#{task}'/)
+  actual_output.should_not match(/Error/i)
+end
+
+Then %r{^gem spec key '(.*)' contains \/(.*)\/} do |key, regex|
+  in_project_folder do
+    gem_file = Dir["pkg/*.gem"].first
+    gem_spec = Gem::Specification.from_yaml(`gem spec #{gem_file}`)
+    spec_value = gem_spec.send(key.to_sym)
+    spec_value.to_s.should match(/#{regex}/)
+  end
+end