Class: Gem::Commands::UninstallCommand
Relationships & Source Files | |
Super Chains via Extension / Inclusion / Inheritance | |
Class Chain:
self,
::Gem::Command
|
|
Instance Chain:
|
|
Inherits: |
Gem::Command
|
Defined in: | lib/rubygems/commands/uninstall_command.rb |
Overview
::Gem uninstaller command line tool
See gem help uninstall
Class Attribute Summary
::Gem::Command - Inherited
.build_args | Arguments used when building gems. |
.build_args=, .extra_args, .extra_args= |
Class Method Summary
- .new ⇒ UninstallCommand constructor
::Gem::Command - Inherited
.add_common_option, | |
.add_specific_extra_args | Add a list of extra arguments for the given command. |
.common_options, | |
.new | Initializes a generic gem command named |
.specific_extra_args | Return an array of extra arguments for the command. |
.specific_extra_args_hash | Accessor for the specific extra args hash (self initializing). |
Instance Attribute Summary
::Gem::Command - Inherited
#defaults | The default options for the command. |
#program_name | The name of the command for command-line invocation. |
#summary | A short description of the command. |
#command | The name of the command. |
#options | The options for the command. |
::Gem::DefaultUserInteraction - Included
Instance Method Summary
::Gem::VersionOption - Included
#add_platform_option | Add the –platform option to the option parser. |
#add_prerelease_option | Add the –prerelease option to the option parser. |
#add_version_option | Add the –version option to the option parser. |
::Gem::Command - Inherited
#add_extra_args | Adds extra args from ~/.gemrc. |
#add_option | Add a command-line option and handler to the command. |
#arguments | Override to provide details of the arguments a command takes. |
#begins? | True if |
#defaults_str | Override to display the default values of the command options. |
#description | Override to display a longer description of what this command does. |
#execute | Override to provide command handling. |
#get_all_gem_names | Get all gem names from the command line. |
#get_all_gem_names_and_versions | Get all [gem, version] from the command line. |
#get_one_gem_name | Get a single gem name from the command line. |
#get_one_optional_argument | Get a single optional argument from the command line. |
#handle_options | Handle the given list of arguments by parsing them and recording the results. |
#handles? | True if the command handles the given argument list. |
#invoke | Invoke the command with the given list of arguments. |
#invoke_with_build_args | Invoke the command with the given list of normal arguments and additional build arguments. |
#merge_options | Merge a set of command options with the set of default options (without modifying the default option hash). |
#remove_option | Remove previously defined command-line argument |
#show_help | Display the help message for the command. |
#show_lookup_failure | Display to the user that a gem couldn't be found and reasons why. |
#usage | Override to display the usage for an individual gem command. |
#when_invoked | Call the given block when invoked. |
#add_parser_run_info | Adds a section with |
#configure_options, | |
#create_option_parser | Creates an option parser and fills it in with the help info for the command. |
#parser | Create on demand parser. |
#wrap | Wraps |
::Gem::UserInteraction - Included
#alert | Displays an alert |
#alert_error | Displays an error |
#alert_warning | Displays a warning |
#ask | Asks a |
#ask_for_password | Asks for a password with a |
#ask_yes_no | Asks a yes or no |
#choose_from_list | Asks the user to answer |
#say | Displays the given |
#terminate_interaction | Terminates the RubyGems process with the given |
#verbose | Calls |
::Gem::DefaultUserInteraction - Included
Constructor Details
.new ⇒ UninstallCommand
# 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, | [:all] = value end add_option('-I', '--[no-]ignore-dependencies', 'Ignore dependency requirements while', 'uninstalling') do |value, | [:ignore] = value end add_option('-D', '--[no-]-check-development', 'Check development dependencies while uninstalling', '(default: false)') do |value, | [:check_dev] = value end add_option('-x', '--[no-]executables', 'Uninstall applicable executables without', 'confirmation') do |value, | [:executables] = value end add_option('-i', '--install-dir DIR', 'Directory to uninstall gem from') do |value, | [:install_dir] = File. (value) end add_option('-n', '--bindir DIR', 'Directory to remove binaries from') do |value, | [:bin_dir] = File. (value) end add_option('--[no-]user-install', 'Uninstall from user\'s home directory', 'in addition to GEM_HOME.') do |value, | [:user_install] = value end add_option('--[no-]format-executable', 'Assume executable names match Ruby\'s prefix and suffix.') do |value, | [:format_executable] = value end add_option('--[no-]force', 'Uninstall all versions of the named gems', 'ignoring dependencies') do |value, | [:force] = value end add_option('--[no-]abort-on-dependent', 'Prevent uninstalling gems that are', 'depended on by other gems.') do |value, | [: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, | unless Gem.vendor_dir then raise OptionParser::InvalidOption.new 'your platform is not supported' end alert_warning 'Use your OS package manager to uninstall vendor gems' [:vendor] = true [:install_dir] = Gem.vendor_dir end end
Instance Method Details
#execute
[ GitHub ]# File 'lib/rubygems/commands/uninstall_command.rb', line 116
def execute if [:all] and not [:args].empty? then uninstall_specific elsif [:all] then uninstall_all else uninstall_specific end end
#uninstall_all
[ GitHub ]# File 'lib/rubygems/commands/uninstall_command.rb', line 126
def uninstall_all specs = Gem::Specification.reject { |spec| spec.default_gem? } specs.each do |spec| [:version] = spec.version begin Gem::Uninstaller.new(spec.name, ).uninstall rescue Gem::InstallError end end alert "Uninstalled all gems in #{ [:install_dir]}" end
#uninstall_specific
[ GitHub ]# File 'lib/rubygems/commands/uninstall_command.rb', line 141
def uninstall_specific deplist = Gem::DependencyList.new get_all_gem_names.uniq.each do |name| Gem::Specification.find_all_by_name(name).each do |spec| deplist.add spec end end deps = deplist.strongly_connected_components.flatten.reverse deps.map(&:name).uniq.each do |gem_name| begin Gem::Uninstaller.new(gem_name, ).uninstall 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}") end end end