History

Sorin Ionescu 9a52ecb21b Increase heading readability		2012-08-04 14:48:32 -04:00
..
init.zsh	Increase heading readability	2012-08-04 14:48:32 -04:00
README.md	[Fix #115 ] Add documentation for ruby	2012-06-12 23:23:22 -04:00

README.md

Ruby

Configures Ruby local gem installation, loads version managers, and defines aliases.

Local Gem Installation

When a Ruby version manager is not detected, local gems are installed in ~/Library/Ruby/Gems/1.8 on Mac OS X.

RVM

An alternative to the above is to use The Ruby Version Manager (RVM), which allows for managing multiple, isolated Ruby installations and gem sets in the home directory.

Since RVM is loaded into the shell and is known to override shell commands, it may conflict with shell scripts.

rbenv

An alternative RVM is to use rbenv, which allows for switching between multiple, isolated Ruby installations in the home directory.

While it is not as feature rich as RVM, it is not loaded into the shell and is not known to cause conflicts with shell scripts.

Bundler

Manage gems that are not meant to be used as commands, such as application dependencies, with Bundler.

Aliases

Bundler

b manages ruby dependencies (bundle).
be executes a script in the context of the current bundle.
bi installs the gems specified in the Gemfile in vendor/bundle.
bI installs the following:
- gems specified in the Gemfile in vendor/bundle.
- packages the gems into vendor/cache.
- appends bundler directories to .gitignore.
bl lists all gems in the current bundle.
bo opens an installed gem in the editor.
bp packages gem files into vendor/cache.
bu updates gems to their latest version.

Authors

The authors of this module should be contacted via the issue tracker.

Sorin Ionescu