Class: Bundler::RubygemsIntegration

Inherits:
Object
  • Object
show all
Defined in:
lib/bundler/rubygems_integration.rb

Constant Summary collapse

EXT_LOCK = 
Monitor.new

Instance Method Summary collapse

Constructor Details

#initialize ⇒ RubygemsIntegration

Returns a new instance of RubygemsIntegration.



11
12
13
 
# File 'lib/bundler/rubygems_integration.rb', line 11

def initialize
  @replaced_methods = {}
end

Instance Method Details

#add_default_gems_to(specs) ⇒ Object

Add default gems not already present in specs, and return them as a hash.



285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
 
# File 'lib/bundler/rubygems_integration.rb', line 285

def add_default_gems_to(specs)
  specs_by_name = specs.reduce({}) do |h, s|
    h[s.name] = s
    h
  end

  Bundler.rubygems.default_stubs.each do |stub|
    default_spec = stub.to_spec
    default_spec_name = default_spec.name
    next if specs_by_name.key?(default_spec_name)

    specs << default_spec
    specs_by_name[default_spec_name] = default_spec
  end

  specs_by_name
end

#all_specs ⇒ Object 



422
423
424
425
426
427
428
 
# File 'lib/bundler/rubygems_integration.rb', line 422

def all_specs
  SharedHelpers.major_deprecation 2, "Bundler.rubygems.all_specs has been removed in favor of Bundler.rubygems.installed_specs"

  Gem::Specification.stubs.map do |stub|
    StubSpecification.from_stub(stub)
  end
end

#bin_path(gem, bin, ver) ⇒ Object 



128
129
130
 
# File 'lib/bundler/rubygems_integration.rb', line 128

def bin_path(gem, bin, ver)
  Gem.bin_path(gem, bin, ver)
end

#build(spec, skip_validation = false) ⇒ Object 



413
414
415
416
 
# File 'lib/bundler/rubygems_integration.rb', line 413

def build(spec, skip_validation = false)
  require "rubygems/package"
  Gem::Package.build(spec, skip_validation)
end

#build_args ⇒ Object 



27
28
29
30
 
# File 'lib/bundler/rubygems_integration.rb', line 27

def build_args
  require "rubygems/command"
  Gem::Command.build_args
end

#build_args=(args) ⇒ Object 



32
33
34
35
 
# File 'lib/bundler/rubygems_integration.rb', line 32

def build_args=(args)
  require "rubygems/command"
  Gem::Command.build_args = args
end

#build_gem(gem_dir, spec) ⇒ Object 



150
151
152
 
# File 'lib/bundler/rubygems_integration.rb', line 150

def build_gem(gem_dir, spec)
  build(spec)
end

#clear_paths ⇒ Object 



124
125
126
 
# File 'lib/bundler/rubygems_integration.rb', line 124

def clear_paths
  Gem.clear_paths
end

#default_specs ⇒ Object 



436
437
438
439
440
 
# File 'lib/bundler/rubygems_integration.rb', line 436

def default_specs
  Gem::Specification.default_stubs.map do |stub|
    StubSpecification.from_stub(stub)
  end
end

#default_stubs ⇒ Object 



450
451
452
 
# File 'lib/bundler/rubygems_integration.rb', line 450

def default_stubs
  Gem::Specification.default_stubs("*.gemspec")
end

#download_gem(spec, uri, cache_dir, fetcher) ⇒ Object 



385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
 
# File 'lib/bundler/rubygems_integration.rb', line 385

def download_gem(spec, uri, cache_dir, fetcher)
  require "rubygems/remote_fetcher"
  uri = Bundler.settings.mirror_for(uri)
  Bundler::Retry.new("download gem from #{uri}").attempts do
    gem_file_name = spec.file_name
    local_gem_path = File.join cache_dir, gem_file_name
    return if File.exist? local_gem_path

    begin
      remote_gem_path = uri + "gems/#{gem_file_name}"

      SharedHelpers.filesystem_access(local_gem_path) do
        fetcher.cache_update_path remote_gem_path, local_gem_path
      end
    rescue Gem::RemoteFetcher::FetchError
      raise if spec.original_platform == spec.platform

      original_gem_file_name = "#{spec.original_name}.gem"
      raise if gem_file_name == original_gem_file_name

      gem_file_name = original_gem_file_name
      retry
    end
  end
