Class: Bundler::RubygemsIntegration

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

Direct Known Subclasses

Future, Legacy, Modern

Defined Under Namespace

Classes: AlmostModern, Ancient, Future, Legacy, Modern, MoreFuture, MoreModern, Transitional

Constant Summary

EXT_LOCK =
Gem::Ext::Builder::CHDIR_MONITOR

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initializeRubygemsIntegration

Returns a new instance of RubygemsIntegration



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

def initialize
  @replaced_methods = {}
end

Class Method Details

.provides?(req_str) ⇒ Boolean

Returns:

  • (Boolean)


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

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

.versionObject



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

def self.version
  @version ||= Gem::Version.new(Gem::VERSION)
end

Instance Method Details

#backport_base_dirObject

This backports base_dir which replaces installation path Rubygems 1.8+



483
484
485
486
487
488
# File 'lib/bundler/rubygems_integration.rb', line 483

def backport_base_dir
  redefine_method(Gem::Specification, :base_dir) do
    return Gem.dir unless loaded_from
    File.dirname File.dirname loaded_from
  end
end

#backport_cache_fileObject



490
491
492
493
494
495
496
497
498
# File 'lib/bundler/rubygems_integration.rb', line 490

def backport_cache_file
  redefine_method(Gem::Specification, :cache_dir) do
    @cache_dir ||= File.join base_dir, "cache"
  end

  redefine_method(Gem::Specification, :cache_file) do
    @cache_file ||= File.join cache_dir, "#{full_name}.gem"
  end
end

#backport_segment_generationObject

This backports the correct segment generation code from Rubygems 1.4+ by monkeypatching it into the method in Rubygems 1.3.6 and 1.3.7.



464
465
466
467
468
469
470
# File 'lib/bundler/rubygems_integration.rb', line 464

def backport_segment_generation
  redefine_method(Gem::Version, :segments) do
    @segments ||= @version.scan(/[0-9]+|[a-z]+/i).map do |s|
      /^\d+$/ =~ s ? s.to_i : s
    end
  end
end

#backport_spec_fileObject



500
501
502
503
504
505
506
507
508
# File 'lib/bundler/rubygems_integration.rb', line 500

def backport_spec_file
  redefine_method(Gem::Specification, :spec_dir) do
    @spec_dir ||= File.join base_dir, "specifications"
  end

  redefine_method(Gem::Specification, :spec_file) do
    @spec_file ||= File.join spec_dir, "#{full_name}.gemspec"
  end
end

#backport_yaml_initializeObject

This backport fixes the marshaling of @segments.



473
474
475
476
477
478
479
# File 'lib/bundler/rubygems_integration.rb', line 473

def backport_yaml_initialize
  redefine_method(Gem::Version, :yaml_initialize) do |_, map|
    @version = map["version"]
    @segments = nil
    @hash = nil
  end
end

#bin_path(gem, bin, ver) ⇒ Object



181
182
183
# File 'lib/bundler/rubygems_integration.rb', line 181

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

#build(spec, skip_validation = false) ⇒ Object



282
283
284
285
# File 'lib/bundler/rubygems_integration.rb', line 282

def build(spec, skip_validation = false)
  require "rubygems/builder"
  Gem::Builder.new(spec).build
end

#build_argsObject



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

def build_args
  Gem::Command.build_args
end

#build_args=(args) ⇒ Object



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

def build_args=(args)
  Gem::Command.build_args = args
end

#build_gem(gem_dir, spec) ⇒ Object



287
288
289
# File 'lib/bundler/rubygems_integration.rb', line 287

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

#clear_pathsObject



177
178
179
# File 'lib/bundler/rubygems_integration.rb', line 177

def clear_paths
  Gem.clear_paths
end

#config_mapObject



169
170
171
# File 'lib/bundler/rubygems_integration.rb', line 169

def config_map
  Gem::ConfigMap
end

#configurationObject



92
93
94
95
96
97
98
99
100
101
102
# File 'lib/bundler/rubygems_integration.rb', line 92

def configuration
  require "bundler/psyched_yaml"
  Gem.configuration
rescue Gem::SystemExitException, LoadError => e
  Bundler.ui.error "#{e.class}: #{e.message}"
  Bundler.ui.trace e
  raise
rescue YamlLibrarySyntaxError => e
  raise YamlSyntaxError.new(e, "Your RubyGems configuration, which is " \
    "usually located in ~/.gemrc, contains invalid YAML syntax.")
end

#download_gem(spec, uri, path) ⇒ Object



291
292
293
294
295
296
297
# File 'lib/bundler/rubygems_integration.rb', line 291

