summaryrefslogtreecommitdiff
path: root/lib/rubygems/custom_require.rb
blob: 36e3c78911d5395759724335ac6d26b5ad0e6327 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
#--
# Copyright 2006 by Chad Fowler, Rich Kilmer, Jim Weirich and others.
# All rights reserved.
# See LICENSE.txt for permissions.
#++

module Kernel

  ##
  # The Kernel#require from before RubyGems was loaded.

  alias gem_original_require require

  ##
  # When RubyGems is required, Kernel#require is replaced with our own which
  # is capable of loading gems on demand.
  #
  # When you call <tt>require 'x'</tt>, this is what happens:
  # * If the file can be loaded from the existing Ruby loadpath, it
  #   is.
  # * Otherwise, installed gems are searched for a file that matches.
  #   If it's found in gem 'y', that gem is activated (added to the
  #   loadpath).
  #
  # The normal <tt>require</tt> functionality of returning false if
  # that file has already been loaded is preserved.

  def require(path) # :doc:
    gem_original_require path
  rescue LoadError => load_error
    if load_error.message.end_with?(path) and
        begin
          Gem.try_activate(path)
        rescue Gem::LoadError => load_error
          pat = "#{__FILE__}:#{__LINE__-2}:in "
          bt = load_error.backtrace
          num = bt.index {|e| e.start_with?(pat)} and bt.shift(num+2)
          raise load_error
        end
      retry
    else
      load_error.backtrace.shift(2)
      raise load_error
    end
  end

  private :require
  private :gem_original_require

end unless Kernel.private_method_defined?(:gem_original_require)