Maintenance of Ruby 2.0.0 ended on February 24, 2016. Read more
A Module extension in a class with #extend
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
Extends are sorted by name
# File rdoc/extend.rb, line 24 def <=> other return unless self.class === other name <=> other.name end
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
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