Module: Bundler::SharedHelpers

Extended by:
SharedHelpers
Included in:
Runtime, SharedHelpers
Defined in:
lib/bundler/shared_helpers.rb

Instance Method Summary collapse

Instance Method Details

#bundle_bin_path ⇒ Object 



308
309
310
311
312
313
314
315
316
317
318
319
 
# File 'lib/bundler/shared_helpers.rb', line 308

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

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

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

  exe_file
end

#chdir(dir, &blk) ⇒ Object 



53
54
55
56
57
 
# File 'lib/bundler/shared_helpers.rb', line 53

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

#checksum_for_file(path, digest) ⇒ Object 



200
201
202
203
204
205
206
207
208
209
210
211
212
213
 
# File 'lib/bundler/shared_helpers.rb', line 200

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

#default_bundle_dir ⇒ Object 



37
38
39
40
41
42
43
44
45
46
47
 
# File 'lib/bundler/shared_helpers.rb', line 37

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

Raises:



19
20
21
22
23
 
# 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 ⇒ Object 



25
26
27
28
29
30
31
32
33
34
35
 
# File 'lib/bundler/shared_helpers.rb', line 25

def default_lockfile
  given = ENV["BUNDLE_LOCKFILE"]
  return Pathname.new(given) if given && !given.empty?

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



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

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

#ensure_same_dependencies(spec, old_deps, new_deps) ⇒ Object

Raises:



152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
 
# File 'lib/bundler/shared_helpers.rb', line 152

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

#feature_deprecated!(message) ⇒ Object 



129
130
131
132
133
 
# File 'lib/bundler/shared_helpers.rb', line 129

def feature_deprecated!(message)
  return unless prints_major_deprecations?

  Bundler.ui.warn("[DEPRECATED] #{message}")
end

#feature_removed!(message) ⇒ Object

Raises:



135
136
137
138
 
# File 'lib/bundler/shared_helpers.rb', line 135

def feature_removed!(message)
  require_relative "errors"
  raise RemovedError, "[REMOVED] #{message}"
end

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

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

Examples:

filesystem_access("vendor/cache", :create) 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:

  • Bundler::SharedHelpers.{Bundler{Bundler::PermissionError}


105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
 
# File 'lib/bundler/shared_helpers.rb', line 105

def filesystem_access(path, action = :write, &block)
  yield(path.dup)
rescue Errno::EACCES => e
  raise unless e.message.include?(path.to_s) || action == :create

  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::EPERM
  raise OperationNotPermittedError.new(path, action)
rescue Errno::EROFS
  raise ReadOnlyFileSystemError.new(path, action)
rescue Errno::EEXIST, Errno::ENOENT
  raise
rescue SystemCallError => e
  raise GenericSystemCallError.new(e, "There was an error #{[:create, :write].include?(action) ? "creating" : "accessing"} `#{path}`.")
end

#gemspec_path ⇒ Object 



322
323
324
325
326
327
328
329
330
331
332
333
 
# File 'lib/bundler/shared_helpers.rb', line 322

def gemspec_path
  # inside a gem repository, typical gem installation
  gemspec_file = File.join(source_root, "../../specifications/bundler-#{VERSION}.gemspec")

  # for Ruby core repository testing
  gemspec_file = File.expand_path("bundler.gemspec", __dir__) unless File.exist?(gemspec_file)

  # bundler is a default gem
  gemspec_file = File.join(Gem.default_specifications_dir, "bundler-#{VERSION}.gemspec") unless File.exist?(gemspec_file)

  gemspec_file
end

#in_bundle? ⇒ Boolean

Returns:

  • (Boolean) 


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

def in_bundle?
  find_gemfile
end

#md5_available? ⇒ Boolean

Returns:

  • (Boolean) 


182
183
184
185
186
187
188
189
190
191
192
193
 
# File 'lib/bundler/shared_helpers.rb', line 182

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

#pretty_dependency(dep) ⇒ Object 



170
171
172
173
174
175
176
177
178
179
180
 
# File 'lib/bundler/shared_helpers.rb', line 170

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

#print_major_deprecations! ⇒ Object 



140
141
142
143
144
145
146
147
148
149
150
 
# File 'lib/bundler/shared_helpers.rb', line 140

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 gemfiles.size != 1
  end
  return unless multiple_gemfiles
  message = "Multiple gemfiles (gems.rb and Gemfile) detected. " \
            "Make sure you remove Gemfile and Gemfile.lock since bundler is ignoring them in favor of gems.rb and gems.locked."
  Bundler.ui.warn message
end

#pwd ⇒ Object 



59
60
61
62
63
 
# File 'lib/bundler/shared_helpers.rb', line 59

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

#relative_gemfile_path ⇒ Object 



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

def relative_gemfile_path
  relative_path_to(Bundler.default_gemfile)
end

#relative_lockfile_path ⇒ Object 



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

def relative_lockfile_path
  relative_path_to(Bundler.default_lockfile)
end

#relative_path_to(destination, from: pwd) ⇒ Object 



227
228
229
230
231
232
 
# File 'lib/bundler/shared_helpers.rb', line 227

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

#root ⇒ Object

Raises:



13
14
15
16
17
 
# 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

#set_bundle_environment ⇒ Object 



78
79
80
81
82
83
 
# File 'lib/bundler/shared_helpers.rb', line 78

def set_bundle_environment
  set_bundle_variables
  set_path
  set_rubyopt
  set_rubylib
end

#set_env(key, value) ⇒ Object

Raises:

  • (ArgumentError) 


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

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

#with_clean_git_env(&block) ⇒ Object 



65
66
67
68
69
70
71
72
73
74
75
76
 
# File 'lib/bundler/shared_helpers.rb', line 65

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



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

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