Class: Inch::Language::JavaScript::Provider::JSDoc::Object::Base Abstract

Inherits:
Object
  • Object
show all
Defined in:
lib/inch/language/javascript/provider/jsdoc/object/base.rb

Overview

This class is abstract.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(hash) ⇒ Base

Returns a new instance of Base.

Parameters:

  • hash (Hash) —

    hash returned via JSON interface



16
17
18
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 16

def initialize(hash)
  @hash = hash
end

Instance Attribute Details

#base_dir ⇒ String

Returns the codebase’s directory.

Returns:

  • (String) —

    the codebase’s directory



13
14
15
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 13

def base_dir
  @base_dir
end

#children_fullnames ⇒ Object 



45
46
47
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 45

def children_fullnames
  @children_fullnames ||= []
end

Instance Method Details

#aliased_object_fullname ⇒ Object 



57
58
59
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 57

def aliased_object_fullname
  nil
end

#aliases_fullnames ⇒ Object 



61
62
63
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 61

def aliases_fullnames
  nil
end

#api_tag? ⇒ Boolean

Returns:

  • (Boolean) 


53
54
55
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 53

def api_tag?
  nil
end

#attributes ⇒ Object 



65
66
67
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 65

def attributes
  []
end

#bang_name? ⇒ Boolean

Returns:

  • (Boolean) 


69
70
71
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 69

def bang_name?
  false
end

#constant? ⇒ Boolean

Returns:

  • (Boolean) 


73
74
75
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 73

def constant?
  false # raise NotImplementedError
end

#constructor? ⇒ Boolean

Returns:

  • (Boolean) 


77
78
79
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 77

def constructor?
  false
end

#depth ⇒ Object 



81
82
83
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 81

def depth
  fullname.split('.').size
end

#docstring ⇒ Docstring

Returns:



86
87
88
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 86

def docstring
  @docstring ||= Docstring.new(@hash['comment'])
end

#filename ⇒ Object 



40
41
42
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 40

def filename
  files.first.filename unless files.empty?
end

#files ⇒ Array<CodeLocation>

Returns all files declaring the object in the form of an Array of Arrays containing the location of their declaration.

Returns:

  • (Array<CodeLocation>) 


32
33
34
35
36
37
38
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 32

def files
  return [] unless meta?
  filename = meta['path'] + '/' + meta['filename']
  [
    Inch::Utils::CodeLocation.new('', filename, meta['lineno'])
  ]
end

#fullname ⇒ Object 



24
25
26
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 24

def fullname
  @hash['longname']
end

#getter? ⇒ Boolean

Returns:

  • (Boolean) 


90
91
92
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 90

def getter?
  fullname =~ /(\A|#|\.)(get)[A-Z]/
end

#has_children? ⇒ Boolean

Returns:

  • (Boolean) 


94
95
96
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 94

def has_children?
  !children_fullnames.empty?
end

#has_code_example? ⇒ Boolean

Returns:

  • (Boolean) 


98
99
100
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 98

def has_code_example?
  docstring.contains_code_example?
end

#has_doc? ⇒ Boolean

Returns:

  • (Boolean) 


102
103
104
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 102

def has_doc?
  !undocumented?
end

#has_multiple_code_examples? ⇒ Boolean

Returns:

  • (Boolean) 


106
107
108
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 106

def has_multiple_code_examples?
  docstring.code_examples.size > 1
end

#has_unconsidered_tags? ⇒ Boolean

Returns:

  • (Boolean) 


110
111
112
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 110

def has_unconsidered_tags?
  false # raise NotImplementedError
end

#in_root? ⇒ Boolean

Returns:

  • (Boolean) 


185
186
187
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 185

def in_root?
  depth == 1
end

#method? ⇒ Boolean

Returns:

  • (Boolean) 


114
115
116
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 114

def method?
  false
end

#name ⇒ Object 



20
21
22
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 20

def name
  @hash['name']
end

#namespace? ⇒ Boolean

Returns:

  • (Boolean) 


122
123
124
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 122

def namespace?
  false
end

#nodoc? ⇒ Boolean

Returns:

  • (Boolean) 


118
119
120
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 118

def nodoc?
  @hash['comment'] == false
end

#original_docstring ⇒ Object 



126
127
128
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 126

def original_docstring
  @hash['comment']
end

#overridden? ⇒ Boolean

Returns:

  • (Boolean) 


130
131
132
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 130

def overridden?
  false # raise NotImplementedError
end

#overridden_method_fullname ⇒ Object 



134
135
136
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 134

def overridden_method_fullname
  nil # raise NotImplementedError
end

#parameters ⇒ Object 



138
139
140
141
142
143
144
145
146
147
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 138

def parameters
  if meta? && meta['code']
    names = meta['code']['paramnames'] || []
    names.map do |name|
      FunctionParameterObject.new(self, name)
    end
  else
    []
  end
end

#parent_fullname ⇒ Object 



49
50
51
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 49

def parent_fullname
  @hash['memberof'] || retrieve_parent_fullname
end

#private? ⇒ Boolean

Returns:

  • (Boolean) 


149
150
151
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 149

def private?
  visibility == 'private' || private_name?
end

#protected? ⇒ Boolean

Returns:

  • (Boolean) 


161
162
163
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 161

def protected?
  visibility == 'protected'
end

#public? ⇒ Boolean

Returns:

  • (Boolean) 


165
166
167
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 165

def public?
  visibility == 'public'
end

#questioning_name? ⇒ Boolean

Returns:

  • (Boolean) 


169
170
171
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 169

def questioning_name?
  fullname =~ /(\A|#|\.)(has|is)[A-Z]/
end

#return_described? ⇒ Boolean

Returns:

  • (Boolean) 


173
174
175
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 173

def return_described?
  docstring.describes_return?
end

#return_mentioned? ⇒ Boolean

Returns:

  • (Boolean) 


177
178
179
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 177

def return_mentioned?
  docstring.mentions_return?
end

#return_typed? ⇒ Boolean

Returns:

  • (Boolean) 


181
182
183
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 181

def return_typed?
  return_mentioned?
end

#setter? ⇒ Boolean

Returns:

  • (Boolean) 


189
190
191
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 189

def setter?
  fullname =~ /(\A|#|\.)(set)[A-Z]/
end

#source ⇒ Object 



193
194
195
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 193

def source
  nil
end

#tagged_as_internal_api? ⇒ Boolean

Returns:

  • (Boolean) 


153
154
155
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 153

def tagged_as_internal_api?
  false
end

#tagged_as_private? ⇒ Boolean

Returns:

  • (Boolean) 


157
158
159
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 157

def tagged_as_private?
  nodoc?
end

#unconsidered_tag_count ⇒ Object 



197
198
199
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 197

def unconsidered_tag_count
  0
end

#undocumented? ⇒ Boolean

Returns:

  • (Boolean) 


201
202
203
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 201

def undocumented?
  @hash['comment'].to_s.empty?
end

#visibility ⇒ Object 



205
206
207
 
# File 'lib/inch/language/javascript/provider/jsdoc/object/base.rb', line 205

def visibility
  docstring.visibility(@hash['access'])
end