Class: YARD::Handlers::Ruby::Legacy::AliasHandler

Inherits:
Base show all
Defined in:
lib/yard/handlers/ruby/legacy/alias_handler.rb

Constant Summary

Constants included from YARD::Parser::Ruby::Legacy::RubyToken

EXPR_ARG, EXPR_BEG, EXPR_CLASS, EXPR_DOT, EXPR_END, EXPR_FNAME, EXPR_MID, NEWLINE_TOKEN, TkReading2Token, TkSymbol2Token, TokenDefinitions

Constants included from YARD::CodeObjects

BUILTIN_ALL, BUILTIN_CLASSES, BUILTIN_EXCEPTIONS, BUILTIN_EXCEPTIONS_HASH, BUILTIN_MODULES, CONSTANTMATCH, CSEP, CSEPQ, ISEP, ISEPQ, METHODMATCH, METHODNAMEMATCH, NAMESPACEMATCH, NSEP, NSEPQ

Instance Method Summary

Methods inherited from Base

handles?, #parse_block

Methods included from YARD::Parser::Ruby::Legacy::RubyToken

#Token, def_token, #set_token_position

Methods inherited from YARD::Handlers::Base

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

Constructor Details

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

Instance Method Details

- (Object) process

Raises:



4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/yard/handlers/ruby/legacy/alias_handler.rb', line 4

def process
  if TkALIAS === statement.tokens.first 
    tokens = statement.tokens[2..-1].to_s.split(/\s+/)
    names = [tokens[0], tokens[1]].map {|t| t.gsub(/^:/, '') }
  else
    names = tokval_list(statement.tokens[2..-1], :attr)
  end
  raise YARD::Parser::UndocumentableError, statement.tokens.first.text if names.size != 2
  
  new_meth, old_meth = names[0].to_sym, names[1].to_sym
  old_obj = namespace.child(:name => old_meth, :scope => scope)
  new_obj = register MethodObject.new(namespace, new_meth, scope) do |o|
    o.visibility = visibility
    o.scope = scope
    o.add_file(parser.file, statement.tokens.first.line_no)
    o.docstring = statement.comments

    if old_obj
      o.signature = old_obj.signature
      o.source = old_obj.source
    else
      o.signature = "def #{new_meth}" # this is all we know.
    end
  end
  
  namespace.aliases[new_obj] = old_meth
end