Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/terceiro/gemset

Simple management tool for different sets of Rubygems
https://github.com/terceiro/gemset

Last synced: about 1 month ago
JSON representation

Simple management tool for different sets of Rubygems

Awesome Lists containing this project

README 

        
=head1 gemset - manage different sets of Rubygems on your system



gemset is a simple solution for having different sets of Rubygems

installed, and switching between them.



=head1 Features/Bugs



Works no matter which interactive shell you use: bash, zsh, csh, tcsh,

fish etc, are all welcome.



Works outside of interactive shells. For example, if you change your

default gemset even GUI applications started without a shell will have

access to that gemset you changed to.



Works with Bundler.



It only depends on having I in your $PATH.  If you want to manage

the installations of different ruby interpreters, you can use rbenv or

RVM. gemset will manage gem sets for the current I, so each

interpreter have its separate gem sets.



=head1 Installation



Simplest method: just copy the I script into your I<$PATH>.



You can also install using GNU autotools, using a release tarball:



  $ ./configure && make && sudo make install



Or from the git repository (you will need autoreconf):



  $ autoreconf -i && ./configure && make && sudo make install



=head1 Usage



Preparing the environment:



  $ gemset setup

  Now using gemset "default".



If you already have any gems installed, your current environment will be

made the "default" gemset:



  $ gemset setup

  Your current Rubygems environment was moved to a gemset named "default".

  Now using gemset "default".



Creating and using a gemset:



  $ gemset create rails3

  $ gemset use rails3

  Now using gemset "rails3".

  $ gem install rails3

  [...]

  $ gem list



  *** LOCAL GEMS ***



  abstract (1.0.0)

  actionmailer (3.0.0)

  actionpack (3.0.0)

  activemodel (3.0.0)

  activerecord (3.0.0)

  activeresource (3.0.0)

  activesupport (3.0.0)

  arel (1.0.1)

  builder (2.1.2)

  bundler (1.0.0)

  erubis (2.6.6)

  i18n (0.4.1)

  mail (2.2.6)

  mime-types (1.16)

  polyglot (0.3.1)

  rack (1.2.1)

  rack-mount (0.6.13)

  rack-test (0.5.4)

  rails (3.0.0)

  railties (3.0.0)

  rake (0.8.7)

  ruby-prof (0.9.2)

  sqlite3-ruby (1.3.1)

  thor (0.14.0)

  treetop (1.4.8)

  tzinfo (0.3.23)



Now changing back to the default gemset:



  $ gemset use default

  Now using gemset "default".

  $ gem list



  *** LOCAL GEMS ***



  bundler (1.0.0)



Listing existing gemsets (the gemset currently in use is marked with an

`*` and printed in green):



  $ gemset list

  * default

    empty

    noosfero

    rails3



Inspecting gemset capabilities:



  $ gemset  usage

  gemset - manage different sets of Rubygems on your system



  Usage:



    gemset list                lists the existing gemsets.

    gemset create [NAME]       creates a new gemset

    gemset remove [NAME]       removes an existing gemset

    gemset show [NAME]         shows the gems installed in a gemset

    gemset use [NAME]          change to using an existing gemset

    gemset help                displays usage information



=head1 Hacking



To run the tests:



  $ bundle install

  $ ruby test/runtests.rb



=head1 Copyright



Copyright © 2010-2011, Antonio Terceiro 



This program is free software: you can redistribute it and/or modify

it under the terms of the GNU General Public License as published by

the Free Software Foundation, either version 3 of the License, or

(at your option) any later version.



This program is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

GNU General Public License for more details.



You should have received a copy of the GNU General Public License

along with this program.  If not, see .