module Bundler::SharedHelpers

Public Instance Methods

bundler_ruby_lib() click to toggle source
# File lib/bundler/shared_helpers.rb, line 347
def bundler_ruby_lib
  resolve_path File.expand_path("../..", __FILE__)
end
chdir(dir, &blk) click to toggle source
# File lib/bundler/shared_helpers.rb, line 63
def chdir(dir, &blk)
  Bundler.rubygems.ext_lock.synchronize do
    Dir.chdir dir, &blk
  end
end
clean_load_path() click to toggle source
# File lib/bundler/shared_helpers.rb, line 351
  def clean_load_path
    # handle 1.9 where system gems are always on the load path
    return unless defined?(::Gem)

    bundler_lib = bundler_ruby_lib

    loaded_gem_paths = Bundler.rubygems.loaded_gem_paths

    $LOAD_PATH.reject! do |p|
      next if resolve_path(p).start_with?(bundler_lib)
      loaded_gem_paths.delete(p)
    end
    $LOAD_PATH.uniq!
  end

  def resolve_path(path)
    expanded = File.expand_path(path)
    return expanded unless File.respond_to?(:realpath) && File.exist?(expanded)

    File.realpath(expanded)
  end

  def prints_major_deprecations?
    require "bundler"
    deprecation_release = Bundler::VERSION.split(".").drop(1).include?("99")
    return false if !deprecation_release && !Bundler.settings[:major_deprecations]
    require "bundler/deprecate"
    return false if Bundler::Deprecate.skip
    true
  end

  extend self
end
const_get_safely(constant_name, namespace) click to toggle source
# File lib/bundler/shared_helpers.rb, line 135
def const_get_safely(constant_name, namespace)
  const_in_namespace = namespace.constants.include?(constant_name.to_s) ||
    namespace.constants.include?(constant_name.to_sym)
  return nil unless const_in_namespace
  namespace.const_get(constant_name)
end
default_bundle_dir() click to toggle source
# File lib/bundler/shared_helpers.rb, line 47
def default_bundle_dir
  bundle_dir = find_directory(".bundle")
  return nil unless bundle_dir

  bundle_dir = Pathname.new(bundle_dir)

  global_bundle_dir = Bundler.user_home.join(".bundle")
  return nil if bundle_dir == global_bundle_dir

  bundle_dir
end
default_gemfile() click to toggle source
# File lib/bundler/shared_helpers.rb, line 32
def default_gemfile
  gemfile = find_gemfile(:order_matters)
  raise GemfileNotFound, "Could not locate Gemfile" unless gemfile
  Pathname.new(gemfile).untaint.expand_path
end
default_lockfile() click to toggle source
# File lib/bundler/shared_helpers.rb, line 38
def default_lockfile
  gemfile = default_gemfile

  case gemfile.basename.to_s
  when "gems.rb" then Pathname.new(gemfile.sub(/.rb$/, ".locked"))
  else Pathname.new("#{gemfile}.lock")
  end.untaint
end
digest(name) click to toggle source
# File lib/bundler/shared_helpers.rb, line 223
def digest(name)
  require "digest"
  Digest(name)
end
ensure_same_dependencies(spec, old_deps, new_deps) click to toggle source
# File lib/bundler/shared_helpers.rb, line 179
  def ensure_same_dependencies(spec, old_deps, new_deps)
    new_deps = new_deps.reject {|d| d.type == :development }
    old_deps = old_deps.reject {|d| d.type == :development }

    without_type = proc {|d| Gem::Dependency.new(d.name, d.requirements_list.sort) }
    new_deps.map!(&without_type)
    old_deps.map!(&without_type)

    extra_deps = new_deps - old_deps
    return if extra_deps.empty?

    Bundler.ui.debug "#{spec.full_name} from #{spec.remote} has either corrupted API or lockfile dependencies" \
      " (was expecting #{old_deps.map(&:to_s)}, but the real spec has #{new_deps.map(&:to_s)})"
    raise APIResponseMismatchError,
      "Downloading #{spec.full_name} revealed dependencies not in the API or the lockfile (#{extra_deps.join(", ")})." \
      "\nEither installing with `--full-index` or running `bundle update #{spec.name}` should fix the problem."
  end

  def pretty_dependency(dep, print_source = false)
    msg = String.new(dep.name)
    msg << " (#{dep.requirement})" unless dep.requirement == Gem::Requirement.default

    if dep.is_a?(Bundler::Dependency)
      platform_string = dep.platforms.join(", ")
      msg << " " << platform_string if !platform_string.empty? && platform_string != Gem::Platform::RUBY
    end

    msg << " from the `#{dep.source}` source" if print_source && dep.source
    msg
  end

  def md5_available?
    return @md5_available if defined?(@md5_available)
    @md5_available = begin
      require "openssl"
      OpenSSL::Digest::MD5.digest("")
      true
    rescue LoadError
      true
    rescue OpenSSL::Digest::DigestError
      false
    end
  end

  def digest(name)
    require "digest"
    Digest(name)
  end

  def write_to_gemfile(gemfile_path, contents)
    filesystem_access(gemfile_path) {|g| File.open(g, "w") {|file| file.puts contents } }
  end

