【Ruby3.x】Gem::StubSpecification::raw_require_paths()メソッドの使い方
raw_require_pathsメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
raw_require_pathsメソッドは、RubyGemsが管理するGem（ライブラリ）の、ファイル読み込みパスに関する「生（raw）」の情報を取得するメソッドです。このメソッドは、Gem::StubSpecificationクラスのインスタンスに対して呼び出されます。Gem::StubSpecificationとは、Gemが実際にロードされていなくても、そのGemの基本的なメタデータ（情報）を一時的に保持するためのクラスです。
このメソッドが返すのは、特定のGemがrequire文でファイルを読み込む際に、Rubyが検索するべきディレクトリのパスをまとめた文字列の配列です。通常、Gemの内部では、クラスやモジュールが定義されているディレクトリなどがこのパスに含まれます。rawという名前が示す通り、このメソッドはRubyGemsのシステムによって何らかの加工（例えば、相対パスから絶対パスへの変換など）が行われる前の、Gemの定義ファイルに直接記述されているパス情報を返します。
したがって、raw_require_pathsメソッドは、RubyGemsの内部処理において、Gemのロードパスを正確に特定するために利用されるほか、Gemの構造を深く理解したい開発者が、そのGemがどのようにファイルを探しているのかを調査する際にも役立ちます。この情報に基づいてRubyは正しいファイルを見つけ出し、Gemを問題なく動作させることができます。
構文(syntax)
1stub_specification_instance.raw_require_paths
引数(parameters)
引数なし
引数はありません
戻り値(return)
Array<String>
このメソッドは、Gemが展開された際に、そのGemのソースコードを読み込むために必要なパスのリストを文字列の配列として返します。