Module: Bundler::SharedHelpers
Relationships & Source Files | |
Extension / Inclusion / Inheritance Descendants | |
Included In:
| |
Defined in: | lib/bundler/shared_helpers.rb |
Instance Attribute Summary
- #in_bundle? ⇒ Boolean readonly
- #md5_available? ⇒ Boolean readonly
- #prints_major_deprecations? ⇒ Boolean readonly private
Instance Method Summary
- #chdir(dir, &blk)
- #const_get_safely(constant_name, namespace)
- #default_bundle_dir
- #default_gemfile
- #default_lockfile
- #digest(name)
- #ensure_same_dependencies(spec, old_deps, new_deps)
-
#filesystem_access(path, action = :write) { ... }
Rescues permissions errors raised by file system operations (ie.
- #major_deprecation(major_version, message)
- #pretty_dependency(dep, print_source = false)
- #print_major_deprecations!
- #pwd
- #root
- #set_bundle_environment
- #set_env(key, value)
- #trap(signal, override = false, &block)
- #with_clean_git_env(&block)
- #write_to_gemfile(gemfile_path, contents)
- #bundler_ruby_lib private
- #clean_load_path private
- #find_directory(*names) private
- #find_file(*names) private
- #find_gemfile(order_matters = false) private
- #gemfile_names private
- #resolve_path(path) private
- #search_up(*names) private
- #set_bundle_variables private
- #set_path private
- #set_rubylib private
- #set_rubyopt private
- #validate_bundle_path private
Instance Attribute Details
#in_bundle? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'lib/bundler/shared_helpers.rb', line 59
def in_bundle? find_gemfile end
#md5_available? ⇒ Boolean
(readonly)
[ GitHub ]
#prints_major_deprecations? ⇒ Boolean
(readonly, private)
[ GitHub ]
# 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
Instance Method Details
#bundler_ruby_lib (private)
[ GitHub ]# File 'lib/bundler/shared_helpers.rb', line 347
def bundler_ruby_lib resolve_path File. ("../..", __FILE__) end
#chdir(dir, &blk)
[ GitHub ]#clean_load_path (private)
[ GitHub ]# 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
#const_get_safely(constant_name, namespace)
[ GitHub ]# 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
[ GitHub ]# 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
# 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. end
#default_lockfile
[ GitHub ]# 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)
[ GitHub ]# File 'lib/bundler/shared_helpers.rb', line 223
def digest(name) require "digest" Digest(name) end
#ensure_same_dependencies(spec, old_deps, new_deps)
# 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
#filesystem_access(path, action = :write) { ... }
Rescues permissions errors raised by file system operations (ie. Errno:EACCESS, Errno::EAGAIN
) and raises more friendly errors instead.
# 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) (private)
[ GitHub ]# 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) (private)
[ GitHub ]# 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) (private)
[ GitHub ]# 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 (private)
[ GitHub ]# File 'lib/bundler/shared_helpers.rb', line 254
def gemfile_names ["Gemfile", "gems.rb"] end
#major_deprecation(major_version, message)
[ GitHub ]# File 'lib/bundler/shared_helpers.rb', line 142
def major_deprecation(major_version, ) if Bundler.bundler_major_version >= major_version require "bundler/errors" raise DeprecatedError, "[REMOVED FROM #{major_version}.0] #{}" 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] #{}") end
#pretty_dependency(dep, print_source = false)
[ GitHub ]# 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!
[ GitHub ]# File 'lib/bundler/shared_helpers.rb', line 154
def print_major_deprecations! multiple_gemfiles = search_up(".") do |dir| gemfiles = gemfile_names.select {|gf| File.file? File. (gf, dir) } next if gemfiles.empty? break false if gemfiles.size == 1 end if multiple_gemfiles && Bundler.bundler_major_version == 1 Bundler::SharedHelpers.major_deprecation 2, \ "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
#pwd
[ GitHub ]#resolve_path(path) (private)
[ GitHub ]# File 'lib/bundler/shared_helpers.rb', line 366
def resolve_path(path) = File. (path) return unless File.respond_to?(:realpath) && File.exist?( ) File.realpath( ) end
#root
# 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. .parent end
#search_up(*names) (private)
[ GitHub ]# File 'lib/bundler/shared_helpers.rb', line 270
def search_up(*names) previous = nil current = File. (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. ("..", current) end end
#set_bundle_environment
[ GitHub ]# 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 (private)
[ GitHub ]# 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. ("../../../exe/bundle", __FILE__) end Bundler::SharedHelpers.set_env "BUNDLE_BIN_PATH", exe_file rescue Gem::GemNotFoundException exe_file = File. ("../../../exe/bundle", __FILE__) # for Ruby core repository exe_file = File. ("../../../../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)
# 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 (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 341
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 ]#trap(signal, override = false, &block)
[ GitHub ]# 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 (private)
# 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 = "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, end
#with_clean_git_env(&block)
[ GitHub ]# 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)
[ GitHub ]# 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