private

  def validate_bundle_path
    path_separator = Bundler.rubygems.path_separator
    return unless Bundler.bundle_path.to_s.split(path_separator).size > 1
    message = "Your bundle path contains text matching #{path_separator.inspect}, " \
              "which is the path separator for your system. Bundler cannot " \
              "function correctly when the Bundle path contains the " \
              "system's PATH separator. Please change your " \
              "bundle path to not match #{path_separator.inspect}." \
              "\nYour current bundle path is '#{Bundler.bundle_path}'."
    raise Bundler::PathError, message
  end

  def find_gemfile(order_matters = false)
    given = ENV["BUNDLE_GEMFILE"]
    return given if given && !given.empty?
    names = gemfile_names
    names.reverse! if order_matters && Bundler.feature_flag.prefer_gems_rb?
    find_file(*names)
  end

  def gemfile_names
    ["Gemfile", "gems.rb"]
  end

  def find_file(*names)
    search_up(*names) do |filename|
      return filename if File.file?(filename)
    end
  end

  def find_directory(*names)
    search_up(*names) do |dirname|
      return dirname if File.directory?(dirname)
    end
  end

  def search_up(*names)
    previous = nil
    current  = File.expand_path(SharedHelpers.pwd).untaint

    until !File.directory?(current) || current == previous
      if ENV["BUNDLE_SPEC_RUN"]
        # avoid stepping above the tmp directory when testing
        gemspec = if ENV["BUNDLE_RUBY"] && ENV["BUNDLE_GEM"]
          # for Ruby Core
          "lib/bundler.gemspec"
        else
          "bundler.gemspec"
        end

        # avoid stepping above the tmp directory when testing
        return nil if File.file?(File.join(current, gemspec))
      end

      names.each do |name|
        filename = File.join(current, name)
        yield filename
      end
      previous = current
      current = File.expand_path("..", current)
    end
  end

  def set_env(key, value)
    raise ArgumentError, "new key #{key}" unless EnvironmentPreserver::BUNDLER_KEYS.include?(key)
    orig_key = "#{EnvironmentPreserver::BUNDLER_PREFIX}#{key}"
    orig = ENV[key]
    orig ||= EnvironmentPreserver::INTENTIONALLY_NIL
    ENV[orig_key] ||= orig

    ENV[key] = value
  end
  public :set_env

  def set_bundle_variables
    begin
      exe_file = Bundler.rubygems.bin_path("bundler", "bundle", VERSION)
      unless File.exist?(exe_file)
        exe_file = File.expand_path("../../../exe/bundle", __FILE__)
      end
      Bundler::SharedHelpers.set_env "BUNDLE_BIN_PATH", exe_file
    rescue Gem::GemNotFoundException
      exe_file = File.expand_path("../../../exe/bundle", __FILE__)
      # for Ruby core repository
      exe_file = File.expand_path("../../../../bin/bundle", __FILE__) unless File.exist?(exe_file)
      Bundler::SharedHelpers.set_env "BUNDLE_BIN_PATH", exe_file
    end

    # Set BUNDLE_GEMFILE
    Bundler::SharedHelpers.set_env "BUNDLE_GEMFILE", find_gemfile(:order_matters).to_s
    Bundler::SharedHelpers.set_env "BUNDLER_VERSION", Bundler::VERSION
  end

  def set_path
    validate_bundle_path
    paths = (ENV["PATH"] || "").split(File::PATH_SEPARATOR)
    paths.unshift "#{Bundler.bundle_path}/bin"
    Bundler::SharedHelpers.set_env "PATH", paths.uniq.join(File::PATH_SEPARATOR)
  end

  def set_rubyopt
    rubyopt = [ENV["RUBYOPT"]].compact
    return if !rubyopt.empty? && rubyopt.first =~ %r{-rbundler/setup}
    rubyopt.unshift %(-rbundler/setup)
    Bundler::SharedHelpers.set_env "RUBYOPT", rubyopt.join(" ")
  end

  def set_rubylib
    rubylib = (ENV["RUBYLIB"] || "").split(File::PATH_SEPARATOR)
    rubylib.unshift bundler_ruby_lib
    Bundler::SharedHelpers.set_env "RUBYLIB", rubylib.uniq.join(File::PATH_SEPARATOR)
  end

  def bundler_ruby_lib
    resolve_path File.expand_path("../..", __FILE__)
  end

  def clean_load_path
    # handle 1.9 where system gems are always on the load path
    return unless defined?(::Gem)

    bundler_lib = bundler_ruby_lib

    loaded_gem_paths = Bundler.rubygems.loaded_gem_paths

    $LOAD_PATH.reject! do |p|
      next if resolve_path(p).start_with?(bundler_lib)
      loaded_gem_paths.delete(p)
    end
    $LOAD_PATH.uniq!
  end

  def resolve_path(path)
    expanded = File.expand_path(path)
    return expanded unless File.respond_to?(:realpath) && File.exist?(expanded)

    File.realpath(expanded)
  end

  def prints_major_deprecations?
    require "bundler"
    deprecation_release = Bundler::VERSION.split(".").drop(1).include?("99")
    return false if !deprecation_release && !Bundler.settings[:major_deprecations]
    require "bundler/deprecate"
    return false if Bundler::Deprecate.skip
    true
  end

  extend self
