module Bundler
Bundler 通过跟踪和安装精确所需的 gem 和版本,为 Ruby 项目提供一致的环境。
Bundler 是 Ruby 标准库的一部分。
Bundler 通过创建列出所有项目依赖项以及(可选)其版本和版本的 *gemfile* 来使用,然后使用
require 'bundler/setup'
或 Bundler.setup 来设置环境,在该环境中只能使用指定的 gem 及其指定的版本。
有关 gemfile 创建和 Bundler 用法的广泛文档,请参阅 Bundler 网站。
作为项目内的标准库,Bundler 可用于内省已加载和已要求的模块。
Constants
- ORIGINAL_ENV
- SUDO_MUTEX
Public Class Methods
Source
# File lib/bundler.rb, line 341 def app_cache(custom_path = nil) path = custom_path || root Pathname.new(path).join(Bundler.settings.app_cache_path) end
Source
# File lib/bundler.rb, line 327 def app_config_path if app_config = ENV["BUNDLE_APP_CONFIG"] app_config_pathname = Pathname.new(app_config) if app_config_pathname.absolute? app_config_pathname else app_config_pathname.expand_path(root) end else root.join(".bundle") end end
Source
# File lib/bundler.rb, line 181 def auto_install return unless Bundler.settings[:auto_install] begin definition.specs rescue GemNotFound, GitError ui.info "Automatically installing missing gems." reset! CLI::Install.new({}).run reset! end end
如果存在 settings,则自动安装依赖项。这是通过 `bundle config set --global auto_install 1` 命令设置的。
请注意,此方法会清空全局 Definition 对象,因此应先调用它,然后再实例化任何会保留对旧对象的引用的 `Installer`。
Source
# File lib/bundler.rb, line 171 def auto_switch self_manager.restart_with_locked_bundler_if_needed end
Source
# File lib/bundler.rb, line 119 def bin_path @bin_path ||= begin path = Bundler.settings[:bin] || "bin" path = Pathname.new(path).expand_path(root).expand_path mkdir_p(path) path end end
返回 binstubs 的安装位置的绝对路径。
Source
# File lib/bundler.rb, line 101 def bundle_path @bundle_path ||= Pathname.new(configured_bundle_path.path).expand_path(root) end
返回 gem 在文件系统上安装的绝对路径。
Source
# File lib/bundler.rb, line 366 def clean_env removed_message = "`Bundler.clean_env` has been removed in favor of `Bundler.unbundled_env`. " \ "If you instead want the environment before bundler was originally loaded, use `Bundler.original_env`" Bundler::SharedHelpers.feature_removed!(removed_message) end
Source
# File lib/bundler.rb, line 422 def clean_exec(*args) removed_message = "`Bundler.clean_exec` has been removed in favor of `Bundler.unbundled_exec`. " \ "If you instead want to exec to a command in the environment before bundler was originally loaded, use `Bundler.original_exec`" Bundler::SharedHelpers.feature_removed!(removed_message) end
Source
# File lib/bundler.rb, line 405 def clean_system(*args) removed_message = "`Bundler.clean_system` has been removed in favor of `Bundler.unbundled_system`. " \ "If you instead want to run the command in the environment before bundler was originally loaded, use `Bundler.original_system`" Bundler::SharedHelpers.feature_removed!(removed_message) end
Source
# File lib/bundler.rb, line 538 def clear_gemspec_cache @gemspec_cache = {} end
Source
# File lib/bundler.rb, line 87 def configure @configure ||= configure_gem_home_and_path end
Source
# File lib/bundler.rb, line 583 def configure_gem_home_and_path(path = bundle_path) configure_gem_path configure_gem_home(path) Bundler.rubygems.clear_paths end
Source
# File lib/bundler.rb, line 114 def configured_bundle_path @configured_bundle_path ||= Bundler.settings.path.tap(&:validate!) end
Source
# File lib/bundler.rb, line 105 def create_bundle_path mkdir_p(bundle_path) unless bundle_path.exist? @bundle_path = bundle_path.realpath rescue Errno::EEXIST raise PathError, "Could not install to path `#{bundle_path}` " \ "because a file already exists at that path. Either remove or rename the file so the directory can be created." end
Source
# File lib/bundler.rb, line 451 def default_bundle_dir SharedHelpers.default_bundle_dir end
Source
# File lib/bundler.rb, line 443 def default_gemfile SharedHelpers.default_gemfile end
Source
# File lib/bundler.rb, line 447 def default_lockfile SharedHelpers.default_lockfile end
Source
# File lib/bundler.rb, line 230 def definition(unlock = nil, lockfile = default_lockfile) @definition = nil if unlock @definition ||= begin configure Definition.build(default_gemfile, lockfile, unlock) end end
为给定的 Gemfile 和 lockfile 返回 Bundler::Definition 的实例
@param unlock [Hash, Boolean, nil] 已请求的 Gems
to be updated or true if all gems should be updated
@param lockfile [Pathname] Gemfile.lock 的路径 @return [Bundler::Definition]
Source
# File lib/bundler.rb, line 220 def environment SharedHelpers.feature_removed! "Bundler.environment has been removed in favor of Bundler.load" end
Source
# File lib/bundler.rb, line 547 def feature_flag @feature_flag ||= FeatureFlag.new(Bundler.settings[:simulate_version] || VERSION) end
Source
# File lib/bundler.rb, line 492 def find_executable(path) extensions = RbConfig::CONFIG["EXECUTABLE_EXTS"]&.split extensions = [RbConfig::CONFIG["EXEEXT"]] unless extensions&.any? candidates = extensions.map {|ext| "#{path}#{ext}" } candidates.find {|candidate| File.file?(candidate) && File.executable?(candidate) } end
Source
# File lib/bundler.rb, line 238 def frozen_bundle? frozen = Bundler.settings[:frozen] return frozen unless frozen.nil? Bundler.settings[:deployment] end
Source
# File lib/bundler.rb, line 439 def generic_local_platform Gem::Platform.generic(local_platform) end
Source
# File lib/bundler.rb, line 542 def git_present? return @git_present if defined?(@git_present) @git_present = Bundler.which("git") end
Source
# File lib/bundler.rb, line 519 def load_gemspec(file, validate = false) @gemspec_cache ||= {} key = File.expand_path(file) @gemspec_cache[key] ||= load_gemspec_uncached(file, validate) # Protect against caching side-effected gemspecs by returning a # new instance each time. @gemspec_cache[key]&.dup end
Source
# File lib/bundler.rb, line 528 def load_gemspec_uncached(file, validate = false) path = Pathname.new(file) contents = read_file(file) spec = eval_gemspec(path, contents) return unless spec spec.loaded_from = path.expand_path.to_s Bundler.rubygems.validate(spec) if validate spec end
Source
# File lib/bundler.rb, line 434 def local_platform return Gem::Platform::RUBY if Bundler.settings[:force_ruby_platform] Gem::Platform.local end
Source
# File lib/bundler.rb, line 245 def locked_gems @locked_gems ||= if defined?(@definition) && @definition definition.locked_gems elsif Bundler.default_lockfile.file? lock = Bundler.read_file(Bundler.default_lockfile) LockfileParser.new(lock) end end
Source
# File lib/bundler.rb, line 472 def mkdir_p(path) SharedHelpers.filesystem_access(path, :create) do |p| FileUtils.mkdir_p(p) end end
Source
# File lib/bundler.rb, line 362 def original_env ORIGINAL_ENV.clone end
@return [Hash] Bundler 激活之前的环境变量
Source
# File lib/bundler.rb, line 418 def original_exec(*args) with_original_env { Kernel.exec(*args) } end
使用 Bundler 激活之前的环境变量运行 `Kernel.exec` 到子命令
Source
# File lib/bundler.rb, line 401 def original_system(*args) with_original_env { Kernel.system(*args) } end
使用 Bundler 激活之前的环境变量运行子命令
Source
# File lib/bundler.rb, line 464 def preferred_gemfile_name Bundler.settings[:init_gems_rb] ? "gems.rb" : "Gemfile" end
Source
# File lib/bundler.rb, line 500 def read_file(file) SharedHelpers.filesystem_access(file, :read) do File.open(file, "r:UTF-8", &:read) end end
Source
# File lib/bundler.rb, line 212 def require(*groups) setup(*groups).require(*groups) end
如果尚未设置,则设置 Bundler 环境(请参阅 Bundler.setup),并加载指定组中的所有 gem。与 ::setup 不同,可以多次调用它(如果 setup 允许)。
假设 Gemfile
gem 'first_gem', '= 1.0' group :test do gem 'second_gem', '= 1.0' end
代码将如下工作
Bundler.setup # allow all groups Bundler.require(:default) # requires only first_gem # ...later Bundler.require(:test) # requires second_gem
Source
# File lib/bundler.rb, line 551 def reset! reset_paths! Plugin.reset! reset_rubygems! end
Source
# File lib/bundler.rb, line 562 def reset_paths! @bin_path = nil @bundle_path = nil @configure = nil @configured_bundle_path = nil @definition = nil @load = nil @locked_gems = nil @root = nil @settings = nil @setup = nil @user_home = nil end
Source
# File lib/bundler.rb, line 576 def reset_rubygems! return unless defined?(@rubygems) && @rubygems rubygems.undo_replacements rubygems.reset @rubygems = nil end
Source
# File lib/bundler.rb, line 557 def reset_settings_and_root! @settings = nil @root = nil end
Source
# File lib/bundler.rb, line 351 def rm_rf(path) FileUtils.remove_entry_secure(path) if path && File.exist?(path) end
Source
# File lib/bundler.rb, line 317 def root @root ||= begin SharedHelpers.root rescue GemfileNotFound bundle_dir = default_bundle_dir raise GemfileNotFound, "Could not locate Gemfile or .bundle/ directory" unless bundle_dir Pathname.new(File.expand_path("..", bundle_dir)) end end
Source
# File lib/bundler.rb, line 255 def ruby_scope "#{Bundler.rubygems.ruby_engine}/#{RbConfig::CONFIG["ruby_version"]}" end
Source
# File lib/bundler.rb, line 506 def safe_load_marshal(data) if Gem.respond_to?(:load_safe_marshal) Gem.load_safe_marshal begin Gem::SafeMarshal.safe_load(data) rescue Gem::SafeMarshal::Reader::Error, Gem::SafeMarshal::Visitors::ToRuby::Error => e raise MarshalError, "#{e.class}: #{e.message}" end else load_marshal(data, marshal_proc: SafeMarshal.proc) end end
Source
# File lib/bundler.rb, line 589 def self_manager @self_manager ||= begin require_relative "bundler/self_manager" Bundler::SelfManager.new end end
Source
# File lib/bundler.rb, line 355 def settings @settings ||= Settings.new(app_config_path) rescue GemfileNotFound @settings = Settings.new end
Source
# File lib/bundler.rb, line 155 def setup(*groups) # Return if all groups are already loaded return @setup if defined?(@setup) && @setup definition.validate_runtime! SharedHelpers.print_major_deprecations! if groups.empty? # Load all groups, but only once @setup = load.setup else load.setup(*groups) end end
启用 Bundler 运行时。在调用 Bundler.setup 后,所有 gem 的 `load` 或 `require` 仅在它们是 Gemfile 或 Ruby 标准库的一部分时才允许。如果 Gemfile 中指定了版本,则只加载这些版本。
假设 Gemfile
gem 'first_gem', '= 1.0' group :test do gem 'second_gem', '= 1.0' end
使用 Bundler.setup 的代码如下所示
require 'third_gem' # allowed, required from global gems require 'first_gem' # allowed, loads the last installed version Bundler.setup require 'fourth_gem' # fails with LoadError require 'second_gem' # loads exactly version 1.0
Bundler.setup 只能调用一次,所有后续调用都无效。
如果提供了 *groups* 列表,则只允许来自指定组的 gem(未分组的 gem 属于特殊的 `:default` 组)。
要加载 Gemfile 中的所有 gem(或仅部分组),请参阅 Bundler.require。
Source
# File lib/bundler.rb, line 313 def specs_path bundle_path.join("specifications") end
Source
# File lib/bundler.rb, line 455 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 set --local bindir foo`. Bundler.settings[:system_bindir] || Bundler.rubygems.gem_bindir end
Source
# File lib/bundler.rb, line 346 def tmp(name = Process.pid.to_s) Kernel.send(:require, "tmpdir") Pathname.new(Dir.mktmpdir(["bundler", name])) end
Source
# File lib/bundler.rb, line 91 def ui (defined?(@ui) && @ui) || (self.ui = UI::Shell.new) end
Source
# File lib/bundler.rb, line 95 def ui=(ui) Bundler.rubygems.ui = UI::RGProxy.new(ui) @ui = ui end
Source
# File lib/bundler.rb, line 379 def unbundle_env! ENV.replace(unbundle_env(ENV)) end
从 ENV 中删除所有与 bundler 相关的变量
Source
# File lib/bundler.rb, line 374 def unbundled_env unbundle_env(original_env) end
@return [Hash] 移除了所有与 bundler 相关的变量的环境
Source
# File lib/bundler.rb, line 430 def unbundled_exec(*args) with_env(unbundled_env) { Kernel.exec(*args) } end
在移除了所有与 bundler 相关的变量的环境中运行 `Kernel.exec` 到子命令
Source
# File lib/bundler.rb, line 413 def unbundled_system(*args) with_unbundled_env { Kernel.system(*args) } end
在移除了所有与 bundler 相关的变量的环境中运行子命令
Source
# File lib/bundler.rb, line 468 def use_system_gems? configured_bundle_path.use_system_gems? end
Source
# File lib/bundler.rb, line 283 def user_bundle_path(dir = "home") env_var, fallback = case dir when "home" ["BUNDLE_USER_HOME", proc { Pathname.new(user_home).join(".bundle") }] when "cache" ["BUNDLE_USER_CACHE", proc { user_bundle_path.join("cache") }] when "config" ["BUNDLE_USER_CONFIG", proc { user_bundle_path.join("config") }] when "plugin" ["BUNDLE_USER_PLUGIN", proc { user_bundle_path.join("plugin") }] else raise BundlerError, "Unknown user path requested: #{dir}" end # `fallback` will already be a Pathname, but Pathname.new() is # idempotent so it's OK Pathname.new(ENV.fetch(env_var, &fallback)) end
Source
# File lib/bundler.rb, line 259 def user_home @user_home ||= begin home = Bundler.rubygems.user_home bundle_home = home ? File.join(home, ".bundle") : nil warning = if home.nil? "Your home directory is not set." elsif !File.directory?(home) "`#{home}` is not a directory." elsif !File.writable?(home) && (!File.directory?(bundle_home) || !File.writable?(bundle_home)) "`#{home}` is not writable." end if warning Bundler.ui.warn "#{warning}\n" user_home = tmp_home_path Bundler.ui.warn "Bundler will use `#{user_home}' as your home directory temporarily.\n" user_home else Pathname.new(home) end end end
Source
# File lib/bundler.rb, line 478 def which(executable) executable_path = find_executable(executable) return executable_path if executable_path if (paths = ENV["PATH"]) quote = '"' paths.split(File::PATH_SEPARATOR).find do |path| path = path[1..-2] if path.start_with?(quote) && path.end_with?(quote) executable_path = find_executable(File.expand_path(executable, path)) return executable_path if executable_path end end end
Source
# File lib/bundler.rb, line 388 def with_clean_env removed_message = "`Bundler.with_clean_env` has been removed in favor of `Bundler.with_unbundled_env`. " \ "If you instead want the environment before bundler was originally loaded, use `Bundler.with_original_env`" Bundler::SharedHelpers.feature_removed!(removed_message) end
Source
# File lib/bundler.rb, line 384 def with_original_env with_env(original_env) { yield } end
使用 Bundler 激活之前的环境变量运行块
Source
# File lib/bundler.rb, line 396 def with_unbundled_env with_env(unbundled_env) { yield } end
使用移除了所有与 bundler 相关的变量的环境运行块
私有类方法
Source
# File lib/bundler.rb, line 659 def configure_gem_home(path) Bundler::SharedHelpers.set_env "GEM_HOME", path.to_s end
Source
# File lib/bundler.rb, line 650 def configure_gem_path unless use_system_gems? # this needs to be empty string to cause # PathSupport.split_gem_path to only load up the # Bundler --path setting as the GEM_PATH. Bundler::SharedHelpers.set_env "GEM_PATH", "" end end
Source
# File lib/bundler.rb, line 634 def eval_gemspec(path, contents) if contents.start_with?("---") # YAML header eval_yaml_gemspec(path, contents) else # Eval the gemspec from its parent directory, because some gemspecs # depend on "./" relative paths. SharedHelpers.chdir(path.dirname.to_s) do eval(contents, TOPLEVEL_BINDING.dup, path.expand_path.to_s) end end rescue ScriptError, StandardError => e msg = "There was an error while loading `#{path.basename}`: #{e.message}" raise GemspecError, Dsl::DSLError.new(msg, path.to_s, e.backtrace, contents) end
Source
# File lib/bundler.rb, line 628 def eval_yaml_gemspec(path, contents) Kernel.require "psych" Gem::Specification.from_yaml(contents) end
Source
# File lib/bundler.rb, line 622 def load_marshal(data, marshal_proc: nil) Marshal.load(data, marshal_proc) rescue TypeError => e raise MarshalError, "#{e.class}: #{e.message}" end
Source
# File lib/bundler.rb, line 663 def tmp_home_path Kernel.send(:require, "tmpdir") SharedHelpers.filesystem_access(Dir.tmpdir) do path = Bundler.tmp at_exit { Bundler.rm_rf(path) } path end end
Source
# File lib/bundler.rb, line 598 def unbundle_env(env) if env.key?("BUNDLER_ORIG_MANPATH") env["MANPATH"] = env["BUNDLER_ORIG_MANPATH"] end env.delete_if {|k, _| k[0, 7] == "BUNDLE_" } env.delete("BUNDLER_SETUP") if env.key?("RUBYOPT") rubyopt = env["RUBYOPT"].split(" ") rubyopt.delete("-r#{File.expand_path("bundler/setup", __dir__)}") rubyopt.delete("-rbundler/setup") env["RUBYOPT"] = rubyopt.join(" ") end if env.key?("RUBYLIB") rubylib = env["RUBYLIB"].split(File::PATH_SEPARATOR) rubylib.delete(__dir__) env["RUBYLIB"] = rubylib.join(File::PATH_SEPARATOR) end env end
Source
# File lib/bundler.rb, line 673 def with_env(env) backup = ENV.to_hash ENV.replace(env) yield ensure ENV.replace(backup) end
@param env [Hash]