Isolate is a very simple RubyGems sandbox. It provides a way to express and automatically install your project's Gem dependencies.
When Isolate runs, it uses GEM_HOME, GEM_PATH, and a few other tricks to separate your code from the system's RubyGems configuration, leaving it free to run in blissful solitude.
Isolate is very, very, very stupid simple. For a much more full-featured Gem bundler, check out Yehuda Katz and Carl Lerche's Bundler: It does a lot of fancy AOT dependency resolution, supports non-gem (including git) resources, and is probably a better fit for you.
RubyGems 1.8.2 or better, Ruby 1.8.7 or better.
require "rubygems" require "isolate/now"
gem "rails", "2.3.5" gem "aasm", "2.0.0" env :development, :test do gem "sqlite3-ruby", "1.2.5" end env :production do gem "memcached", "0.19.2" end
rake environment. Before anything else happens,
Isolate will make sure you have copies of every gem you need (extend the
example above to cover all your dependencies). If they're already
installed on your system Isolate will use them, otherwise a private copy
will be installed under
require "rubygems" require "isolate/now"
Isolate file as above. Be sure to remove any
Don't forget to require files from your isolated gems in the appropriate places. Unlike bundler isolate does not automatically require any files.
Sinatra, Rack, and Anything Else
There's nothing special about Rails, it's just an easy first
example. You can use Isolate with any library or framework by simply
Isolate file in the root of your project and
isolate/now as early as possible in the startup
When you're starting up, Isolate tries to determine its environment by
looking at the
RAILS_ENV env vars. If none are set, it defaults to
If you're using Hoe to manage your library, you can use Isolate's Hoe plugin to automatically install your lib's development, runtime, and test dependencies without polluting your system RubyGems, and run your tests/specs in total isolation.
Assuming you have a recent Hoe and Isolate is installed, it's as simple as putting:
Hoe.spec call in your
If you're not using Hoe, you can use an
at the top of your Rakefile. See the RDoc for details.
Isolate provides a few useful Rake tasks. If you're requiring
isolate/now, you'll get them automatically when you run
Rake. If not, you can include them by requiring
This task shows you the current Isolate settings and gems.
$ rake isolate:env path: tmp/isolate/ruby-1.8 env: development files: Isolate cleanup? true enabled? true install? true multiruby? true system? true verbose? true [all environments] gem rails, = 2.3.5 gem aasm, = 2.0.0 [development, test] gem sqlite3-ruby, = 1.2.5 [production] gem memcached, = 0.19.2
This task allows you to run a subshell or a command in the isolated
environment, making any command-line tools available on your
# run a single command in an isolated subshell $ rake isolate:sh['gem list'] # run a new isolated subshell $ rake isolate:sh
This task lists gems that have a more recent released version than the one you're using.
$ rake isolate:stale aasm (2.0.0 < 2.1.5)
require "isolate/now" is sugar for
Isolate.now!, which creates, configures, and activates a
singleton version of Isolate's sandbox.
a few useful options, and lets you define an entire environment inline
without using an external file.
For detailed information on
Isolate.now! and the rest of the
public API, please see the RDoc.
Not Gonna Happen
config.gemsor other solutions, Isolate expects you to be a good little Rubyist and manually
requirethe libraries you use.
Support for Git or other SCMs. You're welcome to write an extension that supports 'em, but Isolate itself is focused on packaged, released gems.
$ gem install isolate
#isolate on Freenode
- Mailing List
Copyright 2009-2010 John Barnette, et al. ([email protected])
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.