# class Gem::Commands::UninstallCommand

`Gem` uninstaller command line tool

See ‘gem help uninstall`

### Public Class Methods

new ()
Source

    # File lib/rubygems/commands/uninstall_command.rb, line 16
    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

Calls superclass method `Gem::Command::new`

### Public Instance Methods

execute ()
Source

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

      # Consider only gem specifications installed at `--install-dir`
      Gem::Specification.dirs = options[:install_dir] if options[:install_dir]

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

uninstall (gem_name)
Source

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

uninstall_all ()
Source

    # File lib/rubygems/commands/uninstall_command.rb, line 140
    def uninstall_all
      specs = Gem::Specification.reject(&: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)
Source

    # File lib/rubygems/commands/uninstall_command.rb, line 187
    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.base_dir}")
    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 ()
Source

    # File lib/rubygems/commands/uninstall_command.rb, line 151
    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])

        if gem_specs.empty?
          say("Gem '#{name}' is not installed")
        else
          gem_specs.reject!(&:default_gem?) if gem_specs.size > 1

          gem_specs.each do |spec|
            deplist.add spec
          end
        end
      end

      deps = deplist.strongly_connected_components.flatten.reverse

      gems_to_uninstall = {}

      deps.each do |dep|
        if original_gem_version[dep.name] == Gem::Requirement.default
          next if gems_to_uninstall[dep.name]
          gems_to_uninstall[dep.name] = true
        else
          options[:version] = dep.version
        end

        uninstall_gem(dep.name)
      end
    end