filesystem_access(path, action = :write, &block) click to toggle source

Rescues permissions errors raised by file system operations (ie. Errno:EACCESS, Errno::EAGAIN) and raises more friendly errors instead.

@param path [String] the path that the action will be attempted to @param action [Symbol, to_s] the type of operation that will be

performed. For example: :write, :read, :exec

@yield path

@raise [Bundler::PermissionError] if Errno:EACCES is raised in the

given block

@raise [Bundler::TemporaryResourceError] if Errno:EAGAIN is raised in the

given block

@example

filesystem_access("vendor/cache", :write) do
  FileUtils.mkdir_p("vendor/cache")
end

@see {Bundler::PermissionError}

# File lib/bundler/shared_helpers.rb, line 115
def filesystem_access(path, action = :write, &block)
  # Use block.call instead of yield because of a bug in Ruby 2.2.2
  # See https://github.com/bundler/bundler/issues/5341 for details
  block.call(path.dup.untaint)
rescue Errno::EACCES
  raise PermissionError.new(path, action)
rescue Errno::EAGAIN
  raise TemporaryResourceError.new(path, action)
rescue Errno::EPROTO
  raise VirtualProtocolError.new
rescue Errno::ENOSPC
  raise NoSpaceOnDeviceError.new(path, action)
rescue *[const_get_safely(:ENOTSUP, Errno)].compact
  raise OperationNotSupportedError.new(path, action)
rescue Errno::EEXIST, Errno::ENOENT
  raise
rescue SystemCallError => e
  raise GenericSystemCallError.new(e, "There was an error accessing `#{path}`.")
end
find_directory(*names) click to toggle source
# File lib/bundler/shared_helpers.rb, line 264
def find_directory(*names)
  search_up(*names) do |dirname|
    return dirname if File.directory?(dirname)
  end
end
find_file(*names) click to toggle source
# File lib/bundler/shared_helpers.rb, line 258
def find_file(*names)
  search_up(*names) do |filename|
    return filename if File.file?(filename)
  end
end
find_gemfile(order_matters = false) click to toggle source
# File lib/bundler/shared_helpers.rb, line 246
def find_gemfile(order_matters = false)
  given = ENV["BUNDLE_GEMFILE"]
  return given if given && !given.empty?
  names = gemfile_names
  names.reverse! if order_matters && Bundler.feature_flag.prefer_gems_rb?
  find_file(*names)
end
gemfile_names() click to toggle source
# File lib/bundler/shared_helpers.rb, line 254
def gemfile_names
  ["Gemfile", "gems.rb"]
end
in_bundle?() click to toggle source
# File lib/bundler/shared_helpers.rb, line 59
def in_bundle?
  find_gemfile
