module Bundler
def self.preserve_gem_path
def self.preserve_gem_path original_gem_path = ENV["_ORIGINAL_GEM_PATH"] gem_path = ENV["GEM_PATH"] ENV["_ORIGINAL_GEM_PATH"] = gem_path if original_gem_path.nil? || original_gem_path == "" ENV["GEM_PATH"] = original_gem_path if gem_path.nil? || gem_path == "" end
def self.with_friendly_errors
def self.with_friendly_errors begin yield rescue Bundler::BundlerError => e Bundler.ui.error e.message Bundler.ui.debug e.backtrace.join("\n") exit e.status_code rescue Interrupt => e Bundler.ui.error "\nQuitting..." Bundler.ui.debug e.backtrace.join("\n") exit 1 rescue SystemExit => e exit e.status rescue Exception => e Bundler.ui.error( "Unfortunately, a fatal error has occurred. Please see the Bundler \n" \ "troubleshooting documentation at http://bit.ly/bundler-issues. Thanks! \n") raise e end end
def app_cache
def app_cache root.join("vendor/cache") end
def app_config_path
def app_config_path ENV['BUNDLE_APP_CONFIG'] ? Pathname.new(ENV['BUNDLE_APP_CONFIG']).expand_path(root) : root.join('.bundle') end
def bin_path
def bin_path @bin_path ||= begin path = settings[:bin] || "bin" path = Pathname.new(path).expand_path(root) FileUtils.mkdir_p(path) Pathname.new(path).expand_path end end
def bundle_path
def bundle_path @bundle_path ||= Pathname.new(settings.path).expand_path(root) end
def cache
def cache bundle_path.join("cache/bundler") end
def clean_exec(*args)
def clean_exec(*args) with_clean_env { Kernel.exec(*args) } end
def clean_system(*args)
def clean_system(*args) with_clean_env { Kernel.system(*args) } end
def clear_gemspec_cache
def clear_gemspec_cache @gemspec_cache = {} end
def configure
def configure @configured ||= configure_gem_home_and_path end
def configure_gem_home
def configure_gem_home # TODO: This mkdir_p is only needed for JRuby <= 1.5 and should go away (GH #602) FileUtils.mkdir_p bundle_path.to_s rescue nil ENV['GEM_HOME'] = File.expand_path(bundle_path, root) Bundler.rubygems.clear_paths end
def configure_gem_home_and_path
def configure_gem_home_and_path blank_home = ENV['GEM_HOME'].nil? || ENV['GEM_HOME'].empty? if settings[:disable_shared_gems] ENV['GEM_PATH'] = '' configure_gem_home elsif blank_home || Bundler.rubygems.gem_dir != bundle_path.to_s possibles = [Bundler.rubygems.gem_dir, Bundler.rubygems.gem_path] paths = possibles.flatten.compact.uniq.reject { |p| p.empty? } ENV["GEM_PATH"] = paths.join(File::PATH_SEPARATOR) configure_gem_home end Bundler.rubygems.refresh bundle_path end
def default_gemfile
def default_gemfile SharedHelpers.default_gemfile end
def default_lockfile
def default_lockfile SharedHelpers.default_lockfile end
def definition(unlock = nil)
def definition(unlock = nil) @definition = nil if unlock @definition ||= begin configure upgrade_lockfile Definition.build(default_gemfile, default_lockfile, unlock) end end
def environment
def environment Bundler::Environment.new(root, definition) end
def home
def home bundle_path.join("bundler") end
def install_path
def install_path home.join("gems") end
def load
def load @load ||= Runtime.new(root, definition) end
def load_gemspec(file)
def load_gemspec(file) @gemspec_cache ||= {} key = File.expand_path(file) spec = ( @gemspec_cache[key] ||= load_gemspec_uncached(file) ) # Protect against caching side-effected gemspecs by returning a # new instance each time. spec.dup if spec end
def load_gemspec_uncached(file)
def load_gemspec_uncached(file) path = Pathname.new(file) # Eval the gemspec from its parent directory Dir.chdir(path.dirname.to_s) do contents = File.read(path.basename.to_s) begin Gem::Specification.from_yaml(contents) # Raises ArgumentError if the file is not valid YAML rescue ArgumentError, SyntaxError, Gem::EndOfYAMLException, Gem::Exception begin eval(contents, TOPLEVEL_BINDING, path.expand_path.to_s) rescue LoadError, SyntaxError => e original_line = e.backtrace.find { |line| line.include?(path.to_s) } msg = "There was a #{e.class} while evaluating #{path.basename}: \n#{e.message}" msg << " from\n #{original_line}" if original_line msg << "\n" if e.is_a?(LoadError) && RUBY_VERSION >= "1.9" msg << "\nDoes it try to require a relative path? That's been removed in Ruby 1.9." end raise GemspecError, msg end end end end
def mkdir_p(path)
def mkdir_p(path) if requires_sudo? sudo "mkdir -p '#{path}'" unless File.exist?(path) else FileUtils.mkdir_p(path) end end
def read_file(file)
def read_file(file) File.open(file, "rb") { |f| f.read } end
def require(*groups)
def require(*groups) setup(*groups).require(*groups) end
def requires_sudo?
def requires_sudo? return @requires_sudo if defined?(@checked_for_sudo) path = bundle_path path = path.parent until path.exist? sudo_present = which "sudo" bin_dir = Pathname.new(Bundler.system_bindir) bin_dir = bin_dir.parent until bin_dir.exist? @checked_for_sudo = true sudo_gems = !File.writable?(path) || !File.writable?(bin_dir) @requires_sudo = settings.allow_sudo? && sudo_gems && sudo_present end
def root
def root default_gemfile.dirname.expand_path end
def ruby_scope
def ruby_scope "#{Bundler.rubygems.ruby_engine}/#{Gem::ConfigMap[:ruby_version]}" end
def settings
def settings @settings ||= Settings.new(app_config_path) end
def setup(*groups)
def setup(*groups) # Just return if all groups are already loaded return @setup if defined?(@setup) definition.validate_ruby! if groups.empty? # Load all groups, but only once @setup = load.setup else @completed_groups ||= [] # Figure out which groups haven't been loaded yet unloaded = groups - @completed_groups # Record groups that are now loaded @completed_groups = groups unloaded.any? ? load.setup(*groups) : load end end
def specs_path
def specs_path bundle_path.join("specifications") end
def sudo(str)
def sudo(str) `sudo -p 'Enter your password to install the bundled RubyGems to your system: ' #{str}` end
def system_bindir
def system_bindir # Gem.bindir doesn't always return the location that Rubygems will install # system binaries. If you put '-n foo' in your .gemrc, Rubygems will # install binstubs there instead. Unfortunately, Rubygems doesn't expose # that directory at all, so rather than parse .gemrc ourselves, we allow # the directory to be set as well, via `bundle config bindir foo`. Bundler.settings[:system_bindir] || Bundler.rubygems.gem_bindir end
def tmp
def tmp user_bundle_path.join("tmp", Process.pid.to_s) end
def ui
def ui @ui ||= UI.new end
def upgrade_lockfile
def upgrade_lockfile lockfile = default_lockfile if lockfile.exist? && lockfile.read(3) == "---" Bundler.ui.warn "Detected Gemfile.lock generated by 0.9, deleting..." lockfile.rmtree end end
def user_bundle_path
def user_bundle_path Pathname.new(Bundler.rubygems.user_home).join(".bundler") end
def which(executable)
def which(executable) if File.executable?(executable) executable elsif ENV['PATH'] path = ENV['PATH'].split(File::PATH_SEPARATOR).find do |p| File.executable?(File.join(p, executable)) end path && File.expand_path(executable, path) end end
def with_clean_env
def with_clean_env with_original_env do ENV.delete_if { |k,_| k[0,7] == 'BUNDLE_' } if ENV.has_key? 'RUBYOPT' ENV['RUBYOPT'] = ENV['RUBYOPT'].sub '-rbundler/setup', '' ENV['RUBYOPT'] = ENV['RUBYOPT'].sub "-I#{File.expand_path('..', __FILE__)}", '' end yield end end
def with_original_env
def with_original_env bundled_env = ENV.to_hash ENV.replace(ORIGINAL_ENV) yield ensure ENV.replace(bundled_env.to_hash) end