# 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 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 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 126
    def execute
      check_version

      if options[:all] and not 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 195
    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 138
    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 181
    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 149
    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