end
major_deprecation(major_version, message) click to toggle source
# File lib/bundler/shared_helpers.rb, line 142
  def major_deprecation(major_version, message)
    if Bundler.bundler_major_version >= major_version
      require "bundler/errors"
      raise DeprecatedError, "[REMOVED FROM #{major_version}.0] #{message}"
    end

    return unless prints_major_deprecations?
    @major_deprecation_ui ||= Bundler::UI::Shell.new("no-color" => true)
    ui = Bundler.ui.is_a?(@major_deprecation_ui.class) ? Bundler.ui : @major_deprecation_ui
    ui.warn("[DEPRECATED FOR #{major_version}.0] #{message}")
  end

  def print_major_deprecations!
    multiple_gemfiles = search_up(".") do |dir|
      gemfiles = gemfile_names.select {|gf| File.file? File.expand_path(gf, dir) }
      next if gemfiles.empty?
      break false if gemfiles.size == 1
    end
    if multiple_gemfiles && Bundler.bundler_major_version == 2
      Bundler::SharedHelpers.major_deprecation 3, \
        "gems.rb and gems.locked will be preferred to Gemfile and Gemfile.lock."
    end

    if RUBY_VERSION < "2"
      major_deprecation(2, "Bundler will only support ruby >= 2.0, you are running #{RUBY_VERSION}")
    end
    return if Bundler.rubygems.provides?(">= 2")
    major_deprecation(2, "Bundler will only support rubygems >= 2.0, you are running #{Bundler.rubygems.version}")
  end

  def trap(signal, override = false, &block)
    prior = Signal.trap(signal) do
      block.call
      prior.call unless override
    end
  end

  def ensure_same_dependencies(spec, old_deps, new_deps)
    new_deps = new_deps.reject {|d| d.type == :development }
    old_deps = old_deps.reject {|d| d.type == :development }

    without_type = proc {|d| Gem::Dependency.new(d.name, d.requirements_list.sort) }
    new_deps.map!(&without_type)
    old_deps.map!(&without_type)

    extra_deps = new_deps - old_deps
    return if extra_deps.empty?

    Bundler.ui.debug "#{spec.full_name} from #{spec.remote} has either corrupted API or lockfile dependencies" \
      " (was expecting #{old_deps.map(&:to_s)}, but the real spec has #{new_deps.map(&:to_s)})"
    raise APIResponseMismatchError,
      "Downloading #{spec.full_name} revealed dependencies not in the API or the lockfile (#{extra_deps.join(", ")})." \
      "\nEither installing with `--full-index` or running `bundle update #{spec.name}` should fix the problem."
  end

  def pretty_dependency(dep, print_source = false)
    msg = String.new(dep.name)
    msg << " (#{dep.requirement})" unless dep.requirement == Gem::Requirement.default

    if dep.is_a?(Bundler::Dependency)
      platform_string = dep.platforms.join(", ")
      msg << " " << platform_string if !platform_string.empty? && platform_string != Gem::Platform::RUBY
    end

    msg << " from the `#{dep.source}` source" if print_source && dep.source
    msg
  end

  def md5_available?
    return @md5_available if defined?(@md5_available)
    @md5_available = begin
      require "openssl"
      OpenSSL::Digest::MD5.digest("")
      true
    rescue LoadError
      true
    rescue OpenSSL::Digest::DigestError
      false
    end
  end

  def digest(name)
    require "digest"
    Digest(name)
  end

  def write_to_gemfile(gemfile_path, contents)
    filesystem_access(gemfile_path) {|g| File.open(g, "w") {|file| file.puts contents } }
  end

