123456789_123456789_123456789_123456789_123456789_

Class: Gem::BasicSpecification

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Subclasses:
Specification, StubSpecification
Inherits: Object
Defined in: lib/rubygems/basic_specification.rb

Overview

BasicSpecification is an abstract class which implements some common code used by both Specification and StubSpecification.

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new ⇒ BasicSpecification

[ GitHub ] 

  


# File 'lib/rubygems/basic_specification.rb', line 33



def initialize
  internal_init
end


  







Class Method Details



  

    .default_specifications_dir  
  

  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 37



def self.default_specifications_dir
  File.join(Gem.default_dir, "specifications", "default")
end


  







Instance Attribute Details



  

    #activated?  ⇒ Boolean  (readonly)
  



  

    

True when the gem has been activated


  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 52



def activated?
  raise NotImplementedError
end


  








  

    #base_dir   (rw)
  



  

    

Returns the full path to the base gem directory.



eg: /usr/local/lib/ruby/gems/1.8


  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 61



def base_dir
  raise NotImplementedError
end


  








  

    #default_gem?  ⇒ Boolean  (readonly)
  

  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 82



def default_gem?
  loaded_from &&
    File.dirname(loaded_from) == self.class.default_specifications_dir
end


  








  

    #extension_dir   (rw)
  



  

    

Returns full path to the directory where gem's extensions are installed.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 90



def extension_dir
  @extension_dir ||= File.expand_path(File.join(extensions_dir, full_name)).untaint
end


  








  

    #full_gem_path   (rw)
  



  

    

The full path to the gem (install path + full name).


  



  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 115



def full_gem_path
  # TODO: This is a heavily used method by gems, so we'll need
  # to aleast just alias it to #gem_dir rather than remove it.
  @full_gem_path ||= find_full_gem_path
end


  








  

    #have_extensions?  ⇒ Boolean  (readonly, private)
  

  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 312



def have_extensions?; !extensions.empty?; end


  








  

    #loaded_from   (rw)
  



  

    

The path this gemspec was loaded from.  This attribute is not persisted.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 26



attr_accessor :loaded_from


  








  

    #stubbed?  ⇒ Boolean  (readonly)
  



  

    

Whether this specification is stubbed - i.e. we have information about the gem from a stub line, without having to evaluate the entire gemspec file.


  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 306



def stubbed?
  raise NotImplementedError
end


  







Instance Method Details



  

    #contains_requirable_file?(file)  ⇒ Boolean 
  



  

    

Return true if this spec can require file.


  





  


  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 68



def contains_requirable_file? file
  if @ignored then
    return false
  elsif missing_extensions? then
    @ignored = true

    warn "Ignoring #{full_name} because its extensions are not built.  " +
      "Try: gem pristine #{name} --version #{version}"
    return false
  end

  have_file? file, Gem.suffixes
end


  








  

    #datadir  
  



  

    

The path to the data directory for this gem.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 154



def datadir
# TODO: drop the extra ", gem_name" which is uselessly redundant
  File.expand_path(File.join(gems_dir, full_name, "data", name)).untaint
end


  








  

    #extensions_dir  
  



  

    

Returns path to the extensions directory.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 97



def extensions_dir
  @extensions_dir ||= Gem.default_ext_dir_for(base_dir) ||
    File.join(base_dir, 'extensions', Gem::Platform.local.to_s,
              Gem.extension_api_version)
end


  








  

    #full_name  
  



  

    

Returns the full name (name-version) of this ::Gem.  Platform information is included (name-version-platform) if it is specified and not the default Ruby platform.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 126



def full_name
  if platform == Gem::Platform::RUBY or platform.nil? then
    "#{name}-#{version}".dup.untaint
  else
    "#{name}-#{version}-#{platform}".dup.untaint
  end
end


  








  

    #full_require_paths  
  



  

    

Full paths in the gem to add to $LOAD_PATH when this gem is activated.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 138



