class Gem::Uninstaller
一个 Uninstaller。
卸载器会触发卸载前和卸载后的钩子。钩子可以通过已安装 gem 中的 rubygems_plugin.rb 文件,或者通过 rubygems/defaults/#{RUBY_ENGINE}.rb 或 rubygems/defaults/operating_system.rb 文件来添加。详情请参见 Gem.pre_uninstall 和 Gem.post_uninstall。
属性
gem 可执行文件将被安装到的目录
将要从中卸载 gem 的 gem 仓库
正在被卸载的 gem 的 Gem::Specification,仅在 uninstall_gem 期间设置
Public Class Methods
Source
# File lib/rubygems/uninstaller.rb, line 63 def initialize(gem, options = {}) @gem = gem @version = options[:version] || Gem::Requirement.default @install_dir = options[:install_dir] @gem_home = File.realpath(@install_dir || Gem.dir) @user_dir = File.exist?(Gem.user_dir) ? File.realpath(Gem.user_dir) : Gem.user_dir @force_executables = options[:executables] @force_all = options[:all] @force_ignore = options[:ignore] @bin_dir = options[:bin_dir] @format_executable = options[:format_executable] @abort_on_dependent = options[:abort_on_dependent] @check_dev = options[:check_dev] if options[:force] @force_all = true @force_ignore = true end # only add user directory if install_dir is not set @user_install = false @user_install = options[:user_install] unless @install_dir # Optimization: populated during #uninstall @default_specs_matching_uninstall_params = [] end
构造一个将要卸载名为 gem 的 gem 的卸载器。options 是一个包含以下键的 Hash:
- :version
-
要卸载的 gem 的版本要求。如果未指定,则使用
Gem::Requirement.default。 - :install_dir
-
gem 被安装的目录。如果未指定,则使用
Gem.dir。 - :executables
-
是否应该在不经确认的情况下移除可执行文件。如果为 nil,则会明确询问用户。
- :all
-
如果多个版本符合要求,是否强制移除所有匹配的版本,或者询问用户选择要移除的具体匹配版本。
- :ignore
-
在卸载时忽略损坏的依赖检查。
- :bin_dir
-
包含要移除的可执行文件的目录。如果未指定,则使用
Gem.bindir。 - :format_executable
-
为了查找要移除的可执行文件,使用
Gem::Installer.exec_format来格式化可执行文件名称。 - :abort_on_dependent
-
如果依赖关系会被破坏,则直接中止卸载,而不是征求用户确认。
- :check_dev
-
在检查卸载 gem 是否会留下损坏的依赖关系时,同时考虑开发依赖。
- :force
-
将 :all 和 :ignore 都设置为 true 以强制卸载。
- :user_install
-
从用户 gem 目录卸载,而不是从系统目录卸载。
Public Instance Methods
Source
# File lib/rubygems/uninstaller.rb, line 320 def path_ok?(gem_dir, spec) full_path = File.join gem_dir, "gems", spec.full_name original_path = File.join gem_dir, "gems", spec.original_name full_path == spec.full_gem_path || original_path == spec.full_gem_path end
spec 是否在 gem_dir 中?
Source
# File lib/rubygems/uninstaller.rb, line 310 def regenerate_plugins latest = specification_record.latest_spec_for(@spec.name) return if latest.nil? regenerate_plugins_for(latest, plugin_dir_for(@spec)) end
移除后重新生成插件包装器。
Source
# File lib/rubygems/uninstaller.rb, line 251 def remove(spec) unless path_ok?(@gem_home, spec) || (@user_install && path_ok?(@user_dir, spec)) e = Gem::GemNotInHomeException.new \ "Gem '#{spec.full_name}' is not installed in directory #{@gem_home}" e.spec = spec raise e end raise Gem::FilePermissionError, spec.base_dir unless File.writable?(spec.base_dir) full_gem_path = spec.full_gem_path exclusions = [] if default_spec_matches?(spec) && spec.executables.any? exclusions = spec.executables.map {|exe| File.join(spec.bin_dir, exe) } exclusions << File.dirname(exclusions.last) until exclusions.last == full_gem_path end safe_delete { rm_r full_gem_path, exclusions: exclusions } safe_delete { FileUtils.rm_r spec.extension_dir } old_platform_name = spec.original_name gem = spec.cache_file gem = File.join(spec.cache_dir, "#{old_platform_name}.gem") unless File.exist? gem safe_delete { FileUtils.rm_r gem } begin Gem::RDoc.new(spec).remove rescue NameError end gemspec = spec.spec_file unless File.exist? gemspec gemspec = File.join(File.dirname(gemspec), "#{old_platform_name}.gemspec") end safe_delete { FileUtils.rm_r gemspec } announce_deletion_of(spec) end
- spec
-
要卸载的 gem 的 spec
Source
# File lib/rubygems/uninstaller.rb, line 244 def remove_all(list) list.each {|spec| uninstall_gem spec } end
移除 list 中的所有 gem。
注意:从 list 中移除已卸载的 gem。
Source
# File lib/rubygems/uninstaller.rb, line 190 def remove_executables(spec) return if spec.executables.empty? || default_spec_matches?(spec) executables = spec.executables.clone # Leave any executables created by other installed versions # of this gem installed. list = Gem::Specification.find_all do |s| s.name == spec.name && s.version != spec.version end list.each do |s| s.executables.each do |exe_name| executables.delete exe_name end end return if executables.empty? executables = executables.map {|exec| formatted_program_filename exec } remove = if @force_executables.nil? ask_yes_no("Remove executables:\n" \ "\t#{executables.join ", "}\n\n" \ "in addition to the gem?", true) else @force_executables end if remove bin_dir = @bin_dir || Gem.bindir(spec.base_dir) raise Gem::FilePermissionError, bin_dir unless File.writable? bin_dir executables.each do |exe_name| say "Removing #{exe_name}" exe_file = File.join bin_dir, exe_name safe_delete { FileUtils.rm exe_file } safe_delete { FileUtils.rm "#{exe_file}.bat" } end else say "Executables and scripts will remain installed." end end
移除 spec 的已安装可执行文件和批处理文件(仅限 Windows)。
Source
# File lib/rubygems/uninstaller.rb, line 386 def safe_delete(&block) block.call rescue Errno::ENOENT nil rescue Errno::EPERM e = Gem::UninstallError.new e.spec = @spec raise e end
Source
# File lib/rubygems/uninstaller.rb, line 94 def uninstall dependency = Gem::Dependency.new @gem, @version list = [] specification_record.stubs.each do |spec| next unless dependency.matches_spec? spec list << spec end if list.empty? raise Gem::InstallError, "gem #{@gem.inspect} is not installed" end default_specs, list = list.partition(&:default_gem?) warn_cannot_uninstall_default_gems(default_specs - list) @default_specs_matching_uninstall_params = default_specs.map(&:to_spec) list, other_repo_specs = list.partition do |spec| @gem_home == spec.base_dir || (@user_install && spec.base_dir == @user_dir) end list.sort! if list.empty? return unless other_repo_specs.any? other_repos = other_repo_specs.map(&:base_dir).uniq message = ["#{@gem} is not installed in GEM_HOME, try:"] message.concat other_repos.map {|repo| "\tgem uninstall -i #{repo} #{@gem}" } raise Gem::InstallError, message.join("\n") elsif @force_all remove_all list elsif list.size > 1 gem_names = list.map(&:full_name_with_location) gem_names << "All versions" say _, index = choose_from_list "Select gem to uninstall:", gem_names if index == list.size remove_all list elsif index && index >= 0 && index < list.size uninstall_gem list[index] else say "Error: must enter a number [1-#{list.size + 1}]" end else uninstall_gem list.first end end
执行 gem 的卸载。这将移除 spec、Gem 目录和缓存的 .gem 文件。
Source
# File lib/rubygems/uninstaller.rb, line 156 def uninstall_gem(stub) spec = stub.to_spec @spec = spec unless dependencies_ok? spec if abort_on_dependent? || !ask_if_ok(spec) raise Gem::DependencyRemovalException, "Uninstallation aborted due to dependent gem(s)" end end Gem.pre_uninstall_hooks.each do |hook| hook.call self end remove_executables @spec remove_plugins @spec remove @spec specification_record.remove_spec(stub) regenerate_plugins Gem.post_uninstall_hooks.each do |hook| hook.call self end @spec = nil end
卸载 gem spec
私有实例方法
Source
# File lib/rubygems/uninstaller.rb, line 409 def announce_deletion_of(spec) name = spec.full_name say "Successfully uninstalled #{name}" if default_spec_matches?(spec) say( "There was both a regular copy and a default copy of #{name}. The " \ "regular copy was successfully uninstalled, but the default copy " \ "was left around because default gems can't be removed." ) end end
Source
# File lib/rubygems/uninstaller.rb, line 422 def default_spec_matches?(spec) !default_specs_that_match(spec).empty? end
@return 如果任何默认 gem 的 spec 与给定的 `spec` “==`,则返回 true。
Source
# File lib/rubygems/uninstaller.rb, line 427 def default_specs_that_match(spec) @default_specs_matching_uninstall_params.select {|default_spec| spec == default_spec } end
@return [Array] 与给定的 `spec` “==` 的默认 gem 的 spec。
Source
# File lib/rubygems/uninstaller.rb, line 437 def plugin_dir_for(spec) Gem.plugindir(spec.base_dir) end
Source
# File lib/rubygems/uninstaller.rb, line 399 def rm_r(path, exclusions:) FileUtils::Entry_.new(path).postorder_traverse do |ent| ent.remove unless exclusions.include?(ent.path) end end
Source
# File lib/rubygems/uninstaller.rb, line 405 def specification_record @specification_record ||= @install_dir ? Gem::SpecificationRecord.from_path(@install_dir) : Gem::Specification.specification_record end
Source
# File lib/rubygems/uninstaller.rb, line 431 def warn_cannot_uninstall_default_gems(specs) specs.each do |spec| say "Gem #{spec.full_name} cannot be uninstalled because it is a default gem" end end