RubyGemsは、Rubyのパッケージ管理ツール。PerlのCPAN、PHPのPearみたいなの。

• RubyForge: RubyGems
• Rubyist Magazine - シリーズ パッケージマネジメント 【第 1 回】 RubyGems (1)

WindowsのActiveScriptRubyは、最初からgemsがインストールされている。

MacOSX 10.6では最初からインストールされているが、Appleの都合でいつ変えられるか分からないのでMacPortsでRubyと一緒に入れるのが良い。

port install ruby
port install rb-rubygems

// hogeをインストール
gem install hoge

// インストールされたパッケージ一覧
gem list

// 名前にfugaを含むインストール済みパッケージを探す
gem search fuga

// ネットワーク上のライブラリを探す
gem search --remote fuga
gem search -r fuga

// パッケージfugaをアップデート
gem update fuga

// パッケージfugaの古いバージョンを削除
gem cleanup fuga

// gems自身をアップデート
gem update --system

// gemsのバージョン
gem --version
gem -v

gem -v '= 2.0.0'  # v2.0.0を入れる
gem -v '>= 2.0.0' # v2.0.0以降を入れる

gem -v '~> 2.0.0' # 2.0.xの最新版を入れる
gem -v '~> 2.0' # 2.xの最新版を入れる

// ヘルプ（これ覚えておけばこのページ見る必要ないよ）
gem --help
gem -h

// コマンド一覧を表示
gem help commands

Cベースのmysqlコネクタを入れる。mysqlの場所が見つからなくてエラーになる場合の対処法、MacOSXにMySQL公式のバイナリインストーラでMySQL5をインストールしている場合

$ sudo gem install mysql -- --with-mysql-config=/usr/local/mysql/bin/mysql_config 

Rubygems自体のアップデートを管理するパッケージ。

今は gem update –system を使わない。

最新版にする。

$ sudo gem rubygems-update
$ sudo update_rubygems

バージョンを指定する。

$ sudo gem rubygems-update -v=1.3.6
$ sudo update_rubygems --version=1.3.6

gem rubygems-update でインストール、update_rubygems で切り替え

for ActiveScriptRuby 1.8.6

ActiveScriptRubyでgem update –systemすると作成されるC:\Program Files\ruby-1.8\bin\gem.batが間違っているので修正する

@ECHO OFF
IF NOT "%~f0" == "~f0" GOTO :WinNT
@"ruby.exe"" "C:/Program Files/Ruby-1.8/bin/gem" %1 %2 %3 %4 %5 %6 %7 %8 %9
GOTO :EOF
:WinNT
@"ruby.exe"" "%~dpn0" %*

２カ所あるruby.exeの後ろにダブルクオートが2つ付いているので取る。

for Ruby 1.8.6 and Ubuntu 8.04

aptitudeでrb-rubygemsを入れた後に、gem update –systemするとgemがエラーを吐くようになる。gem1.8というコマンドが作られているのでそちらを使う。

$ gem1.8

オリジナルのgemは要らんが、aptitudeでremoveしようとするとirb等が消されて不便なので残しておいてもいいかも。

Ruby 1.8 on Ubuntu 9.04

例えばgemでrailsをインストールしてもrailsコマンドが見つからないが、単純にパスが通っていないだけ。

$ sudo gem install rails
$ rails -v
プログラム 'rails' はまだインストールされていません。  次のように入力することでインストールできます:
sudo apt-get install rails

$ export PATH=$PATH:/var/lib/gems/1.8/bin

$ rails -v
Rails 2.3.4

gemパッケージを自分で作る方法、newgemというライブラリを使うと簡単に作成できる。

インストール

$ gem install newgem

するとnewgemというコマンドが作られる。

$ newgem

Rubyのライブラリを作る場所で

$ newgem hoge -T spec 

hogeディレクトリが作成され、その中にライブラリ、rakeタスク等が作成される。-Tオプションでテストライブラリを指定、デフォルトTest::Unit、-T rspecでRSpecを指定。

rakeでテストを実行

$ rake test
$ rake spec

rakeでgemパッケージをビルド

$ rake package

既に開発中のものにnewgemを適用することもできる。hogeというライブラリを作成しているなら、

hoge/lib/hoge.rb
hoge/spec/hoge_spec.rb

のようなディレクトリ構成にしておき hoge ディレクトリの上で

$ newgem hoge -T rspec

とする。ヘルパやrakeタスクなどが作られる。hoge.rbやhoge_spec.rbを上書きしようとするので、一度退避させて後でマージするのが吉