RDoc::Extend

A Module extension in a class with #extend

Attributes

name[RW]

Name of extension module

Public Class Methods

new(name, comment) click to toggle source

Creates a new Extend for name with comment

 
               # File rdoc/extend.rb, line 14
def initialize(name, comment)
  super()
  @name = name
  self.comment = comment
  @module = nil # cache for module if found
end

Public Instance Methods

<=>(other) click to toggle source

Extends are sorted by name

 
               # File rdoc/extend.rb, line 24
def <=> other
  return unless self.class === other

  name <=> other.name
end

full_name() click to toggle source

Full name based on module

 
               # File rdoc/extend.rb, line 39
def full_name
  m = self.module
  RDoc::ClassModule === m ? m.full_name : @name
end

module() click to toggle source

Attempts to locate the extend module object. Returns the name if not known.

The scoping rules of Ruby to resolve the name of an extension module are:

first look into the children of the current context;
if not found, look into the children of extension modules, in reverse extend order;
if still not found, go up the hierarchy of names.

This method has O(n!) behavior when the module calling extend is referencing nonexistent modules. Avoid calling module until after all the files are parsed. This behavior is due to ruby’s constant lookup behavior.

 
               # File rdoc/extend.rb, line 71
def module
  return @module if @module

  # search the current context
  return @name unless parent
  full_name = parent.child_name(@name)
  @module = @store.modules_hash[full_name]
  return @module if @module
  return @name if @name =~ /^::/

  # search the includes before this one, in reverse order
  searched = parent.extends.take_while { |i| i != self }.reverse
  searched.each do |i|
    ext = i.module
    next if String === ext
    full_name = ext.child_name(@name)
    @module = @store.modules_hash[full_name]
    return @module if @module
  end

  # go up the hierarchy of names
  up = parent.parent
  while up
    full_name = up.child_name(@name)
    @module = @store.modules_hash[full_name]
    return @module if @module
    up = up.parent
  end

  @name
end

store=(store) click to toggle source

Sets the store for this class or module and its contained code objects.

 
               # File rdoc/extend.rb, line 106
def store= store
  super

  @file = @store.add_file @file.full_name if @file
end

Commenting is here to help enhance the documentation. For example, code samples, or clarification of the documentation.

If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.

If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.

If you want to help improve the Ruby documentation, please see Improve the docs, or visit Documenting-ruby.org.

Home Classes Methods

In Files

Parent

Methods

Class/Module Index

RDoc::Extend

Attributes

Public Class Methods

Public Instance Methods