123456789_123456789_123456789_123456789_123456789_

Class: Bundler::EndpointSpecification

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, ::Gem::Specification, ::Gem::Specification::RequirePathFlattener
Instance Chain:
self, MatchRemoteMetadata, FetchMetadata, ::Gem::Specification, ::Gem::Specification::AllowSettingSource, MatchPlatform, GemHelpers, MatchMetadata
Inherits: Gem::Specification
Defined in: lib/bundler/endpoint_specification.rb

Overview

used for Creating Specifications from the Gemcutter Endpoint

Constant Summary

GemHelpers - Included

GENERICS, GENERIC_CACHE

::Gem::Specification - Inherited

LATEST_RUBY_WITHOUT_PATCH_VERSIONS

Class Method Summary

Instance Attribute Summary

FetchMetadata - Included

#matches_current_ruby?

A fallback is included because the original version of the specification API didn’t include that field, so some marshalled specs in the index have it set to nil.
#matches_current_rubygems?

::Gem::Specification - Inherited

#deleted_gem?, #insecurely_materialized?, #relative_loaded_from, #remote, #required_ruby_version=

::Gem::Specification::AllowSettingSource - Included

#source, #source=

GemHelpers - Included

#generic_local_platform_is_ruby?

MatchMetadata - Included

#matches_current_metadata?, #matches_current_ruby?, #matches_current_rubygems?

Instance Method Summary

::Gem::Specification - Inherited

#extension_dir, #flatten_require_paths, #full_gem_path, #gem_dir, #git_version, #groups, #load_paths, #loaded_from, #nondevelopment_dependencies, #rg_extension_dir, #rg_full_gem_path, #rg_loaded_from, #rg_required_ruby_version=, #to_gemfile, #validate_for_resolution, #dependencies_to_gemfile

MatchPlatform - Included

#match_platform

GemHelpers - Included

#generic, #generic_local_platform, #local_platform, #platform_specificity_match, #same_deps, #same_specificity, #select_best_local_platform_match, #select_best_platform_match, #sort_best_platform_match

Constructor Details

.new(name, version, platform, spec_fetcher, dependencies, metadata = nil) ⇒ EndpointSpecification

[ GitHub ] 

  


# File 'lib/bundler/endpoint_specification.rb', line 11



def initialize(name, version, platform, spec_fetcher, dependencies, metadata = nil)
  super()
  @name         = name
  @version      = Gem::Version.create version
  @platform     = Gem::Platform.new(platform)
  @spec_fetcher = spec_fetcher
  @dependencies = dependencies.map {|dep, reqs| build_dependency(dep, reqs) }

  @loaded_from          = nil
  @remote_specification = nil
  @locked_platform = nil

  parse_metadata(metadata)
end


  







Instance Attribute Details



  

    #checksum   (readonly)
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 8



attr_reader :name, :version, :platform, :checksum


  








  

    #dependencies   (rw)
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 9



attr_accessor :remote, :dependencies, :locked_platform


  








  

    #insecurely_materialized?  ⇒ Boolean  (readonly)
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 26



def insecurely_materialized?
  @locked_platform.to_s != @platform.to_s
end


  








  

    #locked_platform   (rw)
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 9



attr_accessor :remote, :dependencies, :locked_platform


  








  

    #name   (readonly)
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 8



attr_reader :name, :version, :platform, :checksum


  








  

    #platform   (readonly)
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 8



attr_reader :name, :version, :platform, :checksum


  








  

    #remote   (rw)
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 9



attr_accessor :remote, :dependencies, :locked_platform


  








  

    #version   (readonly)
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 8



attr_reader :name, :version, :platform, :checksum


  







Instance Method Details



  

    #__swap__(spec)  
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 118



def __swap__(spec)
  SharedHelpers.ensure_same_dependencies(self, dependencies, spec.dependencies)
  @remote_specification = spec
end


  








  

    #_local_specification  
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 111



def _local_specification
  return unless @loaded_from && File.exist?(local_specification_path)
  eval(File.read(local_specification_path), nil, local_specification_path).tap do |spec|
    spec.loaded_from = @loaded_from
  end
end


  








  

    #_remote_specification   (private)
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 129



def _remote_specification
  @_remote_specification ||= @spec_fetcher.fetch_spec([@name, @version, @platform])
end


  








  

    #bindir  
  



  

    

needed for bundle clean


  



  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 68



def bindir
  if @remote_specification
    @remote_specification.bindir
  elsif _local_specification
    _local_specification.bindir
  else
    super
  end
end


  








  

    #build_dependency(name, requirements)   (private)
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 163



def build_dependency(name, requirements)
  Gem::Dependency.new(name, requirements)
end


  








  

    #executables  
  



  

    

needed for binstubs


  



  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 57



def executables
  if @remote_specification
    @remote_specification.executables
  elsif _local_specification
    _local_specification.executables
  else
    super
  end
end


  








  

    #extensions  
  



  

    

needed for “with native extensions” during install


  



  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 90



def extensions
  if @remote_specification
    @remote_specification.extensions
  elsif _local_specification
    _local_specification.extensions
  else
    super
  end
end


  








  

    #fetch_platform  
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 30



def fetch_platform
  @platform
end


  








  

    #inspect  
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 123



def inspect
  "#<#{self.class} @name=\"#{name}\" (#{full_name.delete_prefix("#{name}-")})>"
end


  








  

    #load_paths  
  



  

    

needed for inline


  



  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 47



def load_paths
  # remote specs aren't installed, and can't have load_paths
  if _local_specification
    _local_specification.load_paths
  else
    super
  end
end


  








  

    #local_specification_path   (private)
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 133



def local_specification_path
  "#{base_dir}/specifications/#{full_name}.gemspec"
end


  








  

    #metadata  
  



  

    

needed for bundle fund


  



  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 101



def metadata
  if @remote_specification
    @remote_specification.metadata
  elsif _local_specification
    _local_specification.metadata
  else
    super
  end
end


  








  

    #parse_metadata(data)   (private)
  

  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 137



def parse_metadata(data)
  unless data
    @required_ruby_version = nil
    @required_rubygems_version = nil
    return
  end

  data.each do |k, v|
    next unless v
    case k.to_s
    when "checksum"
      begin
        @checksum = Checksum.from_api(v.last, @spec_fetcher.uri)
      rescue ArgumentError => e
        raise ArgumentError, "Invalid checksum for #{full_name}: #{e.message}"
      end
    when "rubygems"
      @required_rubygems_version = Gem::Requirement.new(v)
    when "ruby"
      @required_ruby_version = Gem::Requirement.new(v)
    end
  end
rescue StandardError => e
  raise GemspecError, "There was an error parsing the metadata for the gem #{name} (#{version}): #{e.class}\n#{e}\nThe metadata was #{data.inspect}"
end


  








  

    #post_install_message  
  



  

    

needed for post_install_messages during install


  



  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 79



def post_install_message
  if @remote_specification
    @remote_specification.post_install_message
  elsif _local_specification
    _local_specification.post_install_message
  else
    super
  end
end


  








  

    #require_paths  
  



  

    

needed for standalone, load required_paths from local gemspec after the gem is installed


  



  [ GitHub ]


  

  


# File 'lib/bundler/endpoint_specification.rb', line 36



def require_paths
  if @remote_specification
    @remote_specification.require_paths
  elsif _local_specification
    _local_specification.require_paths
  else
    super
  end
end