private

  def validate_bundle_path
    path_separator = Bundler.rubygems.path_separator
    return unless Bundler.bundle_path.to_s.split(path_separator).size > 1
    message = "Your bundle path contains text matching #{path_separator.inspect}, " \
              "which is the path separator for your system. Bundler cannot " \
              "function correctly when the Bundle path contains the " \
              "system's PATH separator. Please change your " \
              "bundle path to not match #{path_separator.inspect}." \
              "\nYour current bundle path is '#{Bundler.bundle_path}'."
    raise Bundler::PathError, message
  end

  def find_gemfile(order_matters = false)
    given = ENV["BUNDLE_GEMFILE"]
    return given if given && !given.empty?
    names = gemfile_names
    names.reverse! if order_matters && Bundler.feature_flag.prefer_gems_rb?
    find_file(*names)
  end

  def gemfile_names
    ["Gemfile", "gems.rb"]
  end

  def find_file(*names)
    search_up(*names) do |filename|
      return filename if File.file?(filename)
    end
  end

  def find_directory(*names)
    search_up(*names) do |dirname|
      return dirname if File.directory?(dirname)
    end
  end

  def search_up(*names)
    previous = nil
    current  = File.expand_path(SharedHelpers.pwd).untaint

    until !File.directory?(current) || current == previous
      if ENV["BUNDLE_SPEC_RUN"]
        # avoid stepping above the tmp directory when testing
        gemspec = if ENV["BUNDLE_RUBY"] && ENV["BUNDLE_GEM"]
          # for Ruby Core
          "lib/bundler.gemspec"
        else
          "bundler.gemspec"
        end

        # avoid stepping above the tmp directory when testing
        return nil if File.file?(File.join(current, gemspec))
      end

      names.each do |name|
        filename = File.join(current, name)
        yield filename
      end
      previous = current
      current = File.expand_path("..", current)
    end
  end

  def set_env(key, value)
    raise ArgumentError, "new key #{key}" unless EnvironmentPreserver::BUNDLER_KEYS.include?(key)
    orig_key = "#{EnvironmentPreserver::BUNDLER_PREFIX}#{key}"
    orig = ENV[key]
    orig ||= EnvironmentPreserver::INTENTIONALLY_NIL
    ENV[orig_key] ||= orig

    ENV[key] = value
  end
  public :set_env

  def set_bundle_variables
    begin
      exe_file = Bundler.rubygems.bin_path("bundler", "bundle", VERSION)
      unless File.exist?(exe_file)
        exe_file = File.expand_path("../../../exe/bundle", __FILE__)
      end
      Bundler::SharedHelpers.set_env "BUNDLE_BIN_PATH", exe_file
    rescue Gem::GemNotFoundException
      exe_file = File.expand_path("../../../exe/bundle", __FILE__)
      # for Ruby core repository
      exe_file = File.expand_path("../../../../bin/bundle", __FILE__) unless File.exist?(exe_file)
      Bundler::SharedHelpers.set_env "BUNDLE_BIN_PATH", exe_file
    end

    # Set BUNDLE_GEMFILE
    Bundler::SharedHelpers.set_env "BUNDLE_GEMFILE", find_gemfile(:order_matters).to_s
    Bundler::SharedHelpers.set_env "BUNDLER_VERSION", Bundler::VERSION
  end

  def set_path
    validate_bundle_path
    paths = (ENV["PATH"] || "").split(File::PATH_SEPARATOR)
    paths.unshift "#{Bundler.bundle_path}/bin"
    Bundler::SharedHelpers.set_env "PATH", paths.uniq.join(File::PATH_SEPARATOR)
  end

  def set_rubyopt
    rubyopt = [ENV["RUBYOPT"]].compact
    return if !rubyopt.empty? && rubyopt.first =~ %r{-rbundler/setup}
    rubyopt.unshift %(-rbundler/setup)
    Bundler::SharedHelpers.set_env "RUBYOPT", rubyopt.join(" ")
  end

  def set_rubylib
    rubylib = (ENV["RUBYLIB"] || "").split(File::PATH_SEPARATOR)
    rubylib.unshift bundler_ruby_lib
    Bundler::SharedHelpers.set_env "RUBYLIB", rubylib.uniq.join(File::PATH_SEPARATOR)
  end

  def bundler_ruby_lib
    resolve_path File.expand_path("../..", __FILE__)
  end

  def clean_load_path
    # handle 1.9 where system gems are always on the load path
    return unless defined?(::Gem)

    bundler_lib = bundler_ruby_lib

    loaded_gem_paths = Bundler.rubygems.loaded_gem_paths

    $LOAD_PATH.reject! do |p|
      next if resolve_path(p).start_with?(bundler_lib)
      loaded_gem_paths.delete(p)
    end
    $LOAD_PATH.uniq!
  end

  def resolve_path(path)
    expanded = File.expand_path(path)
    return expanded unless File.respond_to?(:realpath) && File.exist?(expanded)

    File.realpath(expanded)
  end

  def prints_major_deprecations?
    require "bundler"
    deprecation_release = Bundler::VERSION.split(".").drop(1).include?("99")
    return false if !deprecation_release && !Bundler.settings[:major_deprecations]
    require "bundler/deprecate"
    return false if Bundler::Deprecate.skip
    true
  end

  
md5_available?() click to toggle source
# File lib/bundler/shared_helpers.rb, line 210
def md5_available?
  return @md5_available if defined?(@md5_available)
  @md5_available = begin
    require "openssl"
    OpenSSL::Digest::MD5.digest("")
    true
  rescue LoadError
    true
  rescue OpenSSL::Digest::DigestError
    false
  end
