123456789_123456789_123456789_123456789_123456789_

Class: Gem::NameTuple

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Instance Chain:
self, Comparable
Inherits: Object
Defined in: lib/rubygems/name_tuple.rb

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new(name, version, platform = "ruby") ⇒ NameTuple

[ GitHub ] 

  


# File 'lib/rubygems/name_tuple.rb', line 10



def initialize(name, version, platform="ruby")
  @name = name
  @version = version

  unless platform.kind_of? Gem::Platform
    platform = "ruby" if !platform or platform.empty?
  end

  @platform = platform
end


  







Class Method Details



  

    .from_list(list)  
  



  

    

Turn an array of [name, version, platform] into an array of NameTuple objects.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 27



def self.from_list(list)
  list.map { |t| new(*t) }
end


  








  

    .null  
  



  

    

A null NameTuple, ie name=nil, version=0


  



  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 42



def self.null
  new nil, Gem::Version.new(0), nil
end


  








  

    .to_basic(list)  
  



  

    

Turn an array of NameTuple objects back into an array of


name, version, platform



tuples.




  



  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 35



def self.to_basic(list)
  list.map { |t| t.to_a }
end


  







Instance Attribute Details



  

    #match_platform?  ⇒ Boolean  (readonly)
  



  

    

Indicate if this NameTuple matches the current platform.


  





  


  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 63



def match_platform?
  Gem::Platform.match @platform
end


  








  

    #name   (readonly)
  

  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 21



attr_reader :name, :version, :platform


  








  

    #platform   (readonly)
  

  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 21



attr_reader :name, :version, :platform


  








  

    #prerelease?  ⇒ Boolean  (readonly)
  



  

    

Indicate if this NameTuple is for a prerelease version.


  





  


  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 69



def prerelease?
  @version.prerelease?
end


  








  

    #version   (readonly)
  

  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 21



attr_reader :name, :version, :platform


  







Instance Method Details



  

    #<=>(other)  
  

  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 93



def <=>(other)
  [@name, @version, @platform == Gem::Platform::RUBY ? -1 : 1] <=>
    [other.name, other.version,
     other.platform == Gem::Platform::RUBY ? -1 : 1]
end


  








  

    #==(other)  
    Also known as: #eql?
  



  

    

Compare with other. Supports another NameTuple or an Array in the [name, version, platform] format.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 105



def ==(other)
  case other
  when self.class
    @name == other.name and
      @version == other.version and
      @platform == other.platform
  when Array
    to_a == other
  else
    false
  end
end


  








  

    #eql?(other)  
  



  

    

Alias for #==.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 118



alias_method :eql?, :==


  








  

    #full_name  
  



  

    

Returns the full name (name-version) of this ::Gem.  Platform information is included if it is not the default Ruby platform.  This mimics the behavior of Specification#full_name.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 51



def full_name
  case @platform
  when nil, 'ruby', ''
    "#{@name}-#{@version}"
  else
    "#{@name}-#{@version}-#{@platform}"
  end.dup.untaint
end


  








  

    #hash  
  

  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 120



def hash
  to_a.hash
end


  








  

    #inspect  
    Also known as: #to_s
  

  

    This method is for internal use only.
  

  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 87



def inspect # :nodoc:
  "#<Gem::NameTuple #{@name}, #{@version}, #{@platform}>"
end


  








  

    #spec_name  
  



  

    

Return the name that the gemspec file would be


  



  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 76



def spec_name
  "#{full_name}.gemspec"
end


  








  

    #to_a  
  



  

    

Convert back to the [name, version, platform] tuple


  



  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 83



def to_a
  [@name, @version, @platform]
end


  








  

    #to_s  
  

  

    This method is for internal use only.
  



  

    

Alias for #inspect.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/name_tuple.rb', line 91



alias to_s inspect # :nodoc: