Class: YARD::Handlers::Ruby::MixinHandler

Inherits:
Base
  • Object
show all
Defined in:
lib/yard/handlers/ruby/mixin_handler.rb

Overview

Handles the 'include' statement to mixin a module in the instance scope

Constant Summary

Instance Attribute Summary

Attributes inherited from Base

#namespace, #owner, #parser, #scope, #statement, #visibility

Instance Method Summary (collapse)

Methods inherited from Base

handles?, meta_type, method_call, #parse_block

Methods included from Parser::Ruby

#s

Methods inherited from Base

clear_subclasses, #ensure_loaded!, handlers, handles, handles?, #initialize, namespace_only, namespace_only?, #parse_block, process, #push_state, #register, subclasses

Constructor Details

This class inherits a constructor from YARD::Handlers::Base

Instance Method Details

- (Object) process

Main processing callback



6
7
8
 
# File 'lib/yard/handlers/ruby/mixin_handler.rb', line 6

process do
  statement.parameters(false).each {|mixin| process_mixin(mixin) }
end

- (Object) process_mixin(mixin) (protected) 



12
13
14
15
16
17
18
19
20
21
22
23
24
25
 
# File 'lib/yard/handlers/ruby/mixin_handler.rb', line 12

def process_mixin(mixin)
  unless mixin.ref?
    raise YARD::Parser::UndocumentableError, "mixin #{mixin.source} for class #{namespace.path}"
  end
  
  case obj = Proxy.new(namespace, mixin.source)
  when Proxy
    obj.type = :module
  when ConstantObject # If a constant is included, use its value as the real object
    obj = Proxy.new(namespace, obj.value)
  end
  
  namespace.mixins(scope).unshift(obj) unless namespace.mixins(scope).include?(obj)
end