def download_gem(spec, uri, path)
  uri = Bundler.settings.mirror_for(uri)
  fetcher = Gem::RemoteFetcher.new(configuration[:http_proxy])
  Bundler::Retry.new("download gem #{uri}", Gem::RemoteFetcher::FetchError).attempts do
    fetcher.download(spec, uri, path)
  end
end

#ext_lockObject



211
212
213
# File 'lib/bundler/rubygems_integration.rb', line 211

def ext_lock
  EXT_LOCK
end

#fetch_all_remote_specs(remote) ⇒ Object

TODO: This is for older versions of Rubygems… should we support the X-Gemfile-Source header on these old versions? Maybe the newer implementation will work on older Rubygems? It seems difficult to keep this implementation and still send the header.



231
232
233
234
235
236
237
238
239
240
241
242
# File 'lib/bundler/rubygems_integration.rb', line 231

def fetch_all_remote_specs(remote)
  old_sources = Bundler.rubygems.sources
  Bundler.rubygems.sources = [remote.uri.to_s]
  # Fetch all specs, minus prerelease specs
  spec_list = fetch_specs(true, false)
  # Then fetch the prerelease specs
  fetch_prerelease_specs.each {|k, v| spec_list[k].concat(v) }

  spec_list.values.first
ensure
  Bundler.rubygems.sources = old_sources
end

#fetch_prerelease_specsObject



221
222
223
224
225
# File 'lib/bundler/rubygems_integration.rb', line 221

def fetch_prerelease_specs
  fetch_specs(false, true)
rescue Gem::RemoteFetcher::FetchError
  {} # if we can't download them, there aren't any
end

#fetch_specs(all, pre, &blk) ⇒ Object



215
216
217
218
219
# File 'lib/bundler/rubygems_integration.rb', line 215

def fetch_specs(all, pre, &blk)
  specs = Gem::SpecFetcher.new.list(all, pre)
  specs.each { yield } if block_given?
  specs
end

#gem_bindirObject



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

def gem_bindir
  Gem.bindir
end

#gem_cacheObject



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

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

#gem_dirObject



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

def gem_dir
  Gem.dir
end

#gem_from_path(path, policy = nil) ⇒ Object



260
261
262
263
# File 'lib/bundler/rubygems_integration.rb', line 260

def gem_from_path(path, policy = nil)
  require "rubygems/format"
  Gem::Format.from_file_by_path(path, policy)
end

#gem_pathObject



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

def gem_path
  Gem.path
end

#inflate(obj) ⇒ Object



112
113
114
# File 'lib/bundler/rubygems_integration.rb', line 112

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

#install_with_build_args(args) ⇒ Object



256
257
258
# File 'lib/bundler/rubygems_integration.rb', line 256

def install_with_build_args(args)
  with_build_args(args) { yield }
end

#load_path_insert_indexObject



42
43
44
# File 'lib/bundler/rubygems_integration.rb', line 42

def load_path_insert_index
  Gem.load_path_insert_index
end

#load_pluginsObject



203
204
205
# File 'lib/bundler/rubygems_integration.rb', line 203

def load_plugins
  Gem.load_plugins if Gem.respond_to?(:load_plugins)
end

#loaded_gem_pathsObject



190
191
192
193
194
195
196
197
198
199
200
201
# File 'lib/bundler/rubygems_integration.rb', line 190

def loaded_gem_paths
  # RubyGems 2.2+ can put binary extension into dedicated folders,
  # therefore use RubyGems facilities to obtain their load paths.
  if Gem::Specification.method_defined? :full_require_paths
    loaded_gem_paths = Gem.loaded_specs.map {|_, s| s.full_require_paths }
    loaded_gem_paths.flatten
  else
    $LOAD_PATH.select do |p|
      Bundler.rubygems.gem_path.any? {|gp| p =~ /^#{Regexp.escape(gp)}/ }
    end
  end
end

#loaded_specs(name) ⇒ Object



46
47
48
# File 'lib/bundler/rubygems_integration.rb', line 46

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

#mark_loaded(spec) ⇒ Object



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

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_dirObject



165
166
167
# File 'lib/bundler/rubygems_integration.rb', line 165

def marshal_spec_dir
  Gem::MARSHAL_SPEC_DIR
end

#method_visibility(klass, method) ⇒ Object



541
542
543
544
545
546
547
548
549
# File 'lib/bundler/rubygems_integration.rb', line 541

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



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

def path(obj)
  obj.to_s
end

#platformsObject



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

def platforms
  return [Gem::Platform::RUBY] if Bundler.settings[:force_ruby_platform]
  Gem.platforms
end

#post_reset_hooksObject



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

def post_reset_hooks
  Gem.post_reset_hooks
end

#preserve_pathsObject



185
186
187
188
# File 'lib/bundler/rubygems_integration.rb', line 185

def preserve_paths
  # this is a no-op outside of Rubygems 1.8
  yield
end

#provides?(req_str) ⇒ Boolean

Returns:

  • (Boolean)


30
31
32
# File 'lib/bundler/rubygems_integration.rb', line 30

def provides?(req_str)
  self.class.provides?(req_str)
end

#read_binary(path) ⇒ Object



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

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

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



520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
# File 'lib/bundler/rubygems_integration.rb', line 520

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) ⇒ Object

