ruby/lib/rubygems/source_info_cache_entry.rb

require 'rubygems'
require 'rubygems/source_index'
require 'rubygems/remote_fetcher'

##
# Entries held by a SourceInfoCache.

class Gem::SourceInfoCacheEntry

  ##
  # The source index for this cache entry.

  attr_reader :source_index

  ##
  # The size of the of the source entry.  Used to determine if the
  # source index has changed.

  attr_reader :size

  ##
  # Create a cache entry.

  def initialize(si, size)
    @source_index = si || Gem::SourceIndex.new({})
    @size = size
    @all = false
  end

  def refresh(source_uri, all)
    begin
      marshal_uri = URI.join source_uri.to_s, "Marshal.#{Gem.marshal_version}"
      remote_size = Gem::RemoteFetcher.fetcher.fetch_size marshal_uri
    rescue Gem::RemoteSourceException
      yaml_uri = URI.join source_uri.to_s, 'yaml'
      remote_size = Gem::RemoteFetcher.fetcher.fetch_size yaml_uri
    end

    # TODO Use index_signature instead of size?
    return false if @size == remote_size and @all

    updated = @source_index.update source_uri, all
    @size = remote_size
    @all = all

    updated
  end

  def ==(other) # :nodoc:
    self.class === other and
    @size == other.size and
    @source_index == other.source_index
  end

end