class Gem::DependencyInstaller

要約

ある Gem が依存している Gem を同時にインストールするためのクラスです。

目次

特異メソッド

• new

インスタンスメソッド

• find_gems_with_sources
• find_spec_by_name_and_version
• gather_dependencies
• gems_to_install
• install
• installed_gems

定数

• DEFAULT_OPTIONS

継承しているメソッド

Gem::UserInteractionから継承しているメソッド

• alert
• alert_error
• alert_warning
• ask
• ask_yes_no
• choose_from_list
• say
• terminate_interaction

Gem::DefaultUserInteractionから継承しているメソッド

• ui
• ui=
• use_ui

特異メソッド

new(options = {}) -> Gem::DependencyInstaller[permalink][rdoc][edit]

自身を初期化します。

オプションとして以下のものを利用できます。

:cache_dir

*.gem ファイルを保存するディレクトリを指定します。

:domain

:local (カレントディレクトリのみ検索します), :remote (Gem.sources を検索します), :both (:local, :remote の両方を検索します) のいずれかを指定可能です。

:env_shebang

Gem::Installer.new を参照してください。

:force

バージョンチェックとセキュリティポリシーのチェックを行わずにインストールを実行します。ただし、署名付きの Gem のみをインストールするポリシーが指定されている場合は上記のチェックを実行します。

:format_executable

Gem::Installer.new を参照してください。

:ignore_dependencies

依存している Gem をインストールしません。

:install_dir

Gem をインストールするディレクトリです。

:security_policy

セキュリティポリシーを指定します。

:user_install

false を指定するとユーザのホームディレクトリにインストールしません。 nil を指定するとユーザのホームディレクトリにインストールしようとしますが、警告を表示します。

:wrappers

真を指定するとラッパーをインストールします。偽を指定すると、シンボリックリンクをインストールします。

[SEE_ALSO] Gem::Installer.new, Gem::Installer#install, Gem::Security

インスタンスメソッド

find_gems_with_sources(dep) -> Array[permalink][rdoc][edit]

与えられた条件にマッチする Gem::Specification のインスタンスと URI のペアのリストを返します。

Gem はローカル (Dir.pwd) とリモート (Gem.sources) の両方から検索します。結果は、バージョンの新しい順が先にきます。また、ローカルの Gem も先にきます。

[PARAM] dep:

Gem::Dependency のインスタンスを指定します。

find_spec_by_name_and_version(gem_name, version = Gem::Requirement.default) -> Array[permalink][rdoc][edit]

与えられた Gem の名前とバージョンに関する条件にマッチする Gem::Specification とそれの存在する URI を含む配列を返します。

[PARAM] gem_name:

Gem の名前を指定します。

[PARAM] version:

Gem が満たすバージョンに関する条件を指定します。

gather_dependencies -> Array[permalink][rdoc][edit]

依存関係を無視するように指定されていない限り、インストールするように指定された Gem が依存している Gem の情報を集めて返します。

gems_to_install -> Array[permalink][rdoc][edit]

依存関係によりインストールされる予定の Gem のリストを返します。

install(dep_or_name, version = Gem::Requirement.default) -> Array[permalink][rdoc][edit]

指定された Gem とその依存する Gem を全てインストールします。

[PARAM] dep_or_name:

Gem の名前か Gem::Dependency のインスタンスを指定します。

[PARAM] version:

バージョンに関する条件を指定します。

[RETURN]

このメソッドでインストールした Gem のリストを返します。

installed_gems -> Array[permalink][rdoc][edit]

Gem::DependencyInstaller#install でインストールされた Gem のリストを返します。

定数

DEFAULT_OPTIONS -> Hash[permalink][rdoc][edit]

自身を初期化する際に使用するデフォルトのオプションです。

:env_shebang         => false,
:domain              => :both, # HACK dup
:force               => false,
:format_executable   => false, # HACK dup
:ignore_dependencies => false,
:security_policy     => nil, # HACK NoSecurity requires OpenSSL.  AlmostNo? Low?
:wrappers            => true