123456789_123456789_123456789_123456789_123456789_

Module: Bundler::SharedHelpers

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In:
Defined in: lib/bundler/shared_helpers.rb

Instance Attribute Summary

Instance Method Summary

Instance Attribute Details

#in_bundle?Boolean (readonly)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 46

def in_bundle?
  find_gemfile
end

#md5_available?Boolean (readonly)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 180

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

#prints_major_deprecations?Boolean (readonly, private)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 370

def prints_major_deprecations?
  require_relative "../bundler"
  return false if Bundler.settings[:silence_deprecations]
  require_relative "deprecate"
  return false if Bundler::Deprecate.skip
  true
end

Instance Method Details

#bundle_bin_path

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 313

def bundle_bin_path
  # bundler exe & lib folders have same root folder, typical gem installation
  exe_file = File.expand_path("../../exe/bundle", __dir__)

  # for Ruby core repository testing
  exe_file = File.expand_path("../../libexec/bundle", __dir__) unless File.exist?(exe_file)

  # bundler is a default gem, exe path is separate
  exe_file = Bundler.rubygems.bin_path("bundler", "bundle", VERSION) unless File.exist?(exe_file)

  exe_file
end

#bundler_ruby_lib (private)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 348

def bundler_ruby_lib
  File.expand_path("..", __dir__)
end

#chdir(dir, &blk)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 50

def chdir(dir, &blk)
  Bundler.rubygems.ext_lock.synchronize do
    Dir.chdir dir, &blk
  end
end

#checksum_for_file(path, digest)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 198

def checksum_for_file(path, digest)
  return unless path.file?
  # This must use File.read instead of Digest.file().hexdigest
  # because we need to preserve \n line endings on windows when calculating
  # the checksum
  SharedHelpers.filesystem_access(path, :read) do
    File.open(path, "rb") do |f|
      digest = SharedHelpers.digest(digest).new
      buf = String.new(capacity: 16_384, encoding: Encoding::BINARY)
      digest << buf while f.read(16_384, buf)
      digest.hexdigest
    end
  end
end

#clean_load_path (private)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 352

def clean_load_path
  loaded_gem_paths = Bundler.rubygems.loaded_gem_paths

  $LOAD_PATH.reject! do |p|
    resolved_path = resolve_path(p)
    next if $LOADED_FEATURES.any? {|lf| lf.start_with?(resolved_path) }
    loaded_gem_paths.delete(p)
  end
  $LOAD_PATH.uniq!
end

#default_bundle_dir

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 34

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

Raises:

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 19

def default_gemfile
  gemfile = find_gemfile
  raise GemfileNotFound, "Could not locate Gemfile" unless gemfile
  Pathname.new(gemfile).expand_path
end

#default_lockfile

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 25

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
end

#digest(name)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 193

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

#ensure_same_dependencies(spec, old_deps, new_deps)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 150

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(", ")})." \
    "\nRunning `bundle update #{spec.name}` should fix the problem."
end

#filesystem_access(path, action = :write) { ... }

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

Examples:

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

Parameters:

  • path (String)

    the path that the action will be attempted to

  • action (Symbol, #to_s) (defaults to: :write)

    the type of operation that will be performed. For example: :write, :read, :exec

Yields:

  • path

Raises:

See Also:

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 102

def filesystem_access(path, action = :write, &block)
  yield(path.dup)
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 Errno::ENOTSUP
  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) (private)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 262

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

#find_file(*names) (private)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 256

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

#find_gemfile (private)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 246

def find_gemfile
  given = ENV["BUNDLE_GEMFILE"]
  return given if given && !given.empty?
  find_file(*gemfile_names)
end

#gemfile_names (private)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 252

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

#major_deprecation(major_version, message, removed_message: nil, print_caller_location: false)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 120

def major_deprecation(major_version, message, removed_message: nil, print_caller_location: false)
  if print_caller_location
    caller_location = caller_locations(2, 2).first
    suffix = " (called at #{caller_location.path}:#{caller_location.lineno})"
    message += suffix
    removed_message += suffix if removed_message
  end

  bundler_major_version = Bundler.bundler_major_version
  if bundler_major_version > major_version
    require_relative "errors"
    raise DeprecatedError, "[REMOVED] #{removed_message || message}"
  end

  return unless bundler_major_version >= major_version && prints_major_deprecations?
  Bundler.ui.warn("[DEPRECATED] #{message}")
end

#pretty_dependency(dep)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 168

def pretty_dependency(dep)
  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
end

#pwd

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 56

def pwd
  Bundler.rubygems.ext_lock.synchronize do
    Pathname.pwd
  end
end

#relative_gemfile_path

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 217

def relative_gemfile_path
  relative_path_to(Bundler.default_gemfile)
end

#relative_lockfile_path

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 221

def relative_lockfile_path
  relative_path_to(Bundler.default_lockfile)
end

#relative_path_to(destination, from: pwd)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 225

def relative_path_to(destination, from: pwd)
  Pathname.new(destination).relative_path_from(from).to_s
rescue ArgumentError
  # on Windows, if source and destination are on different drivers, there's no relative path from one to the other
  destination
end

#resolve_path(path) (private)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 363

def resolve_path(path)
  expanded = File.expand_path(path)
  return expanded unless File.exist?(expanded)

  File.realpath(expanded)
end

#root

Raises:

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 13

def root
  gemfile = find_gemfile
  raise GemfileNotFound, "Could not locate Gemfile" unless gemfile
  Pathname.new(gemfile).expand_path.parent
end

#search_up(*names) (private)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 268

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

  until !File.directory?(current) || current == previous
    if ENV["BUNDLER_SPEC_RUN"]
      # avoid stepping above the tmp directory when testing
      gemspec = if ENV["GEM_COMMAND"]
        # for Ruby Core
        "lib/bundler/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

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 75

def set_bundle_environment
  set_bundle_variables
  set_path
  set_rubyopt
  set_rubylib
end

#set_bundle_variables (private)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 306

def set_bundle_variables
  Bundler::SharedHelpers.set_env "BUNDLE_BIN_PATH", bundle_bin_path
  Bundler::SharedHelpers.set_env "BUNDLE_GEMFILE", find_gemfile.to_s
  Bundler::SharedHelpers.set_env "BUNDLER_VERSION", Bundler::VERSION
  Bundler::SharedHelpers.set_env "BUNDLER_SETUP", File.expand_path("setup", __dir__)
end

#set_env(key, value)

Raises:

  • (ArgumentError)
[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 295

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 (private)

[ GitHub ]

  
# 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 (private)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 342

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

#set_rubyopt (private)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 334

def set_rubyopt
  rubyopt = [ENV["RUBYOPT"]].compact
  setup_require = "-r#{File.expand_path("setup", __dir__)}"
  return if !rubyopt.empty? && rubyopt.first.include?(setup_require)
  rubyopt.unshift setup_require
  Bundler::SharedHelpers.set_env "RUBYOPT", rubyopt.join(" ")
end

#validate_bundle_path (private)

Raises:

[ GitHub ]

  
# 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

#with_clean_git_env(&block)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 62

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)

[ GitHub ]

  
# File 'lib/bundler/shared_helpers.rb', line 213

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