def full_require_paths
  @full_require_paths ||=
  begin
    full_paths = raw_require_paths.map do |path|
      File.join full_gem_path, path.untaint
    end

    full_paths << extension_dir if have_extensions?

    full_paths
  end
end


  








  

    #gem_dir  
  



  

    

Returns the full path to this spec's gem directory. eg: /usr/local/lib/ruby/1.8/gems/mygem-1.0


  



  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 185



def gem_dir
  @gem_dir ||= File.expand_path File.join(gems_dir, full_name)
end


  








  

    #gems_dir  
  



  

    

Returns the full path to the gems directory containing this spec's gem directory. eg: /usr/local/lib/ruby/1.8/gems


  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 193



def gems_dir
  raise NotImplementedError
end


  








  

    #have_file?(file, suffixes)  ⇒ Boolean  (private)
  



  

    
  





  


  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 314



def have_file? file, suffixes
  return true if raw_require_paths.any? do |path|
    base = File.join(gems_dir, full_name, path.untaint, file).untaint
    suffixes.any? { |suf| File.file? base + suf }
  end

  if have_extensions?
    base = File.join extension_dir, file
    suffixes.any? { |suf| File.file? base + suf }
  else
    false
  end
end


  








  

    #lib_dirs_glob  
  



  

    

Returns a string usable in Dir.glob to match all requirable paths for this spec.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 278



def lib_dirs_glob
  dirs = if self.require_paths.size > 1 then
           "{#{self.require_paths.join(',')}}"
         else
           self.require_paths.first
         end

  "#{self.full_gem_path}/#{dirs}".dup.untaint
end


  








  

    #matches_for_glob(glob)  
  



  

    

Return all files in this gem that match for glob.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 267



def matches_for_glob glob # TODO: rename?
  # TODO: do we need these?? Kill it
  glob = File.join(self.lib_dirs_glob, glob)

  Dir[glob].map { |f| f.untaint } # FIX our tests are broken, run w/ SAFE=1
end


  








  

    #name  
  



  

    

Name of the gem


  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 208



def name
  raise NotImplementedError
end


  








  

    #platform  
  



  

    

Platform of the gem


  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 215



def platform
  raise NotImplementedError
end


  








  

    #require_paths  
  



  

    

Paths in the gem to add to $LOAD_PATH when this gem is activated.



See also #require_paths=



If you have an extension you do not need to add "ext" to the require path, the extension build process will copy the extension files into “lib” for you.



The default value is "lib"



Usage:



# If all library files are in the root directory...
spec.require_path = '.'


  



  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 240



def require_paths
  return raw_require_paths unless have_extensions?

  [extension_dir].concat raw_require_paths
end


  








  

    #source_paths  
  



  

    

Returns the paths to the source files for use with analysis and documentation tools.  These paths are relative to full_gem_path.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 250



def source_paths
  paths = raw_require_paths.dup

  if have_extensions? then
    ext_dirs = extensions.map do |extension|
      extension.split(File::SEPARATOR, 2).first
    end.uniq

    paths.concat ext_dirs
  end

  paths.uniq
end


  








  

    #to_fullpath(path)  
  



  

    

Full path of the target library file. If the file is not in this gem, return nil.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 163



def to_fullpath path
  if activated? then
    @paths_map ||= {}
    @paths_map[path] ||=
    begin
      fullpath = nil
      suffixes = Gem.suffixes
      suffixes.find do |suf|
        full_require_paths.find do |dir|
          File.file?(fullpath = "#{dir}/#{path}#{suf}")
        end
      end ? fullpath : nil
    end
  else
    nil
  end
end


  








  

    #to_spec  
  



  

    

Return a Specification from this gem


  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 291



def to_spec
  raise NotImplementedError
end


  








  

    #version  
  



  

    

Version of the gem


  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/rubygems/basic_specification.rb', line 298



def version
  raise NotImplementedError
end