Class: Gem::Commands::PristineCommand
| Relationships & Source Files | |
| Super Chains via Extension / Inclusion / Inheritance | |
|
Class Chain:
self,
::Gem::Command
|
|
|
Instance Chain:
|
|
| Inherits: |
Gem::Command
|
| Defined in: | lib/rubygems/commands/pristine_command.rb |
Class Attribute Summary
::Gem::Command - Inherited
| .build_args | Arguments used when building gems. |
| .build_args=, .extra_args, .extra_args= | |
Class Method Summary
- .new ⇒ PristineCommand 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 ⇒ PristineCommand
# File 'lib/rubygems/commands/pristine_command.rb', line 10
def initialize super 'pristine', 'Restores installed gems to pristine condition from files located in the gem cache', :version => Gem::Requirement.default, :extensions => true, :extensions_set => false, :all => false add_option('--all', 'Restore all installed gems to pristine', 'condition') do |value, | [:all] = value end add_option('--[no-]extensions', 'Restore gems with extensions', 'in addition to regular gems') do |value, | [:extensions_set] = true [:extensions] = value end add_option('--only-executables', 'Only restore executables') do |value, | [:only_executables] = value end add_option('-E', '--[no-]env-shebang', 'Rewrite executables with a shebang', 'of /usr/bin/env') do |value, | [:env_shebang] = value end add_version_option('restore to', 'pristine condition') end
Instance Method Details
#execute
# File 'lib/rubygems/commands/pristine_command.rb', line 77
def execute specs = if [:all] then Gem::Specification.map # `--extensions` must be explicitly given to pristine only gems # with extensions. elsif [:extensions_set] and [:extensions] and [:args].empty? then Gem::Specification.select do |spec| spec.extensions and not spec.extensions.empty? end else get_all_gem_names.map do |gem_name| Gem::Specification.find_all_by_name gem_name, [:version] end.flatten end if specs.to_a.empty? then raise Gem::Exception, "Failed to find gems #{[:args]} #{[:version]}" end install_dir = Gem.dir # TODO use installer option raise Gem::FilePermissionError.new(install_dir) unless File.writable?(install_dir) say "Restoring gems to pristine condition..." specs.each do |spec| if spec.default_gem? say "Skipped #{spec.full_name}, it is a default gem" next end if spec.bundled_gem_in_old_ruby? say "Skipped #{spec.full_name}, it is bundled with old Ruby" next end unless spec.extensions.empty? or [:extensions] then say "Skipped #{spec.full_name}, it needs to compile an extension" next end gem = spec.cache_file unless File.exist? gem then require 'rubygems/remote_fetcher' say "Cached gem for #{spec.full_name} not found, attempting to fetch..." dep = Gem::Dependency.new spec.name, spec.version found, _ = Gem::SpecFetcher.fetcher.spec_for_dependency dep if found.empty? say "Skipped #{spec.full_name}, it was not found from cache and remote sources" next end spec_candidate, source = found.first Gem::RemoteFetcher.fetcher.download spec_candidate, source.uri.to_s, spec.base_dir end env_shebang = if .include? :env_shebang then [:env_shebang] else install_defaults = Gem::ConfigFile::PLATFORM_DEFAULTS['install'] install_defaults.to_s['--env-shebang'] end installer = Gem::Installer.new(gem, :wrappers => true, :force => true, :install_dir => spec.base_dir, :env_shebang => env_shebang, :build_args => spec.build_args) if [:only_executables] then installer.generate_bin else installer.install end say "Restored #{spec.full_name}" end end