Class: Bundler::Installer
Relationships & Source Files | |
Inherits: | Object |
Defined in: | lib/bundler/installer.rb |
Class Attribute Summary
Class Method Summary
-
.install(root, definition, options = {})
Begins the installation process for
::Bundler
. - .new(root, definition) ⇒ Installer constructor
Instance Attribute Summary
- #post_install_messages readonly
- #can_install_in_parallel? ⇒ Boolean readonly private
Instance Method Summary
- #generate_bundler_executable_stubs(spec, options = {})
- #generate_standalone_bundler_executable_stubs(spec)
-
#run(options)
Runs the install procedures for a specific Gemfile.
- #create_bundle_path private
- #ensure_specs_are_compatible! private
-
#install(options)
private
the order that the resolver provides is significant, since dependencies might affect the installation of a gem.
- #install_in_parallel(size, standalone, force = false) private
- #installation_parallelization(options) private
- #load_plugins private
- #lock(opts = {}) private
- #processor_count private
-
#resolve_if_needed(options)
private
returns whether or not a re-resolve was needed.
- #warn_on_incompatible_bundler_deps private
Constructor Details
.new(root, definition) ⇒ Installer
# File 'lib/bundler/installer.rb', line 30
def initialize(root, definition) @root = root @definition = definition @post_install_messages = {} end
Class Attribute Details
.ambiguous_gems (rw)
[ GitHub ]# File 'lib/bundler/installer.rb', line 13
attr_accessor :ambiguous_gems
Class Method Details
.install(root, definition, options = {})
# File 'lib/bundler/installer.rb', line 22
def self.install(root, definition, = {}) installer = new(root, definition) Plugin.hook(Plugin::Events::GEM_BEFORE_INSTALL_ALL, definition.dependencies) installer.run( ) Plugin.hook(Plugin::Events::GEM_AFTER_INSTALL_ALL, definition.dependencies) installer end
Instance Attribute Details
#can_install_in_parallel? ⇒ Boolean
(readonly, private)
[ GitHub ]
# File 'lib/bundler/installer.rb', line 277
def can_install_in_parallel? true end
#post_install_messages (readonly)
[ GitHub ]# File 'lib/bundler/installer.rb', line 18
attr_reader :
Instance Method Details
#create_bundle_path (private)
[ GitHub ]# File 'lib/bundler/installer.rb', line 288
def create_bundle_path SharedHelpers.filesystem_access(Bundler.bundle_path.to_s) do |p| Bundler.mkdir_p(p) end unless Bundler.bundle_path.exist? rescue Errno::EEXIST raise PathError, "Could not install to path `#{Bundler.bundle_path}` " \ "because a file already exists at that path. Either remove or rename the file so the directory can be created." end
#ensure_specs_are_compatible! (private)
[ GitHub ]# File 'lib/bundler/installer.rb', line 243
def ensure_specs_are_compatible! system_ruby = Bundler::RubyVersion.system rubygems_version = Gem::Version.create(Gem::VERSION) @definition.specs.each do |spec| if required_ruby_version = spec.required_ruby_version unless required_ruby_version.satisfied_by?(system_ruby.gem_version) raise InstallError, "#{spec.full_name} requires ruby version #{required_ruby_version}, " \ "which is incompatible with the current version, #{system_ruby}" end end next unless required_rubygems_version = spec.required_rubygems_version unless required_rubygems_version.satisfied_by?(rubygems_version) raise InstallError, "#{spec.full_name} requires rubygems version #{required_rubygems_version}, " \ "which is incompatible with the current version, #{rubygems_version}" end end end
#generate_bundler_executable_stubs(spec, options = {})
[ GitHub ]# File 'lib/bundler/installer.rb', line 99
def generate_bundler_executable_stubs(spec, = {}) if [:binstubs_cmd] && spec.executables.empty? = {} spec.runtime_dependencies.each do |dep| bins = @definition.specs[dep].first.executables [dep.name] = bins unless bins.empty? end if .any? Bundler.ui.warn "#{spec.name} has no executables, but you may want " \ "one from a gem it depends on." .each {|name, bins| Bundler.ui.warn " #{name} has: #{bins.join(", ")}" } else Bundler.ui.warn "There are no executables for the gem #{spec.name}." end return end # double-assignment to avoid warnings about variables that will be used by ERB bin_path = Bundler.bin_path bin_path = bin_path relative_gemfile_path = Bundler.default_gemfile.relative_path_from(bin_path) relative_gemfile_path = relative_gemfile_path ruby_command = Thor::Util.ruby_command ruby_command = ruby_command template_path = File. ("../templates/Executable", __FILE__) if spec.name == "bundler" template_path += ".bundler" spec.executables = %(bundle) end template = File.read(template_path) exists = [] spec.executables.each do |executable| binstub_path = "#{bin_path}/#{executable}" if File.exist?(binstub_path) && ! [:force] exists << executable next end File.open(binstub_path, "w", 0o777 & ~File.umask) do |f| if RUBY_VERSION >= "2.6" f.puts ERB.new(template, :trim_mode => "-").result(binding) else f.puts ERB.new(template, nil, "-").result(binding) end end end if [:binstubs_cmd] && exists.any? case exists.size when 1 Bundler.ui.warn "Skipped #{exists[0]} since it already exists." when 2 Bundler.ui.warn "Skipped #{exists.join(" and ")} since they already exist." else items = exists[0...-1].empty? ? nil : exists[0...-1].join(", ") skipped = [items, exists[-1]].compact.join(" and ") Bundler.ui.warn "Skipped #{skipped} since they already exist." end Bundler.ui.warn "If you want to overwrite skipped stubs, use --force." end end
#generate_standalone_bundler_executable_stubs(spec)
[ GitHub ]# File 'lib/bundler/installer.rb', line 162
def generate_standalone_bundler_executable_stubs(spec) # double-assignment to avoid warnings about variables that will be used by ERB bin_path = Bundler.bin_path unless path = Bundler.settings[:path] raise "Can't standalone without an explicit path set" end standalone_path = Bundler.root.join(path).relative_path_from(bin_path) standalone_path = standalone_path template = File.read(File. ("../templates/Executable.standalone", __FILE__)) ruby_command = Thor::Util.ruby_command ruby_command = ruby_command spec.executables.each do |executable| next if executable == "bundle" executable_path = Pathname(spec.full_gem_path).join(spec.bindir, executable).relative_path_from(bin_path) executable_path = executable_path File.open "#{bin_path}/#{executable}", "w", 0o755 do |f| if RUBY_VERSION >= "2.6" f.puts ERB.new(template, :trim_mode => "-").result(binding) else f.puts ERB.new(template, nil, "-").result(binding) end end end end
#install(options) (private)
the order that the resolver provides is significant, since dependencies might affect the installation of a gem. that said, it’s a rare situation (other than rake), and parallel installation is SO MUCH FASTER. so we let people opt in.
# File 'lib/bundler/installer.rb', line 194
def install( ) force = ["force"] jobs = installation_parallelization( ) install_in_parallel jobs, [:standalone], force end
#install_in_parallel(size, standalone, force = false) (private)
[ GitHub ]# File 'lib/bundler/installer.rb', line 281
def install_in_parallel(size, standalone, force = false) spec_installations = ParallelInstaller.call(self, @definition.specs, size, standalone, force) spec_installations.each do |installation| [installation.name] = installation. if installation. end end
#installation_parallelization(options) (private)
[ GitHub ]# File 'lib/bundler/installer.rb', line 200
def installation_parallelization( ) if jobs = .delete(:jobs) return jobs end return 1 unless can_install_in_parallel? auto_config_jobs = Bundler.feature_flag.auto_config_jobs? if jobs = Bundler.settings[:jobs] if auto_config_jobs jobs else [jobs.pred, 1].max end elsif auto_config_jobs processor_count else 1 end end
#load_plugins (private)
[ GitHub ]# File 'lib/bundler/installer.rb', line 228
def load_plugins Bundler.rubygems.load_plugins requested_path_gems = @definition.requested_specs.select {|s| s.source.is_a?(Source::Path) } path_plugin_files = requested_path_gems.map do |spec| begin Bundler.rubygems.spec_matches_for_glob(spec, "rubygems_plugin#{Bundler.rubygems.suffix_pattern}") rescue TypeError = "#{spec.name} #{spec.version} has an invalid gemspec" raise Gem::InvalidSpecificationException, end end.flatten Bundler.rubygems.load_plugin_files(path_plugin_files) end
#lock(opts = {}) (private)
[ GitHub ]# File 'lib/bundler/installer.rb', line 307
def lock(opts = {}) @definition.lock(Bundler.default_lockfile, opts[:preserve_unknown_sections]) end
#processor_count (private)
[ GitHub ]# File 'lib/bundler/installer.rb', line 221
def processor_count require "etc" Etc.nprocessors rescue StandardError 1 end
#resolve_if_needed(options) (private)
returns whether or not a re-resolve was needed
# File 'lib/bundler/installer.rb', line 298
def resolve_if_needed( ) if !@definition.unlocking? && ! ["force"] && ! ["all-platforms"] && !Bundler.settings[:inline] && Bundler.default_lockfile.file? return false if @definition.nothing_changed? && !@definition.missing_specs? end ["local"] ? @definition.resolve_with_cache! : @definition.resolve_remotely! true end
#run(options)
Runs the install procedures for a specific Gemfile.
Firstly, this method will check to see if Bundler.bundle_path exists and if not then ::Bundler
will create the directory. This is usually the same location as RubyGems which typically is the ~/.gem
directory unless other specified.
Secondly, it checks if ::Bundler
has been configured to be “frozen”. Frozen ensures that the Gemfile and the Gemfile.lock
file are matching. This stops a situation where a developer may update the Gemfile but may not run bundle install
, which leads to the Gemfile.lock
file not being correctly updated. If this file is not correctly updated then any other developer running bundle install
will potentially not install the correct gems.
Thirdly, ::Bundler
checks if there are any dependencies specified in the Gemfile. If there are no dependencies specified then ::Bundler
returns a warning message stating so and this method returns.
Fourthly, ::Bundler
checks if the Gemfile.lock
exists, and if so then proceeds to set up a definition based on the Gemfile and the Gemfile.lock
. During this step ::Bundler
will also download information about any new gems that are not in the Gemfile.lock
and resolve any dependencies if needed.
Fifthly, ::Bundler
resolves the dependencies either through a cache of gems or by remote. This then leads into the gems being installed, along with stubs for their executables, but only if the –binstubs option has been passed or ::Bundler
.options has been set earlier.
Sixthly, a new Gemfile.lock
is created from the installed gems to ensure that the next time that a user runs bundle install
they will receive any updates from this process.
Finally, if the user has specified the standalone flag, ::Bundler
will generate the needed require paths and save them in a setup.rb
file. See bundle standalone --help
for more information.
# File 'lib/bundler/installer.rb', line 70
def run( ) create_bundle_path ProcessLock.lock do if Bundler.frozen_bundle? @definition.ensure_equivalent_gemfile_and_lockfile( [:deployment]) end if @definition.dependencies.empty? Bundler.ui.warn "The Gemfile specifies no dependencies" lock return end if resolve_if_needed( ) ensure_specs_are_compatible! warn_on_incompatible_bundler_deps load_plugins .delete(:jobs) else [:jobs] = 1 # to avoid the overhead of Bundler::Worker end install( ) lock unless Bundler.frozen_bundle? Standalone.new( [:standalone], @definition).generate if [:standalone] end end
#warn_on_incompatible_bundler_deps (private)
[ GitHub ]# File 'lib/bundler/installer.rb', line 261
def warn_on_incompatible_bundler_deps bundler_version = Gem::Version.create(Bundler::VERSION) @definition.specs.each do |spec| spec.dependencies.each do |dep| next if dep.type == :development next unless dep.name == "bundler".freeze next if dep.requirement.satisfied_by?(bundler_version) Bundler.ui.warn "#{spec.name} (#{spec.version}) has dependency" \ " #{SharedHelpers.pretty_dependency(dep)}" \ ", which is unsatisfied by the current bundler version #{VERSION}" \ ", so the dependency is being ignored" end end end