Class
Constants
No documentation available
Attributes
Class Methods
::
lib/rubygems/source.rb
View on GitHub
# File tmp/rubies/ruby-2.4.10/lib/rubygems/source.rb, line 29
def initialize(uri)
begin
unless uri.kind_of? URI
uri = URI.parse(uri.to_s)
end
rescue URI::InvalidURIError
raise if Gem::Source == self.class
end
@uri = uri
@api_uri = nil
end
Creates a new Source
which will use the index located at uri
.
Instance Methods
lib/rubygems/source.rb
View on GitHub
# File tmp/rubies/ruby-2.4.10/lib/rubygems/source.rb, line 53
def <=>(other)
case other
when Gem::Source::Installed,
Gem::Source::Local,
Gem::Source::Lock,
Gem::Source::SpecificFile,
Gem::Source::Git,
Gem::Source::Vendor then
-1
when Gem::Source then
if !@uri
return 0 unless other.uri
return 1
end
return -1 if !other.uri
@uri.to_s <=> other.uri.to_s
else
nil
end
end
Sources are ordered by installation preference.
lib/rubygems/source.rb
View on GitHub
# File tmp/rubies/ruby-2.4.10/lib/rubygems/source.rb, line 111
def cache_dir(uri)
# Correct for windows paths
escaped_path = uri.path.sub(/^\/([a-z]):\//i, '/\\1-/')
escaped_path.untaint
File.join Gem.spec_cache_dir, "#{uri.host}%#{uri.port}", File.dirname(escaped_path)
end
Returns the local directory to write uri
to.
lib/rubygems/source.rb
View on GitHub
# File tmp/rubies/ruby-2.4.10/lib/rubygems/source.rb, line 209
def download(spec, dir=Dir.pwd)
fetcher = Gem::RemoteFetcher.fetcher
fetcher.download spec, api_uri.to_s, dir
end
Downloads spec
and writes it to dir
. See also Gem::RemoteFetcher#download
.
lib/rubygems/source.rb
View on GitHub
# File tmp/rubies/ruby-2.4.10/lib/rubygems/source.rb, line 134
def fetch_spec name_tuple
fetcher = Gem::RemoteFetcher.fetcher
spec_file_name = name_tuple.spec_name
uri = api_uri + "#{Gem::MARSHAL_SPEC_DIR}#{spec_file_name}"
cache_dir = cache_dir uri
local_spec = File.join cache_dir, spec_file_name
if File.exist? local_spec then
spec = Gem.read_binary local_spec
spec = Marshal.load(spec) rescue nil
return spec if spec
end
uri.path << '.rz'
spec = fetcher.fetch_path uri
spec = Gem.inflate spec
if update_cache? then
FileUtils.mkdir_p cache_dir
open local_spec, 'wb' do |io|
io.write spec
end
end
# TODO: Investigate setting Gem::Specification#loaded_from to a URI
Marshal.load spec
end
Fetches a specification for the given name_tuple
.
lib/rubygems/source.rb
View on GitHub
# File tmp/rubies/ruby-2.4.10/lib/rubygems/source.rb, line 179
def load_specs(type)
file = FILES[type]
fetcher = Gem::RemoteFetcher.fetcher
file_name = "#{file}.#{Gem.marshal_version}"
spec_path = api_uri + "#{file_name}.gz"
cache_dir = cache_dir spec_path
local_file = File.join(cache_dir, file_name)
retried = false
FileUtils.mkdir_p cache_dir if update_cache?
spec_dump = fetcher.cache_update_path spec_path, local_file, update_cache?
begin
Gem::NameTuple.from_list Marshal.load(spec_dump)
rescue ArgumentError
if update_cache? && !retried
FileUtils.rm local_file
retried = true
retry
else
raise Gem::Exception.new("Invalid spec cache file in #{local_file}")
end
end
end
Loads type
kind of specs fetching from +@uri+ if the on-disk cache is out of date.
type
is one of the following:
:released => Return the list of all released specs :latest => Return the list of only the highest version of each gem :prerelease => Return the list of all prerelease only specs
lib/rubygems/source.rb
View on GitHub
# File tmp/rubies/ruby-2.4.10/lib/rubygems/source.rb, line 122
def update_cache?
@update_cache ||=
begin
File.stat(Gem.user_home).uid == Process.uid
rescue Errno::ENOENT
false
end
end
Returns true when it is possible and safe to update the cache directory.