class Gem::BasicSpecification
BasicSpecification
is an abstract class which implements some common code used by both Specification and StubSpecification.
Attributes
The path this gemspec was loaded from. This attribute is not persisted.
Public Class Methods
# File rubygems/basic_specification.rb, line 37 def self.default_specifications_dir Gem.default_specifications_dir end
# File rubygems/basic_specification.rb, line 33 def initialize internal_init end
Public Instance Methods
True when the gem has been activated
# File rubygems/basic_specification.rb, line 57 def activated? raise NotImplementedError end
Returns the full path to the base gem directory.
eg: /usr/local/lib/ruby/gems/1.8
# File rubygems/basic_specification.rb, line 66 def base_dir raise NotImplementedError end
Gems higher up in gem_path
take precedence
# File rubygems/basic_specification.rb, line 111 def base_dir_priority(gem_path) gem_path.index(base_dir) || gem_path.size end
Return true if this spec can require file
.
# File rubygems/basic_specification.rb, line 73 def contains_requirable_file?(file) if @ignored return false elsif missing_extensions? @ignored = true if platform == Gem::Platform::RUBY || Gem::Platform.local === platform warn "Ignoring #{full_name} because its extensions are not built. " \ "Try: gem pristine #{name} --version #{version}" end return false end is_soext = file.end_with?(".so", ".o") if is_soext have_file? file.delete_suffix(File.extname(file)), Gem.dynamic_library_suffixes else have_file? file, Gem.suffixes end end
The path to the data directory for this gem.
# File rubygems/basic_specification.rb, line 193 def datadir # TODO: drop the extra ", gem_name" which is uselessly redundant File.expand_path(File.join(gems_dir, full_name, "data", name)) end
# File rubygems/basic_specification.rb, line 96 def default_gem? loaded_from && File.dirname(loaded_from) == Gem.default_specifications_dir end
Regular gems take precedence over default gems
# File rubygems/basic_specification.rb, line 104 def default_gem_priority default_gem? ? 1 : -1 end
Returns full path to the directory where gem’s extensions are installed.
# File rubygems/basic_specification.rb, line 118 def extension_dir @extension_dir ||= File.expand_path(File.join(extensions_dir, full_name)) end
Returns path to the extensions directory.
# File rubygems/basic_specification.rb, line 125 def extensions_dir Gem.default_ext_dir_for(base_dir) || File.join(base_dir, "extensions", Gem::Platform.local.to_s, Gem.extension_api_version) end
The full path to the gem (install path + full name).
# File rubygems/basic_specification.rb, line 141 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
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.
# File rubygems/basic_specification.rb, line 152 def full_name if platform == Gem::Platform::RUBY || platform.nil? "#{name}-#{version}" else "#{name}-#{version}-#{platform}" end end
Returns the full name of this Gem
(see ‘Gem::BasicSpecification#full_name`). Information about where the gem is installed is also included if not installed in the default GEM_HOME.
# File rubygems/basic_specification.rb, line 165 def full_name_with_location if base_dir != Gem.dir "#{full_name} in #{base_dir}" else full_name end end
Full paths in the gem to add to $LOAD_PATH
when this gem is activated.
# File rubygems/basic_specification.rb, line 177 def full_require_paths @full_require_paths ||= begin full_paths = raw_require_paths.map do |path| File.join full_gem_path, path end full_paths << extension_dir if have_extensions? full_paths end end
Returns the full path to this spec’s gem directory. eg: /usr/local/lib/ruby/1.8/gems/mygem-1.0
# File rubygems/basic_specification.rb, line 220 def gem_dir @gem_dir ||= File.expand_path File.join(gems_dir, full_name) end
Returns the full path to the gems directory containing this spec’s gem directory. eg: /usr/local/lib/ruby/1.8/gems
# File rubygems/basic_specification.rb, line 228 def gems_dir raise NotImplementedError end
Returns a string usable in Dir.glob to match all requirable paths for this spec.
# File rubygems/basic_specification.rb, line 318 def lib_dirs_glob dirs = if raw_require_paths if raw_require_paths.size > 1 "{#{raw_require_paths.join(",")}}" else raw_require_paths.first end else "lib" # default value for require_paths for bundler/inline end "#{full_gem_path}/#{dirs}" end
Return all files in this gem that match for glob
.
# File rubygems/basic_specification.rb, line 301 def matches_for_glob(glob) # TODO: rename? glob = File.join(lib_dirs_glob, glob) Dir[glob] end
Name of the gem
# File rubygems/basic_specification.rb, line 242 def name raise NotImplementedError end
Platform of the gem
# File rubygems/basic_specification.rb, line 249 def platform raise NotImplementedError end
Returns the list of plugins in this spec.
# File rubygems/basic_specification.rb, line 310 def plugins matches_for_glob("rubygems#{Gem.plugin_suffix_pattern}") end
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 = '.'
# File rubygems/basic_specification.rb, line 274 def require_paths return raw_require_paths unless have_extensions? [extension_dir].concat raw_require_paths end
Returns the paths to the source files for use with analysis and documentation tools. These paths are relative to full_gem_path.
# File rubygems/basic_specification.rb, line 284 def source_paths paths = raw_require_paths.dup if have_extensions? ext_dirs = extensions.map do |extension| extension.split(File::SEPARATOR, 2).first end.uniq paths.concat ext_dirs end paths.uniq end
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.
# File rubygems/basic_specification.rb, line 350 def stubbed? raise NotImplementedError end
# File rubygems/basic_specification.rb, line 354 def this self end
Full path of the target library file. If the file is not in this gem, return nil.
# File rubygems/basic_specification.rb, line 202 def to_fullpath(path) if activated? @paths_map ||= {} Gem.suffixes.each do |suf| full_require_paths.each do |dir| fullpath = "#{dir}/#{path}#{suf}" next unless File.file?(fullpath) @paths_map[path] ||= fullpath end end @paths_map[path] end end
Return a Gem::Specification
from this gem
# File rubygems/basic_specification.rb, line 335 def to_spec raise NotImplementedError end
Version of the gem
# File rubygems/basic_specification.rb, line 342 def version raise NotImplementedError end
Private Instance Methods
# File rubygems/basic_specification.rb, line 360 def have_extensions? !extensions.empty? end
# File rubygems/basic_specification.rb, line 364 def have_file?(file, suffixes) return true if raw_require_paths.any? do |path| base = File.join(gems_dir, full_name, path, file) 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