method

use_gemdeps

v2_5_5 - Show latest stable - 0 notes - Class: Gem

1_8_6_287
1_8_7_72
1_8_7_330
1_9_1_378
1_9_2_180
1_9_3_125
1_9_3_392
2_1_10 (0)
2_2_9 (38)
2_4_6 (0)
2_5_5 (0)
2_6_3 (0)
What's this?

use_gemdeps(path = nil) public

Looks for a gem dependency file at path and activates the gems in the file if found. If the file is not found an ArgumentError is raised.

If path is not given the RUBYGEMS_GEMDEPS environment variable is used, but if no file is found no exception is raised.

If ‘-’ is given for path RubyGems searches up from the current working directory for gem dependency files (gem.deps.rb, Gemfile, Isolate) and activates the gems in the first one found.

You can run this automatically when rubygems starts. To enable, set the RUBYGEMS_GEMDEPS environment variable to either the path of your gem dependencies file or “-” to auto-discover in parent directories.

NOTE: Enabling automatic discovery on multiuser systems can lead to execution of arbitrary code when used from directories outside your control.

Show source

# File lib/rubygems.rb, line 1162
  def self.use_gemdeps path = nil
    raise_exception = path

    path ||= ENV['RUBYGEMS_GEMDEPS']
    return unless path

    path = path.dup

    if path == "-" then
      Gem::Util.traverse_parents Dir.pwd do |directory|
        dep_file = GEM_DEP_FILES.find { |f| File.file?(f) }

        next unless dep_file

        path = File.join directory, dep_file
        break
      end
    end

    path.untaint

    unless File.file? path then
      return unless raise_exception

      raise ArgumentError, "Unable to find gem dependencies file at #{path}"
    end

    if USE_BUNDLER_FOR_GEMDEPS

      ENV["BUNDLE_GEMFILE"] ||= File.expand_path(path)
      require 'rubygems/user_interaction'
      Gem::DefaultUserInteraction.use_ui(ui) do
        require "bundler"
        @gemdeps = Bundler.setup
        Bundler.ui = nil
        @gemdeps.requested_specs.map(&:to_spec).sort_by(&:name)
      end

    else

      rs = Gem::RequestSet.new
      @gemdeps = rs.load_gemdeps path

      rs.resolve_current.map do |s|
        s.full_spec.tap(&:activate)
      end

    end
  rescue => e
    case e
    when Gem::LoadError, Gem::UnsatisfiableDependencyError, (defined?(Bundler::GemNotFound) ? Bundler::GemNotFound : Gem::LoadError)
      warn e.message
      warn "You may need to `gem install -g` to install missing gems"
      warn ""
    else
      raise
    end
  end

use_gemdeps

Related methods

Flowdock - Team Inbox With Chat for Software Developers