Gem::Commands::UpdateCommand

Public Class Methods

new() click to toggle source

 
               # File rubygems/commands/update_command.rb, line 15
def initialize
  super 'update',
        'Update the named gems (or all installed gems) in the local repository',
    :generate_rdoc => true,
    :generate_ri   => true,
    :force         => false,
    :test          => false

  add_install_update_options

  add_option('--system',
             'Update the RubyGems system software') do |value, options|
    options[:system] = value
  end

  add_local_remote_options
  add_platform_option
  add_prerelease_option "as update targets"
end

Public Instance Methods

do_rubygems_update(version) click to toggle source

Update the RubyGems software to version.

 
               # File rubygems/commands/update_command.rb, line 137
def do_rubygems_update(version)
  args = []
  args.push '--prefix', Gem.prefix unless Gem.prefix.nil?
  args << '--no-rdoc' unless options[:generate_rdoc]
  args << '--no-ri' unless options[:generate_ri]
  args << '--no-format-executable' if options[:no_format_executable]

  update_dir = File.join Gem.dir, 'gems', "rubygems-update-#{version}"

  Dir.chdir update_dir do
    say "Installing RubyGems #{version}"
    setup_cmd = "#{Gem.ruby} setup.rb #{args.join ' '}"

    # Make sure old rubygems isn't loaded
    old = ENV["RUBYOPT"]
    ENV.delete("RUBYOPT")
    system setup_cmd
    ENV["RUBYOPT"] = old if old
  end
end

execute() click to toggle source

 
               # File rubygems/commands/update_command.rb, line 47
def execute
  hig = {}

  if options[:system] then
    say "Updating RubyGems"

    unless options[:args].empty? then
      raise "No gem names are allowed with the --system option"
    end

    rubygems_update = Gem::Specification.new
    rubygems_update.name = 'rubygems-update'
    rubygems_update.version = Gem::Version.new Gem::VERSION
    hig['rubygems-update'] = rubygems_update

    options[:user_install] = false
  else
    say "Updating installed gems"

    hig = {} # highest installed gems

    Gem.source_index.each do |name, spec|
      if hig[spec.name].nil? or hig[spec.name].version < spec.version then
        hig[spec.name] = spec
      end
    end
  end

  gems_to_update = which_to_update hig, options[:args]

  updated = []

  installer = Gem::DependencyInstaller.new options

  gems_to_update.uniq.sort.each do |name|
    next if updated.any? { |spec| spec.name == name }
    success = false

    say "Updating #{name}"
    begin
      installer.install name
      success = true
    rescue Gem::InstallError => e
      alert_error "Error installing #{name}:\n\t#{e.message}"
      success = false
    end

    installer.installed_gems.each do |spec|
      updated << spec
      say "Successfully installed #{spec.full_name}" if success
    end
  end

  if gems_to_update.include? "rubygems-update" then
    Gem.source_index.refresh!

    update_gems = Gem.source_index.find_name 'rubygems-update'

    latest_update_gem = update_gems.sort_by { |s| s.version }.last

    say "Updating RubyGems to #{latest_update_gem.version}"
    installed = do_rubygems_update latest_update_gem.version

    say "RubyGems system software updated" if installed
  else
    if updated.empty? then
      say "Nothing to update"
    else
      say "Gems updated: #{updated.map { |spec| spec.name }.join ', '}"

      if options[:generate_ri] then
        updated.each do |gem|
          Gem::DocManager.new(gem, options[:rdoc_args]).generate_ri
        end

        Gem::DocManager.update_ri_cache
      end

      if options[:generate_rdoc] then
        updated.each do |gem|
          Gem::DocManager.new(gem, options[:rdoc_args]).generate_rdoc
        end
      end
    end
  end
end

which_to_update(highest_installed_gems, gem_names) click to toggle source

 
               # File rubygems/commands/update_command.rb, line 158
def which_to_update(highest_installed_gems, gem_names)
  result = []

  highest_installed_gems.each do |l_name, l_spec|
    next if not gem_names.empty? and
            gem_names.all? { |name| /#{name}/ !~ l_spec.name }

    dependency = Gem::Dependency.new l_spec.name, "> #{l_spec.version}"

    begin
      fetcher = Gem::SpecFetcher.fetcher
      spec_tuples = fetcher.find_matching dependency
    rescue Gem::RemoteFetcher::FetchError => e
      raise unless fetcher.warn_legacy e do
        require 'rubygems/source_info_cache'

        dependency.name = '' if dependency.name == //

        specs = Gem::SourceInfoCache.search_with_source dependency

        spec_tuples = specs.map do |spec, source_uri|
          [[spec.name, spec.version, spec.original_platform], source_uri]
        end
      end
    end

    matching_gems = spec_tuples.select do |(name, version, platform),|
      name == l_name and Gem::Platform.match platform
    end

    highest_remote_gem = matching_gems.sort_by do |(name, version),|
      version
    end.last

    if highest_remote_gem and
       l_spec.version < highest_remote_gem.first[1] then
      result << l_name
    end
  end

  result
end

Commenting is here to help enhance the documentation. For example, code samples, or clarification of the documentation.

If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.

If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.

If you want to help improve the Ruby documentation, please see Improve the docs, or visit Documenting-ruby.org.