Rbenv、RubyGems、Bundlerがどのように連携するかを理解する

rbenvをデバッグするには、これら2つの概念を正しく理解する必要があります。 効果的に。

シムは、PATHに存在する軽量のbashスクリプトです。 コマンドをインターセプトし、実行のために適切なバージョンにルーティングします。大まかに言うと、すべてのコマンド（rspecなど ）はrbenv exec rspecに変換されます 。以下の詳細を参照してください。

まず、rbenv すべてのコマンドのシムを作成します（rspec 、bundle 、など）インストールされているすべてのRubyバージョンにわたって、バージョンに関係なくCLIへの呼び出しをインターセプトします。これらのシムは~/.rbenv/shimsにあります。 。以下に示すように、すべてのシムには同じbashスクリプトが含まれています。

#!/usr/bin/env bash
set -e
[ -n "$RBENV_DEBUG" ] && set -x

program="${0##*/}"
if [ "$program" = "ruby" ]; then
   for arg; do
     case "$arg" in
     -e* | -- ) break ;;
     */* )
        if [ -f "$arg" ]; then
         export RBENV_DIR="${arg%/*}"
         break
       fi
       ;;
     esac
   done
 fi

 export RBENV_ROOT="/home/directory/.rbenv"
 exec "/usr/local/Cellar/rbenv/1.1.2/libexec/rbenv" exec "$program" "$@"

次に、上記のスクリプトは大まかに次のように変換されます。

• プログラム名がrubyの場合 引数付き-e 、
  • rbenv exec ruby <args>に変換します
• プログラム名がrubyの場合 スクリプトへのパスを使用して、
  • RBENV_DIRを設定します スクリプトのディレクトリに移動します。これにより、rbenvが有効になります .ruby-versionを検索するには $PWDの前のスクリプトのディレクトリ 。 .ruby-versionの場合 rbenvの両方の場所で指定されます スクリプトのディレクトリを選択します。
• プログラム名がRubyでない場合は、
  • rbenv exec <program-name> <args>に変換します 。

最後に、rbenv exec <command-name> <args> RBENV_VERSIONをチェックして、コマンドを渡す正しいバージョンを識別します 環境変数。 RBENV_VERSIONを忘れないでください 上で定義されたアルゴリズムによって設定されます。

PATHのシム 付加する必要があります。これにより、Ruby実行可能ファイルの最初の連絡先となり、適切にインターセプトできるようになります。あなたのPATHを理解するために私が見つけた最良の方法 シムが適切にインターセプトされているかどうかを設定して確認するには、次のようにします。

$ which -a bundle

/path/to/home/.rbenv/shims/bundle
/usr/bin/bundle

which -a bundle ：これはあなたのPATHを素朴に調べます 見つかった順序で、bundleの場所を印刷します 見つけることができます。 ~/.rbenv/shimsで何かが何かの前に印刷されている場合 、それはあなたのシムが適切に設定されていないことを意味します。 rbenv which bundle コマンドはrbenvのコンテキストで機能するため、これは明らかになりません。 PATHを検索していません 。

再ハッシュは、シムを作成するプロセスです。 rspecなどの実行可能ファイルを提供するRubygemを新しくインストールする場合 、rbenv rehashを実行する必要があります その後のrspecの呼び出しで、シムを作成します。 rbenvによって傍受される可能性があります そして適切なRubyバージョンに渡されます。

RubyGems

次はRubyGemsです。 Rubyの公式サイトから入手できます。 RubyGemsは、ライブラリの作成、共有、インストールを容易にするために設計されたRubyパッケージングシステムです。ある意味では、これはapt-getなどに似た配布パッケージシステムですが、Rubyソフトウェアを対象としています。 RubyGemsは、gemを共有するための事実上の方法です。これらは通常、~/.rbenv/versions/{version-number}/lib/ruby/gems/{minor-version}/にインストールされます。 、またはそのバリアント。使用するバージョンマネージャーによって異なります。 Rubyのデフォルトの必須メソッドKernel.require Gemsインストールディレクトリからgemをロードするメカニズムは提供していません。 RubyGemsモンキーパッチKernel.require に

• まず、$LOAD_PATHで宝石を検索します 。
• 見つからない場合は、GEMS INSTALLATION DIRECTORYでgemを検索してください 。
  • 見つかったら、パスを$LOAD_PATHに追加します 。

バージョン1.9以降、RubyにはデフォルトでRubyGemsが付属しているため、これは「ネイティブに」機能します。以前のRubyバージョンでは、RubyGemsを手動でインストールする必要がありました。これはネイティブで機能しますが、デバッグ時にこの違いを知ることも重要です。

gemは、特定の問題を解決するために使用される一連の関連コードです。次のようにgemをインストールし、gem環境に関する情報を取得します。

$ gem install gemname

$ gem env

RubyGems Environment: 
    - RUBYGEMS VERSION: 3.1.2 
    - RUBY VERSION: 2.7.1 (2020-03-31 patchlevel 83) [x86_64-darwin20] 
    - INSTALLATION DIRECTORY: /path/to/home/.rbenv/versions/2.7.1/lib/ruby/gems/2.7.0 
    - USER INSTALLATION DIRECTORY: /path/to/home/.gem/ruby/2.7.0 
    - RUBY EXECUTABLE: /path/to/home/.rbenv/versions/2.7.1/bin/ruby 
    - GIT EXECUTABLE: /usr/bin/git 
    - EXECUTABLE DIRECTORY: /path/to/home/.rbenv/versions/2.7.1/bin 
    - SPEC CACHE DIRECTORY: /path/to/home/.gem/specs 
    - SYSTEM CONFIGURATION DIRECTORY: /path/to/home/.rbenv/versions/2.7.1/etc 
    - RUBYGEMS PLATFORMS:   
        - ruby   
        - x86_64-darwin-20 
    - GEM PATHS:    
        - /path/to/home/.rbenv/versions/2.7.1/lib/ruby/gems/2.7.0    
        - /path/to/home/.gem/ruby/2.7.0 
    - GEM CONFIGURATION:    
        ...
    - REMOTE SOURCES:    
        - https://rubygems.org/ 
    - SHELL PATH:    
        - /path/to/home/.rbenv/versions/2.7.1/bin

RubyGemsはこの問題をどのように解決しますか？ Kernelにモンキーパッチを適用します 独自のrequireを備えたrequireシステム 方法。これをインプレースで使用すると、require honeybadger が呼び出され、gemsフォルダーでhoneybadger.rbを検索します。 見つかったときに宝石をアクティブにします。

たとえば、require 'honeybadger' 次のようなものを生成します：

• spec = Gem::Specification.find_by_path('honeybadger')
• spec.activate

gemをアクティブ化するということは、それを$LOAD_PATHに配置することを意味します。 。 RubyGemsは、gem自体をダウンロードする前に、gemのすべての依存関係をダウンロードするのにも役立ちます。

また、Rubygemsには、gem open <gem-name>を使用して関連するgemのディレクトリを開くことができる優れた機能が付属しています。;たとえば、

これにより、アプリが参照している宝石の特定のバージョンを簡単に見つけて追跡することができます。

# Gemfile
gem 'httparty'

GEM
  specs:
    httparty (0.18.1)
      mime-types (~> 3.0)
      multi_xml (>= 0.5.2)
    mime-types (3.3.1)
      mime-types-data (~> 3.2015)
    mime-types-data (3.2020.1104)
    multi_xml (0.6.0)

PLATFORMS
  ruby

DEPENDENCIES
  httparty

BUNDLED WITH
   2.1.4

# Gemfile
gem 'httparty' # That relies on gem 'mime-types', '>= 3.0.1, < 4.0.1'
gem 'rest-client' # That relies on gem 'mime-types', '>= 2.0.1, < 3.0'

Bundler could not find compatible versions for gem "mime-types":
In Gemfile:
    httparty was resolved to 0.18.1, which depends on
        mime-types ('>= 3.0.1, < 4.0.1')

    rest-client was resolved to 2.0.4, which depends on
        mime-types ('>= 2.0.1, < 3.0')

# Gemfile
gem 'httparty'

# irb
require 'rest-client'

# raises
LoadError (cannot load such file -- rest-client)