rescue Gem::RemoteFetcher::FetchError => e
  raise Bundler::HTTPError, "Could not download gem from #{uri} due to underlying error <#{e.message}>"
end

#ext_lock ⇒ Object 



141
142
143
 
# File 'lib/bundler/rubygems_integration.rb', line 141

def ext_lock
  EXT_LOCK
end

#fetch_all_remote_specs(remote, gem_remote_fetcher) ⇒ Object 



378
379
380
381
382
383
 
# File 'lib/bundler/rubygems_integration.rb', line 378

def fetch_all_remote_specs(remote, gem_remote_fetcher)
  specs = fetch_specs(remote, "specs", gem_remote_fetcher)
  pres = fetch_specs(remote, "prerelease_specs", gem_remote_fetcher) || []

  specs.concat(pres)
end

#fetch_specs(remote, name, fetcher) ⇒ Object 



366
367
368
369
370
371
372
373
374
375
376
 
# File 'lib/bundler/rubygems_integration.rb', line 366

def fetch_specs(remote, name, fetcher)
  require "rubygems/remote_fetcher"
  path = remote.uri.to_s + "#{name}.#{Gem.marshal_version}.gz"
  string = fetcher.fetch_path(path)
  specs = Bundler.safe_load_marshal(string)
  raise MarshalError, "Specs #{name} from #{remote} is expected to be an Array but was unexpected class #{specs.class}" unless specs.is_a?(Array)
  specs
rescue Gem::RemoteFetcher::FetchError
  # it's okay for prerelease to fail
  raise unless name == "prerelease_specs"
end

#find_bundler(version) ⇒ Object 



442
443
444
 
# File 'lib/bundler/rubygems_integration.rb', line 442

def find_bundler(version)
  find_name("bundler").find {|s| s.version.to_s == version }
end

#find_name(name) ⇒ Object 



446
447
448
 
# File 'lib/bundler/rubygems_integration.rb', line 446

def find_name(name)
  Gem::Specification.stubs_for(name).map(&:to_spec)
end

#gem_bindir ⇒ Object 



84
85
86
 
# File 'lib/bundler/rubygems_integration.rb', line 84

def gem_bindir
  Gem.bindir
end

#gem_cache ⇒ Object 



108
109
110
 
# File 'lib/bundler/rubygems_integration.rb', line 108

def gem_cache
  gem_path.map {|p| File.expand_path("cache", p) }
end

#gem_dir ⇒ Object 



80
81
82
 
# File 'lib/bundler/rubygems_integration.rb', line 80

def gem_dir
  Gem.dir
end

#gem_path ⇒ Object 



92
93
94
 
# File 'lib/bundler/rubygems_integration.rb', line 92

def gem_path
  Gem.path
end

#inflate(obj) ⇒ Object 



76
77
78
 
# File 'lib/bundler/rubygems_integration.rb', line 76

def inflate(obj)
  Gem::Util.inflate(obj)
end

#installed_specs ⇒ Object 



430
431
432
433
434
 
# File 'lib/bundler/rubygems_integration.rb', line 430

def installed_specs
  Gem::Specification.stubs.reject(&:default_gem?).map do |stub|
    StubSpecification.from_stub(stub)
  end
end

#loaded_gem_paths ⇒ Object 



132
133
134
135
 
# File 'lib/bundler/rubygems_integration.rb', line 132

def loaded_gem_paths
  loaded_gem_paths = Gem.loaded_specs.map {|_, s| s.full_require_paths }
  loaded_gem_paths.flatten
end

#loaded_specs(name) ⇒ Object 



37
38
39
 
# File 'lib/bundler/rubygems_integration.rb', line 37

def loaded_specs(name)
  Gem.loaded_specs[name]
end

#mark_loaded(spec) ⇒ Object 



