Class: Gem::Uninstaller
- Inherits:
-
Object
- Object
- Gem::Uninstaller
- Includes:
- UserInteraction
- Defined in:
- lib/rubygems/uninstaller.rb
Overview
An Uninstaller.
The uninstaller fires pre and post uninstall hooks. Hooks can be added either through a rubygems_plugin.rb file in an installed gem or via a rubygems/defaults/#RUBY_ENGINE.rb or rubygems/defaults/operating_system.rb file. See Gem.pre_uninstall and Gem.post_uninstall for details.
Instance Attribute Summary collapse
-
#bin_dir ⇒ Object
readonly
The directory a gem’s executables will be installed into.
-
#gem_home ⇒ Object
readonly
The gem repository the gem will be installed into.
-
#spec ⇒ Object
readonly
The Gem::Specification for the gem being uninstalled, only set during #uninstall_gem.
Instance Method Summary collapse
- #ask_if_ok(spec) ⇒ Object
- #dependencies_ok?(spec) ⇒ Boolean
- #formatted_program_filename(filename) ⇒ Object
-
#initialize(gem, options = {}) ⇒ Uninstaller
constructor
Constructs an uninstaller that will uninstall
gem
. -
#path_ok?(gem_dir, spec) ⇒ Boolean
Is
spec
ingem_dir
?. -
#remove(spec) ⇒ Object
- spec
- the spec of the gem to be uninstalled list
-
the list of all such gems.
-
#remove_all(list) ⇒ Object
Removes all gems in
list
. -
#remove_executables(spec) ⇒ Object
Removes installed executables and batch files (windows only) for
gemspec
. -
#uninstall ⇒ Object
Performs the uninstall of the gem.
-
#uninstall_gem(spec) ⇒ Object
Uninstalls gem
spec
.
Methods included from UserInteraction
#alert, #alert_error, #alert_warning, #ask, #ask_for_password, #ask_yes_no, #choose_from_list, #say, #terminate_interaction
Methods included from DefaultUserInteraction
ui, #ui, ui=, #ui=, use_ui, #use_ui
Constructor Details
#initialize(gem, options = {}) ⇒ Uninstaller
Constructs an uninstaller that will uninstall gem
44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 |
# File 'lib/rubygems/uninstaller.rb', line 44 def initialize(gem, = {}) @gem = gem @version = [:version] || Gem::Requirement.default @gem_home = File.([:install_dir] || Gem.dir) @force_executables = [:executables] @force_all = [:all] @force_ignore = [:ignore] @bin_dir = [:bin_dir] @format_executable = [:format_executable] # only add user directory if install_dir is not set @user_install = false @user_install = [:user_install] unless [:install_dir] if @user_install then Gem.use_paths Gem.user_dir, @gem_home else Gem.use_paths @gem_home end end |
Instance Attribute Details
#bin_dir ⇒ Object (readonly)
The directory a gem’s executables will be installed into
28 29 30 |
# File 'lib/rubygems/uninstaller.rb', line 28 def bin_dir @bin_dir end |
#gem_home ⇒ Object (readonly)
The gem repository the gem will be installed into
33 34 35 |
# File 'lib/rubygems/uninstaller.rb', line 33 def gem_home @gem_home end |
#spec ⇒ Object (readonly)
The Gem::Specification for the gem being uninstalled, only set during #uninstall_gem
39 40 41 |
# File 'lib/rubygems/uninstaller.rb', line 39 def spec @spec end |
Instance Method Details
#ask_if_ok(spec) ⇒ Object
247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 |
# File 'lib/rubygems/uninstaller.rb', line 247 def ask_if_ok(spec) msg = [''] msg << 'You have requested to uninstall the gem:' msg << "\t#{spec.full_name}" spec.dependent_gems.each do |dep_spec, dep, satlist| msg << ("#{dep_spec.name}-#{dep_spec.version} depends on " + "[#{dep.name} (#{dep.requirement})]") end msg << 'If you remove this gems, one or more dependencies will not be met.' msg << 'Continue with Uninstall?' return ask_yes_no(msg.join("\n"), true) end |
#dependencies_ok?(spec) ⇒ Boolean
240 241 242 243 244 245 |
# File 'lib/rubygems/uninstaller.rb', line 240 def dependencies_ok?(spec) return true if @force_ignore deplist = Gem::DependencyList.from_specs deplist.ok_to_remove?(spec.full_name) end |
#formatted_program_filename(filename) ⇒ Object
263 264 265 266 267 268 269 270 |
# File 'lib/rubygems/uninstaller.rb', line 263 def formatted_program_filename(filename) if @format_executable then require 'rubygems/installer' Gem::Installer.exec_format % File.basename(filename) else filename end end |
#path_ok?(gem_dir, spec) ⇒ Boolean
Is spec
in gem_dir
?
233 234 235 236 237 238 |
# File 'lib/rubygems/uninstaller.rb', line 233 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 |
#remove(spec) ⇒ Object
- spec
-
the spec of the gem to be uninstalled
- list
-
the list of all such gems
Warning: this method modifies the list
parameter. Once it has uninstalled a gem, it is removed from that list.
189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 |
# File 'lib/rubygems/uninstaller.rb', line 189 def remove(spec) unless path_ok?(@gem_home, spec) or (@user_install and path_ok?(Gem.user_dir, spec)) then e = Gem::GemNotInHomeException.new \ "Gem 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) FileUtils.rm_rf spec.full_gem_path # TODO: should this be moved to spec?... I vote eww (also exists in docmgr) old_platform_name = [spec.name, spec.version, spec.original_platform].join '-' gemspec = spec.spec_file unless File.exist? gemspec then gemspec = File.join(File.dirname(gemspec), "#{old_platform_name}.gemspec") end FileUtils.rm_rf gemspec gem = spec.cache_file gem = File.join(spec.cache_dir, "#{old_platform_name}.gem") unless File.exist? gem FileUtils.rm_rf gem Gem::DocManager.new(spec).uninstall_doc say "Successfully uninstalled #{spec.full_name}" Gem::Specification.remove_spec spec end |
#remove_all(list) ⇒ Object
Removes all gems in list
.
NOTE: removes uninstalled gems from list
.
178 179 180 |
# File 'lib/rubygems/uninstaller.rb', line 178 def remove_all(list) list.each { |spec| uninstall_gem spec } end |
#remove_executables(spec) ⇒ Object
Removes installed executables and batch files (windows only) for gemspec
.
127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 |
# File 'lib/rubygems/uninstaller.rb', line 127 def remove_executables(spec) return if spec.nil? or spec.executables.empty? list = Gem::Specification.find_all { |s| s.name == spec.name && s.version != spec.version } executables = spec.executables.clone 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? then ask_yes_no("Remove executables:\n" \ "\t#{executables.join ', '}\n\n" \ "in addition to the gem?", true) else @force_executables end unless remove then say "Executables and scripts will remain installed." else 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 FileUtils.rm_f exe_file FileUtils.rm_f "#{exe_file}.bat" end end end |
#uninstall ⇒ Object
Performs the uninstall of the gem. This removes the spec, the Gem directory, and the cached .gem file.
69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 |
# File 'lib/rubygems/uninstaller.rb', line 69 def uninstall list = Gem::Specification.find_all_by_name(@gem, @version) if list.empty? then raise Gem::InstallError, "gem #{@gem.inspect} is not installed" elsif list.size > 1 and @force_all then remove_all list elsif list.size > 1 then gem_names = list.collect {|gem| gem.full_name} + ["All versions"] say _, index = choose_from_list "Select gem to uninstall:", gem_names if index == list.size then remove_all list elsif index >= 0 && index < list.size then uninstall_gem list[index] else say "Error: must enter a number [1-#{list.size+1}]" end else uninstall_gem list.first end end |
#uninstall_gem(spec) ⇒ Object
Uninstalls gem spec
99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 |
# File 'lib/rubygems/uninstaller.rb', line 99 def uninstall_gem(spec) @spec = spec unless dependencies_ok? spec unless 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 @spec Gem.post_uninstall_hooks.each do |hook| hook.call self end @spec = nil end |