class Gem::Commands::UninstallCommand - RDoc Documentation

# class Gem::Commands::UninstallCommand

`Gem` uninstaller command line tool

See ‘gem help uninstall`

### Public Class Methods

new() click to toggle source
Calls superclass method `Gem::Command::new`

    # File lib/rubygems/commands/uninstall_command.rb, line 15
    def initialize
      super "uninstall", "Uninstall gems from the local repository",
            :version => Gem::Requirement.default, :user_install => true,
            :check_dev => false, :vendor => false

      add_option("-a", "--[no-]all",
        "Uninstall all matching versions"
      ) do |value, options|
        options[:all] = value
      end

      add_option("-I", "--[no-]ignore-dependencies",
                 "Ignore dependency requirements while",
                 "uninstalling") do |value, options|
        options[:ignore] = value
      end

      add_option("-D", "--[no-]check-development",
                 "Check development dependencies while uninstalling",
                 "(default: false)") do |value, options|
        options[:check_dev] = value
      end

      add_option("-x", "--[no-]executables",
                   "Uninstall applicable executables without",
                   "confirmation") do |value, options|
        options[:executables] = value
      end

      add_option("-i", "--install-dir DIR",
                 "Directory to uninstall gem from") do |value, options|
        options[:install_dir] = File.expand_path(value)
      end

      add_option("-n", "--bindir DIR",
                 "Directory to remove executables from") do |value, options|
        options[:bin_dir] = File.expand_path(value)
      end

      add_option("--[no-]user-install",
                 "Uninstall from user's home directory",
                 "in addition to GEM_HOME.") do |value, options|
        options[:user_install] = value
      end

      add_option("--[no-]format-executable",
                 "Assume executable names match Ruby's prefix and suffix.") do |value, options|
        options[:format_executable] = value
      end

      add_option("--[no-]force",
                 "Uninstall all versions of the named gems",
                 "ignoring dependencies") do |value, options|
        options[:force] = value
      end

      add_option("--[no-]abort-on-dependent",
                 "Prevent uninstalling gems that are",
                 "depended on by other gems.") do |value, options|
        options[:abort_on_dependent] = value
      end

      add_version_option
      add_platform_option

      add_option("--vendor",
                 "Uninstall gem from the vendor directory.",
                 "Only for use by gem repackagers.") do |value, options|
        unless Gem.vendor_dir
          raise Gem::OptionParser::InvalidOption.new "your platform is not supported"
        end

        alert_warning "Use your OS package manager to uninstall vendor gems"
        options[:vendor] = true
        options[:install_dir] = Gem.vendor_dir
      end
    end

### Public Instance Methods

execute() click to toggle source

    # File lib/rubygems/commands/uninstall_command.rb, line 125
    def execute
      check_version

      if options[:all] && !options[:args].empty?
        uninstall_specific
      elsif options[:all]
        uninstall_all
      else
        uninstall_specific
      end
    end

uninstall(gem_name) click to toggle source

    # File lib/rubygems/commands/uninstall_command.rb, line 194
    def uninstall(gem_name)
      Gem::Uninstaller.new(gem_name, options).uninstall
    end

uninstall_all() click to toggle source

    # File lib/rubygems/commands/uninstall_command.rb, line 137
    def uninstall_all
      specs = Gem::Specification.reject {|spec| spec.default_gem? }

      specs.each do |spec|
        options[:version] = spec.version
        uninstall_gem spec.name
      end

      alert "Uninstalled all gems in #{options[:install_dir] || Gem.dir}"
    end

uninstall_gem(gem_name) click to toggle source

    # File lib/rubygems/commands/uninstall_command.rb, line 180
    def uninstall_gem(gem_name)
      uninstall(gem_name)
    rescue Gem::GemNotInHomeException => e
      spec = e.spec
      alert("In order to remove #{spec.name}, please execute:\n" +
            "\tgem uninstall #{spec.name} --install-dir=#{spec.installation_path}")
    rescue Gem::UninstallError => e
      spec = e.spec
      alert_error("Error: unable to successfully uninstall '#{spec.name}' which is " +
            "located at '#{spec.full_gem_path}'. This is most likely because" +
            "the current user does not have the appropriate permissions")
      terminate_interaction 1
    end

uninstall_specific() click to toggle source

    # File lib/rubygems/commands/uninstall_command.rb, line 148
    def uninstall_specific
      deplist = Gem::DependencyList.new
      original_gem_version = {}

      get_all_gem_names_and_versions.each do |name, version|
        original_gem_version[name] = version || options[:version]

        gem_specs = Gem::Specification.find_all_by_name(name, original_gem_version[name])

        say("Gem '#{name}' is not installed") if gem_specs.empty?
        gem_specs.each do |spec|
          deplist.add spec
        end
      end

      deps = deplist.strongly_connected_components.flatten.reverse

      gems_to_uninstall = {}

      deps.each do |dep|
        unless gems_to_uninstall[dep.name]
          gems_to_uninstall[dep.name] = true

          unless original_gem_version[dep.name] == Gem::Requirement.default
            options[:version] = dep.version
          end

          uninstall_gem(dep.name)
        end
      end
    end