Class: Gem::StubSpecification
Relationships & Source Files | |
Super Chains via Extension / Inclusion / Inheritance | |
Class Chain:
self,
BasicSpecification
|
|
Instance Chain:
self,
BasicSpecification
|
|
Inherits: |
Gem::BasicSpecification
|
Defined in: | lib/rubygems/stub_specification.rb |
Overview
StubSpecification
reads the stub: line from the gemspec. This prevents us having to eval the entire gemspec in order to find out certain information.
Class Method Summary
- .default_gemspec_stub(filename, base_dir, gems_dir)
- .gemspec_stub(filename, base_dir, gems_dir)
- .new(filename, base_dir, gems_dir, default_gem) ⇒ StubSpecification constructor
BasicSpecification - Inherited
Instance Attribute Summary
-
#activated? ⇒ Boolean
readonly
True when this gem has been activated.
- #base_dir readonly
- #default_gem? ⇒ Boolean readonly
- #gems_dir readonly
- #missing_extensions? ⇒ Boolean readonly
-
#stubbed? ⇒ Boolean
readonly
Is there a stub line present for this StubSpecification?
-
#valid? ⇒ Boolean
readonly
Is this
StubSpecification
valid? i.e.
BasicSpecification - Inherited
#base_dir | Returns the full path to the base gem directory. |
#extension_dir | Returns full path to the directory where gem's extensions are installed. |
#full_gem_path | The full path to the gem (install path + full name). |
#loaded_from | The path this gemspec was loaded from. |
#activated? | True when the gem has been activated. |
#default_gem?, | |
#stubbed? | Whether this specification is stubbed - i.e. |
#have_extensions? |
Instance Method Summary
-
#extensions
Extensions for this gem.
- #full_name
-
#name
Name of the gem.
-
#platform
Platform of the gem.
- #this
-
#to_spec
The full Specification for this gem, loaded from evalling its gemspec.
-
#version
Version of the gem.
-
#data
private
If the gemspec contains a stubline, returns a StubLine instance.
BasicSpecification - Inherited
#contains_requirable_file? | Return true if this spec can require |
#datadir | The path to the data directory for this gem. |
#extensions_dir | Returns path to the extensions directory. |
#full_name | Returns the full name (name-version) of this ::Gem. |
#full_require_paths | Full paths in the gem to add to |
#gem_dir | Returns the full path to this spec's gem directory. |
#gems_dir | Returns the full path to the gems directory containing this spec's gem directory. |
#lib_dirs_glob | Returns a string usable in |
#matches_for_glob | Return all files in this gem that match for |
#name | Name of the gem. |
#platform | Platform of the gem. |
#require_paths | Paths in the gem to add to |
#source_paths | Returns the paths to the source files for use with analysis and documentation tools. |
#to_fullpath | Full path of the target library file. |
#to_spec | Return a Specification from this gem. |
#version | Version of the gem. |
#have_file? |
Constructor Details
.new(filename, base_dir, gems_dir, default_gem) ⇒ StubSpecification
Class Method Details
.default_gemspec_stub(filename, base_dir, gems_dir)
[ GitHub ].gemspec_stub(filename, base_dir, gems_dir)
[ GitHub ]Instance Attribute Details
#activated? ⇒ Boolean
(readonly)
True when this gem has been activated
# File 'lib/rubygems/stub_specification.rb', line 84
def activated? @activated ||= begin loaded = Gem.loaded_specs[name] loaded && loaded.version == version end end
#base_dir (readonly)
[ GitHub ]# File 'lib/rubygems/stub_specification.rb', line 66
attr_reader :base_dir, :gems_dir
#default_gem? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'lib/rubygems/stub_specification.rb', line 94
def default_gem? @default_gem end
#gems_dir (readonly)
[ GitHub ]# File 'lib/rubygems/stub_specification.rb', line 66
attr_reader :base_dir, :gems_dir
#missing_extensions? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'lib/rubygems/stub_specification.rb', line 143
def missing_extensions? return false if default_gem? return false if extensions.empty? return false if File.exist? gem_build_complete_path to_spec.missing_extensions? end
#stubbed? ⇒ Boolean
(readonly)
Is there a stub line present for this StubSpecification?
#valid? ⇒ Boolean
(readonly)
Is this StubSpecification
valid? i.e. have we found a stub line, OR does the filename contain a valid gemspec?
# File 'lib/rubygems/stub_specification.rb', line 203
def valid? data end
Instance Method Details
#data (private)
If the gemspec contains a stubline, returns a StubSpecification::StubLine instance. Otherwise returns the full Specification.
# File 'lib/rubygems/stub_specification.rb', line 109
def data unless @data begin saved_lineno = $. open loaded_from, OPEN_MODE do |file| begin file.readline # discard encoding line stubline = file.readline.chomp if stubline.start_with?(PREFIX) then extensions = if /\A#{PREFIX}/ =~ file.readline.chomp $'.split "\0" else StubLine::NO_EXTENSIONS end @data = StubLine.new stubline, extensions end rescue EOFError end end ensure $. = saved_lineno end end @data ||= to_spec end
#extensions
Extensions for this gem
# File 'lib/rubygems/stub_specification.rb', line 168
def extensions data.extensions end
#full_name
[ GitHub ]# File 'lib/rubygems/stub_specification.rb', line 179
def full_name data.full_name end
#name
Name of the gem
# File 'lib/rubygems/stub_specification.rb', line 154
def name data.name end
#platform
Platform of the gem
# File 'lib/rubygems/stub_specification.rb', line 161
def platform data.platform end
#this
[ GitHub ]# File 'lib/rubygems/stub_specification.rb', line 92
def this; self; end
#to_spec
The full Specification for this gem, loaded from evalling its gemspec
# File 'lib/rubygems/stub_specification.rb', line 186
def to_spec @spec ||= if @data then Gem.loaded_specs.values.find { |spec| spec.name == name and spec.version == version } end @spec ||= Gem::Specification.load(loaded_from) @spec.ignored = @ignored if @spec @spec end
#version
Version of the gem
# File 'lib/rubygems/stub_specification.rb', line 175
def version data.version end