end
pretty_dependency(dep, print_source = false) click to toggle source
# File lib/bundler/shared_helpers.rb, line 197
def pretty_dependency(dep, print_source = false)
  msg = String.new(dep.name)
  msg << " (#{dep.requirement})" unless dep.requirement == Gem::Requirement.default

  if dep.is_a?(Bundler::Dependency)
    platform_string = dep.platforms.join(", ")
    msg << " " << platform_string if !platform_string.empty? && platform_string != Gem::Platform::RUBY
  end

  msg << " from the `#{dep.source}` source" if print_source && dep.source
  msg
end
print_major_deprecations!() click to toggle source
prints_major_deprecations?() click to toggle source
# File lib/bundler/shared_helpers.rb, line 373
def prints_major_deprecations?
  require "bundler"
  deprecation_release = Bundler::VERSION.split(".").drop(1).include?("99")
  return false if !deprecation_release && !Bundler.settings[:major_deprecations]
  require "bundler/deprecate"
  return false if Bundler::Deprecate.skip
  true
end
pwd() click to toggle source
# File lib/bundler/shared_helpers.rb, line 69
def pwd
  Bundler.rubygems.ext_lock.synchronize do
    Pathname.pwd
  end
end
resolve_path(path) click to toggle source
# File lib/bundler/shared_helpers.rb, line 366
def resolve_path(path)
  expanded = File.expand_path(path)
  return expanded unless File.respond_to?(:realpath) && File.exist?(expanded)

  File.realpath(expanded)
end
root() click to toggle source
# File lib/bundler/shared_helpers.rb, line 26
def root
  gemfile = find_gemfile
  raise GemfileNotFound, "Could not locate Gemfile" unless gemfile
  Pathname.new(gemfile).untaint.expand_path.parent
end
search_up(*names) { |filename| ... } click to toggle source
# File lib/bundler/shared_helpers.rb, line 270
def search_up(*names)
  previous = nil
  current  = File.expand_path(SharedHelpers.pwd).untaint

  until !File.directory?(current) || current == previous
    if ENV["BUNDLE_SPEC_RUN"]
      # avoid stepping above the tmp directory when testing
      gemspec = if ENV["BUNDLE_RUBY"] && ENV["BUNDLE_GEM"]
        # for Ruby Core
        "lib/bundler.gemspec"
      else
        "bundler.gemspec"
      end

      # avoid stepping above the tmp directory when testing
      return nil if File.file?(File.join(current, gemspec))
    end

    names.each do |name|
      filename = File.join(current, name)
      yield filename
    end
    previous = current
    current = File.expand_path("..", current)
  end
end
set_bundle_environment() click to toggle source
# File lib/bundler/shared_helpers.rb, line 88
def set_bundle_environment
  set_bundle_variables
  set_path
  set_rubyopt
  set_rubylib
end
set_bundle_variables() click to toggle source
# File lib/bundler/shared_helpers.rb, line 308
def set_bundle_variables
  begin
    exe_file = Bundler.rubygems.bin_path("bundler", "bundle", VERSION)
    unless File.exist?(exe_file)
      exe_file = File.expand_path("../../../exe/bundle", __FILE__)
    end
    Bundler::SharedHelpers.set_env "BUNDLE_BIN_PATH", exe_file
  rescue Gem::GemNotFoundException
    exe_file = File.expand_path("../../../exe/bundle", __FILE__)
    # for Ruby core repository
    exe_file = File.expand_path("../../../../bin/bundle", __FILE__) unless File.exist?(exe_file)
    Bundler::SharedHelpers.set_env "BUNDLE_BIN_PATH", exe_file
  end

  # Set BUNDLE_GEMFILE
  Bundler::SharedHelpers.set_env "BUNDLE_GEMFILE", find_gemfile(:order_matters).to_s
  Bundler::SharedHelpers.set_env "BUNDLER_VERSION", Bundler::VERSION
end
set_env(key, value) click to toggle source
# File lib/bundler/shared_helpers.rb, line 297
def set_env(key, value)
  raise ArgumentError, "new key #{key}" unless EnvironmentPreserver::BUNDLER_KEYS.include?(key)
  orig_key = "#{EnvironmentPreserver::BUNDLER_PREFIX}#{key}"
  orig = ENV[key]
  orig ||= EnvironmentPreserver::INTENTIONALLY_NIL
  ENV[orig_key] ||= orig

  ENV[key] = value
