Rubyのソースを表示

[[Category:プログラミング言語]]
[[en:Ruby]]
[[zh-CN:Ruby]]
{{Related articles start}}
{{Related|Ruby on Rails}}
{{Related articles end}}
Ruby はシンプリシティと生産性に重点を置いた、オープンソースの動的なスクリプト言語です。

== Ruby のインストール ==
最新版の Ruby をインストールするには、{{Pkg|ruby}} パッケージを[[インストール]]してください。これには、[[#RubyGems|RubyGems]] が含まれています。

=== 旧バージョン ===

* Ruby 2.2 をインストールするには、{{AUR|ruby2.2}} をインストールしてください。
* Ruby 2.1 をインストールするには、{{Pkg|ruby2.1}} をインストールしてください。
* Ruby 2.0 をインストールするには、{{AUR|ruby2.0}} をインストールしてください。

=== 複数のバージョン ===
同じシステム上で複数のバージョン (例: 2.0.0-p0 と 1.9.3-p392) を動作させたい場合、一番簡単な方法は [[RVM]], {{AUR|chruby}}, [[rbenv]] を使うことです。

=== ドキュメント ===

{{ic|ri}} コマンドラインツールでドキュメントを見るには、{{Pkg|ruby-docs}} をインストールしてください。次のようにドキュメントを回覧できます: {{ic|ri Array}}, {{ic|ri Array.pop}} など (man-page と同じような感じです)。

== RubyGems ==
RubyGems は Ruby のモジュール (Gem と呼ばれます) のためのパッケージマネージャで、Arch Linux における [[pacman]] に（多少は）相当します。上述の通り {{pkg|ruby}} に含まれています。

=== セットアップ ===

RubyGems を使用する前に、{{ic|$(ruby -e "print Gem.user_dir")/bin}} を {{ic|$PATH}} に追加してください。以下の行を {{ic|~/.bashrc}} に記述してください:
 PATH="$(ruby -e 'print Gem.user_dir')/bin:$PATH"

ライブラリはパスを修正しなくても動作しますが、フルパスを入力することなく gem を実行するには上記の設定が必須です。

If the method above does not work, you can try adding these lines at the end of your shell configuration file instead:
  
  #Setting the GEM_PATH and GEM_HOME variables may not be necessary, check 'gem env' output to verify whether both variables already exist 
  GEM_HOME=$(ls -t -U | ruby -e 'puts Gem.user_dir')
  GEM_PATH=$GEM_HOME
  export PATH=$PATH:$GEM_HOME/bin

=== 使用方法 ===
インストールされている gem を確認するには:
 $ gem list

gem についての情報を得るには:
 $ gem spec ''gem_name''

デフォルトで、{{ic|gem list}} や {{ic|gem spec}} は {{ic|--local}} オプションを使います。つまりローカルのシステムだけで ''gem'' を検索します。これを {{ic|--remote}} フラグで上書きすることが可能です。そう、例えば mysql の gem を検索するには:
 $ gem list --remote mysql

gem をインストールするには:
 $ gem install mysql

ローカルのドキュメントが必要ない場合はスピードアップすることができます:
 $ gem install mysql --no-document

{{Note|{{ic|~/.gemrc}} ファイルを以下のように設定することでオプションをデフォルトにすることが可能ですfile:
{{hc|~/.gemrc|<nowiki>
gem: --no-document
</nowiki>}}}}

インストールされている gem を全てアップデートするには:
 $ gem update

=== gem をユーザー個別またはシステム共通でインストール ===

Arch Linux ではデフォルトで、{{ic|gem}} を実行したとき、gem はシステム共通 ({{ic|/usr/lib/ruby/gems/}}) ではなくユーザー個別 ({{ic|~/.gem/ruby/}}) にインストールされます。システム共通でインストールすると Pacman でインストールした gem と干渉する可能性があるため、Arch で gem を管理するときはユーザー個別のほうが適しているとされています。

{{ic|--no-user-install}} フラグを付けて {{ic|gem}} コマンドを root で実行することで Gem をシステム共通でインストールすることができます。{{ic|/etc/gemrc}} (システム共通) または {{ic|~/.gemrc}} (ユーザー個別、システム共通設定を上書きします) にある {{ic|--user-install}} を {{ic|--no-user-install}} で置き換えることでこのフラグをデフォルトで設定可能です。

[[#Bundler|Bundler]] は gem をあなたのアプリケーションにパッケージングすることでこの問題をある程度解決します。bundler を使用するにあたって下のセクションを見て下さい。

=== Bundler ===
[http://bundler.io Bundler] を使うことであなたのアプリケーションが依存している gem はどれか、さらに（任意で）その gem のバージョンは何でなければならないかを指定することができます。この記述があると、Bundler は必要な gem を全て (完全な gem の依存ツリーを含む) インストールして、後の点検のために結果をログに残します。デフォルトで、Bundler は gem を共有の場所にインストールしますが、あなたのアプリケーションに直接インストールすることも可能です。あなたのアプリケーションが実行されると、複数のバージョンの gem がインストールされている時でも、Bundler はそれぞれの gem の正しいバージョンを与えます。これにはわずかばかりの作業が必要です: アプリケーションは {{ic|bundle exec}} で呼び出される必要があり、あなたのアプリケーションのメインの実行ファイルに2行のボイラープレートコード（おまじない）を入れなくてはなりません。

Bundler をインストールするには:
 $ gem install bundler

デフォルトで、Bundler は gem をシステム全体にインストールします。これは Arch での ''gem'' それ自体の挙動とは反対です。これを正すには、次を {{ic|~/.bashrc}} に追加してください:
 export GEM_HOME=$(ruby -e 'print Gem.user_dir')

新しい bundle を始めるには:
 $ bundle init

次に ({{ic|bundle init}} によって作成された) 作業ディレクトリ内の {{ic|Gemfile}} を編集して必要な gem を記載してください:
{{hc|Gemfile|
gem "rails", "3.2.9"
gem "mysql"
}}

次を実行して gem を {{ic|GEM_HOME}} にインストールしてください:
 $ bundle install

もしくは、次を実行して gem を作業ディレクトリ内の {{ic|.bundle}} にインストールしてください:
 $ bundle install --path .bundle

あなたのメインの実行ファイルを編集するのを忘れないで下さい:
{{bc|#!/usr/bin/env ruby

# "This will automatically discover your Gemfile, and make all of the gems in
# your Gemfile available to Ruby." http://bundler.io/rationale.html

require 'bundler/setup'

...
}}

最後に、あなたのプログラムを実行して下さい:
{{bc|bundle exec <main_executable_name.rb>}}

== pacman を使って RubyGems を管理する ==

{{ic|gem}} を使って gem を管理する代わりに、{{ic|pacman}} や [[AUR]] ヘルパーを使うこともできます。Ruby パッケージは ruby-[gemname] という命名規則にしたがっています。この方法では以下の利点があります:

* システムの他の部分と一緒に Gem が更新されます。その結果、{{ic|gem update}} を実行する必要がなくなります: {{ic|# pacman -Syu}} だけで更新可能です。
* インストールした gem は、インストールしたユーザーだけでなく、システム全体で使うことができます。

gem が AUR に存在しない場合は、{{AUR|gem2arch}} や {{AUR|pacgem}} を使って自動的にパッケージを作成し、pacman でインストールできます。

==== Quarry ====

Quarry は Arch Linux のための [http://rubygems.org rubygems] バイナリリポジトリを運営するためのオープンソースツール (GPL3 ライセンス) です。ソースは [https://github.com/anatol/quarry github] でホストされています。

Arch の開発者 anatolik によって非公式の rubygems リポジトリが http://pkgbuild.com/~anatolik/quarry/ で運営されており、いまのところ x86 アーキテクチャのみサポートしています。このリポジトリには多数の人気 gem が含まれており、gem を追加するようリクエストを送ることもできます。バイナリパッケージリポジトリは AUR のソースパッケージよりも簡単に使用することが可能です。

リポジトリを有効にする方法は [[非公式ユーザーリポジトリ#quarry]] を見て下さい。

有効にしたら必要な gem をインストールしてください: {{ic|# pacman -S ruby-$gemname}}。

質問がありましたら、プロジェクトアナウンスに送って下さい: https://bbs.archlinux.org/viewtopic.php?id=182729<br>
バグレポートやコードの改善は github で送って下さい: https://github.com/anatol/quarry

== 参照 ==
* Ruby - http://ruby-lang.org/
* Bundler - http://bundler.io/