Used to make bin stubs that are not created by bundler work under bundler. The new Gem.bin_path only considers gems in specs



395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
# File 'lib/bundler/rubygems_integration.rb', line 395

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

  redefine_method(gem_class, :find_spec_for_exe) do |gem_name, *args|
    exec_name = args.first

    spec = if exec_name
      specs.find {|s| s.name == gem_name && s.executables.include?(exec_name) } ||
        specs.find {|s| s.executables.include?(exec_name) }
    else
      specs.find {|s| s.name == gem_name }
    end
    raise(Gem::Exception, "can't find executable #{exec_name}") unless spec
    raise Gem::Exception, "no default executable for #{spec.full_name}" unless exec_name ||= spec.default_executable
    unless spec.name == name
      Bundler::SharedHelpers.major_deprecation \
        "Bundler is using a binstub that was created for a different gem.\n" \
        "You should run `bundle binstub #{gem_name}` " \
        "to work around a system/bundle conflict."
    end
    spec
  end

  redefine_method(gem_class, :activate_bin_path) do |name, *args|
    exec_name = args.first
    return ENV["BUNDLE_BIN_PATH"] if exec_name == "bundle"

    # Copy of Rubygems activate_bin_path impl
    requirement = args.last
    spec = find_spec_for_exe name, exec_name, [requirement]
    Gem::LOADED_SPECS_MUTEX.synchronize { spec.activate }
    spec.bin_file exec_name
  end

  redefine_method(gem_class, :bin_path) do |name, *args|
    exec_name = args.first
    return ENV["BUNDLE_BIN_PATH"] if exec_name == "bundle"

    spec = find_spec_for_exe(name, *args)
    exec_name ||= spec.default_executable

    gem_bin = File.join(spec.full_gem_path, spec.bindir, exec_name)
    gem_from_path_bin = File.join(File.dirname(spec.loaded_from), spec.bindir, exec_name)
    File.exist?(gem_bin) ? gem_bin : gem_from_path_bin
  end
end

#replace_entrypoints(specs) ⇒ Object

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



451
452
453
454
455
456
457
458
459
460
# File 'lib/bundler/rubygems_integration.rb', line 451

def replace_entrypoints(specs)
  replace_gem(specs)

  stub_rubygems(specs)

  replace_bin_path(specs)
  replace_refresh

  Gem.clear_paths
end

#replace_gem(specs) ⇒ Object



322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
# File 'lib/bundler/rubygems_integration.rb', line 322

def replace_gem(specs)
  reverse_rubygems_kernel_mixin

  executables = specs.map(&:executables).flatten

  kernel = (class << ::Kernel; self; end)
  [kernel, ::Kernel].each do |kernel_class|
    redefine_method(kernel_class, :gem) do |dep, *reqs|
      if executables.include? File.basename(caller.first.split(":").first)
        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

      spec = specs.find {|s| s.name == dep.name }

      if spec.nil?

        e = Gem::LoadError.new "#{dep.name} is not part of the bundle. Add it to Gemfile."
        e.name = dep.name
        if e.respond_to?(:requirement=)
          e.requirement = dep.requirement
        else
          e.version_requirement = dep.requirement
        end
        raise e
      elsif dep !~ spec
        e = Gem::LoadError.new "can't activate #{dep}, already activated #{spec.full_name}. " \
                               "Make sure all dependencies are added to Gemfile."
        e.name = dep.name
        if e.respond_to?(:requirement=)
          e.requirement = dep.requirement
        else
          e.version_requirement = dep.requirement
        end
        raise e
      end

      true
    end

    # TODO: delete this in 2.0, it's a backwards compatibility shim
    # see https://github.com/bundler/bundler/issues/5102
    kernel_class.send(:public, :gem)
  end
end

#replace_refreshObject

Because Bundler has a static view of what specs are available, we don't #refresh, so stub it out.



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

def replace_refresh
  gem_class = (class << Gem; self; end)
  redefine_method(gem_class, :refresh) {}
end

#repository_subdirectoriesObject



173
174
175
# File 'lib/bundler/rubygems_integration.rb', line 173

def repository_subdirectories
  %w(cache doc gems specifications)
end

#resetObject



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

def reset
  Gem::Specification.reset
end

#reverse_rubygems_kernel_mixinObject



312
313
314
315
316
317
318
319
320
# File 'lib/bundler/rubygems_integration.rb', line 312