41
42
43
44
45
46
47
48
 
# File 'lib/bundler/rubygems_integration.rb', line 41

def mark_loaded(spec)
  if spec.respond_to?(:activated=)
    current = Gem.loaded_specs[spec.name]
    current.activated = false if current
    spec.activated = true
  end
  Gem.loaded_specs[spec.name] = spec
end

#marshal_spec_dir ⇒ Object 



120
121
122
 
# File 'lib/bundler/rubygems_integration.rb', line 120

def marshal_spec_dir
  Gem::MARSHAL_SPEC_DIR
end

#method_visibility(klass, method) ⇒ Object 



336
337
338
339
340
341
342
343
344
 
# File 'lib/bundler/rubygems_integration.rb', line 336

def method_visibility(klass, method)
  if klass.private_method_defined?(method)
    :private
  elsif klass.protected_method_defined?(method)
    :protected
  else
    :public
  end
end

#path(obj) ⇒ Object 



64
65
66
 
# File 'lib/bundler/rubygems_integration.rb', line 64

def path(obj)
  obj.to_s
end

#path_separator ⇒ Object 



418
419
420
 
# File 'lib/bundler/rubygems_integration.rb', line 418

def path_separator
  Gem.path_separator
end

#plain_specs ⇒ Object 



358
359
360
 
# File 'lib/bundler/rubygems_integration.rb', line 358

def plain_specs
  Gem::Specification._all
end

#plain_specs=(specs) ⇒ Object 



362
363
364
 
# File 'lib/bundler/rubygems_integration.rb', line 362

def plain_specs=(specs)
  Gem::Specification.all = specs
end

#post_reset_hooks ⇒ Object 



100
101
102
 
# File 'lib/bundler/rubygems_integration.rb', line 100

def post_reset_hooks
  Gem.post_reset_hooks
end

#provides?(req_str) ⇒ Boolean

Returns:

  • (Boolean) 


19
20
21
 
# File 'lib/bundler/rubygems_integration.rb', line 19

def provides?(req_str)
  Gem::Requirement.new(req_str).satisfied_by?(version)
end

#read_binary(path) ⇒ Object 



72
73
74
 
# File 'lib/bundler/rubygems_integration.rb', line 72

def read_binary(path)
  Gem.read_binary(path)
end

#redefine_method(klass, method, unbound_method = nil, &block) ⇒ Object 



315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
 
# File 'lib/bundler/rubygems_integration.rb', line 315

def redefine_method(klass, method, unbound_method = nil, &block)
  visibility = method_visibility(klass, method)
  begin
    if (instance_method = klass.instance_method(method)) && method != :initialize
      # doing this to ensure we also get private methods
      klass.send(:remove_method, method)
    end
  rescue NameError
    # method isn't defined
    nil
  end
  @replaced_methods[[method, klass]] = instance_method
  if unbound_method
    klass.send(:define_method, method, unbound_method)
    klass.send(visibility, method)
  elsif block
    klass.send(:define_method, method, &block)
    klass.send(visibility, method)
  end
end

#replace_bin_path(specs_by_name) ⇒ Object

Used to give better error messages when activating specs outside of the current bundle



224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
 
# File 'lib/bundler/rubygems_integration.rb', line 224