end
set_path() click to toggle source
# File lib/bundler/shared_helpers.rb, line 327
def set_path
  validate_bundle_path
  paths = (ENV["PATH"] || "").split(File::PATH_SEPARATOR)
  paths.unshift "#{Bundler.bundle_path}/bin"
  Bundler::SharedHelpers.set_env "PATH", paths.uniq.join(File::PATH_SEPARATOR)
end
set_rubylib() click to toggle source
# File lib/bundler/shared_helpers.rb, line 341
def set_rubylib
  rubylib = (ENV["RUBYLIB"] || "").split(File::PATH_SEPARATOR)
  rubylib.unshift bundler_ruby_lib
  Bundler::SharedHelpers.set_env "RUBYLIB", rubylib.uniq.join(File::PATH_SEPARATOR)
end
set_rubyopt() click to toggle source
# File lib/bundler/shared_helpers.rb, line 334
    def set_rubyopt
      rubyopt = [ENV["RUBYOPT"]].compact
      return if !rubyopt.empty? && rubyopt.first =~ %r{-rbundler/setup}
      rubyopt.unshift %(-rbundler/setup)
      Bundler::SharedHelpers.set_env "RUBYOPT", rubyopt.join(" ")
    end

    def set_rubylib
      rubylib = (ENV["RUBYLIB"] || "").split(File::PATH_SEPARATOR)
      rubylib.unshift bundler_ruby_lib
      Bundler::SharedHelpers.set_env "RUBYLIB", rubylib.uniq.join(File::PATH_SEPARATOR)
    end

    def bundler_ruby_lib
      resolve_path File.expand_path("../..", __FILE__)
    end

    def clean_load_path
      # handle 1.9 where system gems are always on the load path
      return unless defined?(::Gem)

      bundler_lib = bundler_ruby_lib

      loaded_gem_paths = Bundler.rubygems.loaded_gem_paths

      $LOAD_PATH.reject! do |p|
        next if resolve_path(p).start_with?(bundler_lib)
        loaded_gem_paths.delete(p)
      end
      $LOAD_PATH.uniq!
    end

    def resolve_path(path)
      expanded = File.expand_path(path)
      return expanded unless File.respond_to?(:realpath) && File.exist?(expanded)

      File.realpath(expanded)
    end

    def prints_major_deprecations?
      require "bundler"
      deprecation_release = Bundler::VERSION.split(".").drop(1).include?("99")
      return false if !deprecation_release && !Bundler.settings[:major_deprecations]
      require "bundler/deprecate"
      return false if Bundler::Deprecate.skip
      true
    end

    extend self
  end
end
trap(signal, override = false, &block) click to toggle source
# File lib/bundler/shared_helpers.rb, line 172
def trap(signal, override = false, &block)
  prior = Signal.trap(signal) do
    block.call
    prior.call unless override
  end
