Class: YARD::CodeObjects::MethodObject

Inherits:
Base
  • Object
show all
Defined in:
lib/yard/code_objects/method_object.rb

Overview

Represents a Ruby method in source

Instance Attribute Summary collapse

Attributes inherited from Base

#docstring, #dynamic, #files, #group, #namespace, #signature, #source, #source_type, #visibility

Instance Method Summary collapse

Methods inherited from Base

===, #[], #[]=, #add_file, #dynamic?, #equal?, #file, #format, #format_source, #has_tag?, #hash, #inspect, #line, #method_missing, new, #relative_path, #root?, #tag, #tags, #type

Constructor Details

#initialize(namespace, name, scope = :instance) ⇒ MethodObject

Creates a new method object in namespace with name and an instance or class scope

Parameters:

  • namespace (NamespaceObject) —

    the namespace

  • name (String, Symbol) —

    the method name

  • scope (Symbol) (defaults to: :instance) —

    :instance or :class



29
30
31
32
33
34
35
36
 
# File 'lib/yard/code_objects/method_object.rb', line 29

def initialize(namespace, name, scope = :instance)
  @scope = nil
  self.visibility = :public
  self.scope = scope
  self.parameters = []

  super
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class YARD::CodeObjects::Base

Instance Attribute Details

#explicit ⇒ Boolean

Whether the object is explicitly defined in source or whether it was inferred by a handler. For instance, attribute methods are generally inferred and therefore not explicitly defined in source.

Returns:

  • (Boolean) —

    whether the object is explicitly defined in source.



14
15
16
 
# File 'lib/yard/code_objects/method_object.rb', line 14

def explicit
  @explicit
end

#parameters ⇒ Array<Array(String, String)>

Returns the list of parameters parsed out of the method signature with their default values.

Returns:



21
22
23
 
# File 'lib/yard/code_objects/method_object.rb', line 21

def parameters
  @parameters
end

#scope ⇒ Symbol

The scope of the method (:class or :instance)

Returns:

  • (Symbol) —

    the scope



7
8
9
 
# File 'lib/yard/code_objects/method_object.rb', line 7

def scope
  @scope
end

Instance Method Details

#aliases ⇒ Array<Symbol>

Returns all alias names of the object

Returns:

  • (Array<Symbol>) —

    the alias names



106
107
108
109
110
111
112
113
 
# File 'lib/yard/code_objects/method_object.rb', line 106

def aliases
  list = []
  return list unless namespace.is_a?(NamespaceObject)
  namespace.aliases.each do |o, aname|
    list << o if aname == name && o.scope == scope
  end
  list
end

#attr_info ⇒ SymbolHash?

Returns the read/writer info for the attribute if it is one

Returns:

  • (SymbolHash) —

    if there is information about the attribute

  • (nil) —

    if the method is not an attribute

Since:

  • 0.5.3



57
58
59
60
 
# File 'lib/yard/code_objects/method_object.rb', line 57

def attr_info
  return nil unless namespace.is_a?(NamespaceObject)
  namespace.attributes[scope][name.to_s.gsub(/=$/, '')]
end

#constructor? ⇒ Boolean

Returns whether or not the method is the #initialize constructor method.

Returns:

  • (Boolean) —

    whether or not the method is the #initialize constructor method



49
50
51
 
# File 'lib/yard/code_objects/method_object.rb', line 49

def constructor?
  name == :initialize && scope == :instance && namespace.is_a?(ClassObject)
end

#is_alias? ⇒ Boolean

Tests if the object is defined as an alias of another method

Returns:

  • (Boolean) —

    whether the object is an alias



83
84
85
86
 
# File 'lib/yard/code_objects/method_object.rb', line 83

def is_alias?
  return false unless namespace.is_a?(NamespaceObject)
  namespace.aliases.has_key? self
end

#is_attribute? ⇒ Boolean

Tests if the object is defined as an attribute in the namespace

Returns:

  • (Boolean) —

    whether the object is an attribute



76
77
78
79
 
# File 'lib/yard/code_objects/method_object.rb', line 76

def is_attribute?
  return false unless info = attr_info
  info[name.to_s =~ /=$/ ? :write : :read] ? true : false
end

#is_explicit? ⇒ Boolean

Tests boolean #explicit value.

Returns:

  • (Boolean) —

    whether the method is explicitly defined in source



91
92
93
 
# File 'lib/yard/code_objects/method_object.rb', line 91

def is_explicit?
  explicit ? true : false
end

#name(prefix = false) ⇒ String, Symbol

Returns the name of the object.

Examples:

The name of an instance method (with prefix)

an_instance_method.name(true) # => "#mymethod"

The name of a class method (with prefix)

a_class_method.name(true) # => "mymethod"

Parameters:

  • prefix (Boolean) (defaults to: false) —

    whether or not to show the prefix

Returns:

  • (String) —

    returns #sep + name for an instance method if prefix is true

  • (Symbol) —

    the name without #sep if prefix is set to false



136
137
138
 
# File 'lib/yard/code_objects/method_object.rb', line 136

def name(prefix = false)
  prefix ? (sep == ISEP ? "#{sep}#{super}" : super.to_s) : super
end

#overridden_method ⇒ MethodObject?

Returns:

  • (MethodObject) —

    the object that this method overrides

  • (nil) —

    if it does not override a method

Since:

  • 0.6.0



98
99
100
101
102
 
# File 'lib/yard/code_objects/method_object.rb', line 98

def overridden_method
  return nil if namespace.is_a?(Proxy)
  meths = namespace.meths(:all => true)
  meths.find {|m| m.path != path && m.name == name && m.scope == scope }
end

#path ⇒ String

Override path handling for instance methods in the root namespace (they should still have a separator as a prefix).

Returns:

  • (String) —

    the path of a method



118
119
120
121
122
123
124
 
# File 'lib/yard/code_objects/method_object.rb', line 118

def path
  @path ||= if !namespace || namespace.path == ""
    sep + super
  else
    super
  end
end

#reader? ⇒ Boolean

Returns whether the method is a reader attribute.

Returns:

  • (Boolean) —

    whether the method is a reader attribute

Since:

  • 0.5.3



70
71
72
 
# File 'lib/yard/code_objects/method_object.rb', line 70

def reader?
  !!((info = attr_info) && info[:read] == self)
end

#sep ⇒ String (protected)

Override separator to differentiate between class and instance methods.

Returns:

  • (String) —

    “#” for an instance method, “.” for class



145
146
147
148
149
150
151
 
# File 'lib/yard/code_objects/method_object.rb', line 145

def sep
  if scope == :class
    namespace && namespace != YARD::Registry.root ? CSEP : NSEP
  else
    ISEP
  end
end

#writer? ⇒ Boolean

Returns whether the method is a writer attribute.

Returns:

  • (Boolean) —

    whether the method is a writer attribute

Since:

  • 0.5.3



64
65
66
 
# File 'lib/yard/code_objects/method_object.rb', line 64

def writer?
  !!((info = attr_info) && info[:write] == self)
end