def replace_bin_path(specs_by_name)
  gem_class = (class << Gem; self; end)

  redefine_method(gem_class, :find_spec_for_exe) do |gem_name, *args|
    exec_name = args.first
    raise ArgumentError, "you must supply exec_name" unless exec_name

    spec_with_name = specs_by_name[gem_name]
    matching_specs_by_exec_name = specs_by_name.values.select {|s| s.executables.include?(exec_name) }
    spec = matching_specs_by_exec_name.delete(spec_with_name)

    unless spec || !matching_specs_by_exec_name.empty?
      message = "can't find executable #{exec_name} for gem #{gem_name}"
      if spec_with_name.nil?
        message += ". #{gem_name} is not currently included in the bundle, " \
                   "perhaps you meant to add it to your #{Bundler.default_gemfile.basename}?"
      end
      raise Gem::Exception, message
    end

    unless spec
      spec = matching_specs_by_exec_name.shift
      warn \
        "Bundler is using a binstub that was created for a different gem (#{spec.name}).\n" \
        "You should run `bundle binstub #{gem_name}` " \
        "to work around a system/bundle conflict."
    end

    unless matching_specs_by_exec_name.empty?
      conflicting_names = matching_specs_by_exec_name.map(&:name).join(", ")
      warn \
        "The `#{exec_name}` executable in the `#{spec.name}` gem is being loaded, but it's also present in other gems (#{conflicting_names}).\n" \
        "If you meant to run the executable for another gem, make sure you use a project specific binstub (`bundle binstub <gem_name>`).\n" \
        "If you plan to use multiple conflicting executables, generate binstubs for them and disambiguate their names."
    end

    spec
  end
end

#replace_entrypoints(specs) ⇒ Object

Replace or hook into RubyGems to provide a bundlerized view of the world.



266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
 
# File 'lib/bundler/rubygems_integration.rb', line 266

def replace_entrypoints(specs)
  specs_by_name = add_default_gems_to(specs)

  reverse_rubygems_kernel_mixin
  begin
    # bundled_gems only provide with Ruby 3.3 or later
    require "bundled_gems"
  rescue LoadError
  else
    Gem::BUNDLED_GEMS.replace_require(specs) if Gem::BUNDLED_GEMS.respond_to?(:replace_require)
  end
  replace_gem(specs, specs_by_name)
  stub_rubygems(specs_by_name.values)
  replace_bin_path(specs_by_name)

  Gem.clear_paths
end

#replace_gem(specs, specs_by_name) ⇒ Object 



180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
 
# File 'lib/bundler/rubygems_integration.rb', line 180

def replace_gem(specs, specs_by_name)
  executables = nil

  [::Kernel.singleton_class, ::Kernel].each do |kernel_class|
    redefine_method(kernel_class, :gem) do |dep, *reqs|
      if executables&.include?(File.basename(caller_locations(1, 1).first.path))
        break
      end

      reqs.pop if reqs.last.is_a?(Hash)

      unless dep.respond_to?(:name) && dep.respond_to?(:requirement)
        dep = Gem::Dependency.new(dep, reqs)
      end

      if spec = specs_by_name[dep.name]
        return true if dep.matches_spec?(spec)
      end

      message = if spec.nil?
        target_file = begin
                        Bundler.default_gemfile.basename
                      rescue GemfileNotFound
                        "inline Gemfile"
                      end
        "#{dep.name} is not part of the bundle." \
        " Add it to your #{target_file}."
      else
        "can't activate #{dep}, already activated #{spec.full_name}. " \
        "Make sure all dependencies are added to Gemfile."
      end

      e = Gem::LoadError.new(message)
      e.name = dep.name
      e.requirement = dep.requirement
      raise e
    end

    # backwards compatibility shim, see https://github.com/rubygems/bundler/issues/5102
    kernel_class.send(:public, :gem) if Bundler.feature_flag.setup_makes_kernel_gem_public?
  end
end

#reset ⇒ Object 



96
97
98
 
# File 'lib/bundler/rubygems_integration.rb', line 96

def reset
  Gem::Specification.reset
end

#reverse_rubygems_kernel_mixin ⇒ Object 



167
168
169
170
171
172
173
174
175
176
177
178
 
# File 'lib/bundler/rubygems_integration.rb', line 167

def reverse_rubygems_kernel_mixin
  # Disable rubygems' gem activation system
  if Gem.respond_to?(:discover_gems_on_require=)
    Gem.discover_gems_on_require = false
  else
    [::Kernel.singleton_class, ::Kernel].each do |k|
      if k.private_method_defined?(:gem_original_require)
        redefine_method(k, :require, k.instance_method(:gem_original_require))
      end
    end
  end
end

#ruby_engine ⇒ Object 



68
69
70
 
# File 'lib/bundler/rubygems_integration.rb', line 68