def reverse_rubygems_kernel_mixin
  # Disable rubygems' gem activation system
  kernel = (class << ::Kernel; self; end)
  [kernel, ::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

#ruby_engineObject



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

def ruby_engine
  Gem.ruby_engine
end

#security_policiesObject



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

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

#security_policy_keysObject



299
300
301
# File 'lib/bundler/rubygems_integration.rb', line 299

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

#set_installed_by_version(spec, installed_by_version = Gem::VERSION) ⇒ Object



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

def set_installed_by_version(spec, installed_by_version = Gem::VERSION)
  return unless spec.respond_to?(:installed_by_version=)
  spec.installed_by_version = Gem::Version.create(installed_by_version)
end

#sourcesObject



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

def sources
  Gem.sources
end

#sources=(val) ⇒ Object



116
117
118
119
120
121
122
123
# File 'lib/bundler/rubygems_integration.rb', line 116

def sources=(val)
  # Gem.configuration creates a new Gem::ConfigFile, which by default will read ~/.gemrc
  # If that file exists, its settings (including sources) will overwrite the values we
  # are about to set here. In order to avoid that, we force memoizing the config file now.
  configuration

  Gem.sources = val
end

#spec_cache_dirsObject



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

def spec_cache_dirs
  @spec_cache_dirs ||= begin
    dirs = gem_path.map {|dir| File.join(dir, "specifications") }
    dirs << Gem.spec_cache_dir if Gem.respond_to?(:spec_cache_dir) # Not in Rubygems 2.0.3 or earlier
    dirs.uniq.select {|dir| File.directory? dir }
  end
end

#spec_from_gem(path, policy = nil) ⇒ Object



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

def spec_from_gem(path, policy = nil)
  require "rubygems/security"
  gem_from_path(path, security_policies[policy]).spec
rescue Gem::Package::FormatError
  raise GemspecError, "Could not read gem at #{path}. It may be corrupted."
rescue Exception, Gem::Exception, Gem::Security::Exception => e
  if e.is_a?(Gem::Security::Exception) ||
      e.message =~ /unknown trust policy|unsigned gem/i ||
      e.message =~ /couldn't verify (meta)?data signature/i
    raise SecurityError,
      "The gem #{File.basename(path, ".gem")} can't be installed because " \
      "the security policy didn't allow it, with the message: #{e.message}"
  else
    raise e
  end
end

#spec_missing_extensions?(spec, default = true) ⇒ Boolean

Returns:

  • (Boolean)


74
75
76
77
78
79
80
81
# File 'lib/bundler/rubygems_integration.rb', line 74

def spec_missing_extensions?(spec, default = true)
  return spec.missing_extensions? if spec.respond_to?(:missing_extensions?)

  return false if spec.respond_to?(:default_gem?) && spec.default_gem?
  return false if spec.extensions.empty?

  default
end

#stub_source_index(specs) ⇒ Object



372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
# File 'lib/bundler/rubygems_integration.rb', line 372

def stub_source_index(specs)
  Gem::SourceIndex.send(:alias_method, :old_initialize, :initialize)
  redefine_method(Gem::SourceIndex, :initialize) do |*args|
    @gems = {}
    # You're looking at this thinking: Oh! This is how I make those
    # rubygems deprecations go away!
    #
    # You'd be correct BUT using of this method in production code
    # must be approved by the rubygems team itself!
    #
    # This is your warning. If you use this and don't have approval
    # we can't protect you.
    #
    Deprecate.skip_during do
      self.spec_dirs = *args
      add_specs(*specs)
    end
  end
end

#ui=(obj) ⇒ Object



207
208
209
# File 'lib/bundler/rubygems_integration.rb', line 207

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

#undo_replacementsObject



510
511
512
513
514
515
516
517
518
# File 'lib/bundler/rubygems_integration.rb', line 510

def undo_replacements
  @replaced_methods.each do |(sym, klass), method|
    redefine_method(klass, sym, method)
  end
  post_reset_hooks.reject! do |proc|
    proc.binding.eval("__FILE__") == __FILE__
  end
  @replaced_methods.clear
end

#user_homeObject



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

def user_home
  Gem.user_home
end

#validate(spec) ⇒ Object



59
60
61
62
63
64
65
66
67
# File 'lib/bundler/rubygems_integration.rb', line 59

def validate(spec)
  Bundler.ui.silence { spec.validate(false) }
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

#versionObject



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

def version
  self.class.version
end

#with_build_args(args) ⇒ Object



244
245
246
247
248
249
250
251
252
253
254
# File 'lib/bundler/rubygems_integration.rb', line 244

def with_build_args(args)
  ext_lock.synchronize do
    old_args = build_args
    begin
      self.build_args = args
      yield
    ensure
      self.build_args = old_args
    end
  end
end