end
validate_bundle_path() click to toggle source
# File lib/bundler/shared_helpers.rb, line 234
  def validate_bundle_path
    path_separator = Bundler.rubygems.path_separator
    return unless Bundler.bundle_path.to_s.split(path_separator).size > 1
    message = "Your bundle path contains text matching #{path_separator.inspect}, " \
              "which is the path separator for your system. Bundler cannot " \
              "function correctly when the Bundle path contains the " \
              "system's PATH separator. Please change your " \
              "bundle path to not match #{path_separator.inspect}." \
              "\nYour current bundle path is '#{Bundler.bundle_path}'."
    raise Bundler::PathError, message
  end

  def find_gemfile(order_matters = false)
    given = ENV["BUNDLE_GEMFILE"]
    return given if given && !given.empty?
    names = gemfile_names
    names.reverse! if order_matters && Bundler.feature_flag.prefer_gems_rb?
    find_file(*names)
  end

  def gemfile_names
    ["Gemfile", "gems.rb"]
  end

  def find_file(*names)
    search_up(*names) do |filename|
      return filename if File.file?(filename)
    end
  end

  def find_directory(*names)
    search_up(*names) do |dirname|
      return dirname if File.directory?(dirname)
    end
  end

  def search_up(*names)
    previous = nil
    current  = File.expand_path(SharedHelpers.pwd).untaint

    until !File.directory?(current) || current == previous
      if ENV["BUNDLE_SPEC_RUN"]
        # avoid stepping above the tmp directory when testing
        gemspec = if ENV["BUNDLE_RUBY"] && ENV["BUNDLE_GEM"]
          # for Ruby Core
          "lib/bundler.gemspec"
        else
          "bundler.gemspec"
        end

        # avoid stepping above the tmp directory when testing
        return nil if File.file?(File.join(current, gemspec))
      end

      names.each do |name|
        filename = File.join(current, name)
        yield filename
      end
      previous = current
      current = File.expand_path("..", current)
    end
  end

  def set_env(key, value)
    raise ArgumentError, "new key #{key}" unless EnvironmentPreserver::BUNDLER_KEYS.include?(key)
    orig_key = "#{EnvironmentPreserver::BUNDLER_PREFIX}#{key}"
    orig = ENV[key]
    orig ||= EnvironmentPreserver::INTENTIONALLY_NIL
    ENV[orig_key] ||= orig

    ENV[key] = value
  end
  public :set_env

  def set_bundle_variables
    begin
      exe_file = Bundler.rubygems.bin_path("bundler", "bundle", VERSION)
      unless File.exist?(exe_file)
        exe_file = File.expand_path("../../../exe/bundle", __FILE__)
      end
      Bundler::SharedHelpers.set_env "BUNDLE_BIN_PATH", exe_file
    rescue Gem::GemNotFoundException
      exe_file = File.expand_path("../../../exe/bundle", __FILE__)
      # for Ruby core repository
      exe_file = File.expand_path("../../../../bin/bundle", __FILE__) unless File.exist?(exe_file)
      Bundler::SharedHelpers.set_env "BUNDLE_BIN_PATH", exe_file
    end

    # Set BUNDLE_GEMFILE
    Bundler::SharedHelpers.set_env "BUNDLE_GEMFILE", find_gemfile(:order_matters).to_s
    Bundler::SharedHelpers.set_env "BUNDLER_VERSION", Bundler::VERSION
  end

  def set_path
    validate_bundle_path
    paths = (ENV["PATH"] || "").split(File::PATH_SEPARATOR)
    paths.unshift "#{Bundler.bundle_path}/bin"
    Bundler::SharedHelpers.set_env "PATH", paths.uniq.join(File::PATH_SEPARATOR)
  end

  def set_rubyopt
    rubyopt = [ENV["RUBYOPT"]].compact
    return if !rubyopt.empty? && rubyopt.first =~ %r{-rbundler/setup}
    rubyopt.unshift %(-rbundler/setup)
    Bundler::SharedHelpers.set_env "RUBYOPT", rubyopt.join(" ")
  end

  def set_rubylib
    rubylib = (ENV["RUBYLIB"] || "").split(File::PATH_SEPARATOR)
    rubylib.unshift bundler_ruby_lib
    Bundler::SharedHelpers.set_env "RUBYLIB", rubylib.uniq.join(File::PATH_SEPARATOR)
  end

  def bundler_ruby_lib
    resolve_path File.expand_path("../..", __FILE__)
  end

  def clean_load_path
    # handle 1.9 where system gems are always on the load path
    return unless defined?(::Gem)

    bundler_lib = bundler_ruby_lib

    loaded_gem_paths = Bundler.rubygems.loaded_gem_paths

    $LOAD_PATH.reject! do |p|
      next if resolve_path(p).start_with?(bundler_lib)
      loaded_gem_paths.delete(p)
    end
    $LOAD_PATH.uniq!
  end

  def resolve_path(path)
    expanded = File.expand_path(path)
    return expanded unless File.respond_to?(:realpath) && File.exist?(expanded)

    File.realpath(expanded)
  end

  def prints_major_deprecations?
    require "bundler"
    deprecation_release = Bundler::VERSION.split(".").drop(1).include?("99")
    return false if !deprecation_release && !Bundler.settings[:major_deprecations]
    require "bundler/deprecate"
    return false if Bundler::Deprecate.skip
    true
  end

  extend self
end
with_clean_git_env(&block) click to toggle source
# File lib/bundler/shared_helpers.rb, line 75
def with_clean_git_env(&block)
  keys    = %w[GIT_DIR GIT_WORK_TREE]
  old_env = keys.inject({}) do |h, k|
    h.update(k => ENV[k])
  end

  keys.each {|key| ENV.delete(key) }

  block.call
ensure
  keys.each {|key| ENV[key] = old_env[key] }
end
write_to_gemfile(gemfile_path, contents) click to toggle source
# File lib/bundler/shared_helpers.rb, line 228
def write_to_gemfile(gemfile_path, contents)
  filesystem_access(gemfile_path) {|g| File.open(g, "w") {|file| file.puts contents } }
end