def ruby_engine
  Gem.ruby_engine
end

#security_policies ⇒ Object 



158
159
160
161
162
163
164
165
 
# File 'lib/bundler/rubygems_integration.rb', line 158

def security_policies
  @security_policies ||= begin
    require "rubygems/security"
    Gem::Security::Policies
  rescue LoadError, NameError
    {}
  end
end

#security_policy_keys ⇒ Object 



154
155
156
 
# File 'lib/bundler/rubygems_integration.rb', line 154

def security_policy_keys
  %w[High Medium Low AlmostNo No].map {|level| "#{level}Security" }
end

#spec_cache_dirs ⇒ Object 



112
113
114
115
116
117
118
 
# File 'lib/bundler/rubygems_integration.rb', line 112

def spec_cache_dirs
  @spec_cache_dirs ||= begin
    dirs = gem_path.map {|dir| File.join(dir, "specifications") }
    dirs << Gem.spec_cache_dir
    dirs.uniq.select {|dir| File.directory? dir }
  end
end

#spec_from_gem(path) ⇒ Object 



145
146
147
148
 
# File 'lib/bundler/rubygems_integration.rb', line 145

def spec_from_gem(path)
  require "rubygems/package"
  Gem::Package.new(path).spec
end

#stub_rubygems(specs) ⇒ Object 



346
347
348
349
350
351
352
353
354
355
356
 
# File 'lib/bundler/rubygems_integration.rb', line 346

def stub_rubygems(specs)
  Gem::Specification.all = specs

  Gem.post_reset do
    Gem::Specification.all = specs
  end

  redefine_method((class << Gem; self; end), :finish_resolve) do |*|
    []
  end
end

#stub_set_spec(stub, spec) ⇒ Object 



60
61
62
 
# File 'lib/bundler/rubygems_integration.rb', line 60

def stub_set_spec(stub, spec)
  stub.instance_variable_set(:@spec, spec)
end

#suffix_pattern ⇒ Object 



104
105
106
 
# File 'lib/bundler/rubygems_integration.rb', line 104

def suffix_pattern
  Gem.suffix_pattern
end

#supports_bundler_trampolining? ⇒ Boolean

Returns:

  • (Boolean) 


23
24
25
 
# File 'lib/bundler/rubygems_integration.rb', line 23

def supports_bundler_trampolining?
  provides?(">= 3.3.0.a")
end

#ui=(obj) ⇒ Object 



137
138
139
 
# File 'lib/bundler/rubygems_integration.rb', line 137

def ui=(obj)
  Gem::DefaultUserInteraction.ui = obj
end

#undo_replacements ⇒ Object 



303
304
305
306
307
308
309
310
311
312
313
 
# File 'lib/bundler/rubygems_integration.rb', line 303

def undo_replacements
  @replaced_methods.each do |(sym, klass), method|
    redefine_method(klass, sym, method)
  end
  if Binding.public_method_defined?(:source_location)
    post_reset_hooks.reject! {|proc| proc.binding.source_location[0] == __FILE__ }
  else
    post_reset_hooks.reject! {|proc| proc.binding.eval("__FILE__") == __FILE__ }
  end
  @replaced_methods.clear
end

#user_home ⇒ Object 



88
89
90
 
# File 'lib/bundler/rubygems_integration.rb', line 88

def user_home
  Gem.user_home
end

#validate(spec) ⇒ Object 



50
51
52
53
54
55
56
57
58
 
# File 'lib/bundler/rubygems_integration.rb', line 50

def validate(spec)
  Bundler.ui.silence { spec.validate_for_resolution }
rescue Gem::InvalidSpecificationException => e
  error_message = "The gemspec at #{spec.loaded_from} is not valid. Please fix this gemspec.\n" \
    "The validation error was '#{e.message}'\n"
  raise Gem::InvalidSpecificationException.new(error_message)
rescue Errno::ENOENT
  nil
end

#version ⇒ Object 



15
16
17
 
# File 'lib/bundler/rubygems_integration.rb', line 15

def version
  @version ||= Gem.rubygems_version
end