Class: Solargraph::ApiMap::Store

Inherits:
Object
  • Object
show all
Defined in:
lib/solargraph/api_map/store.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(pins = []) ⇒ Store

Returns a new instance of Store.

Parameters:



11
12
13
14
 
# File 'lib/solargraph/api_map/store.rb', line 11

def initialize pins = []
  @pins = pins
  index
end

Instance Attribute Details

#pins ⇒ Array<Solargraph::Pin::Base> (readonly)

Returns:



8
9
10
 
# File 'lib/solargraph/api_map/store.rb', line 8

def pins
  @pins
end

Instance Method Details

#block_pins ⇒ Enumerable<Pin::Block>

Returns:



138
139
140
 
# File 'lib/solargraph/api_map/store.rb', line 138

def block_pins
  pins_by_class(Pin::Block)
end

#cacheable_pins ⇒ Object 



68
69
70
 
# File 'lib/solargraph/api_map/store.rb', line 68

def cacheable_pins
  @cacheable_pins ||= pins_by_class(Pin::Namespace) + pins_by_class(Pin::Constant) + pins_by_class(Pin::Method) + pins_by_class(Pin::Reference)
end

#domains(fqns) ⇒ Array<String>

Parameters:

  • fqns (String)

Returns:

  • (Array<String>) 


115
116
117
118
119
120
121
 
# File 'lib/solargraph/api_map/store.rb', line 115

def domains(fqns)
  result = []
  fqns_pins(fqns).each do |nspin|
    result.concat nspin.domains
  end
  result
end

#fqns_pins(fqns) ⇒ Array<Solargraph::Pin::Namespace>

Parameters:

  • fqns (String)

Returns:



158
159
160
161
162
163
164
165
166
167
168
169
 
# File 'lib/solargraph/api_map/store.rb', line 158

def fqns_pins fqns
  return [] if fqns.nil?
  if fqns.include?('::')
    parts = fqns.split('::')
    name = parts.pop
    base = parts.join('::')
  else
    base = ''
    name = fqns
  end
  fqns_pins_map[[base, name]]
end

#get_class_variables(fqns) ⇒ Enumerable<Solargraph::Pin::Base>

Parameters:

  • fqns (String)

Returns:



83
84
85
 
# File 'lib/solargraph/api_map/store.rb', line 83

def get_class_variables(fqns)
  namespace_children(fqns).select{|pin| pin.is_a?(Pin::ClassVariable)}
end

#get_constants(fqns, visibility = [:public]) ⇒ Enumerable<Solargraph::Pin::Base>

Parameters:

  • fqns (String)
  • visibility (Array<Symbol>) (defaults to: [:public])

Returns:



19
20
21
22
23
 
# File 'lib/solargraph/api_map/store.rb', line 19

def get_constants fqns, visibility = [:public]
  namespace_children(fqns).select { |pin|
    !pin.name.empty? && (pin.is_a?(Pin::Namespace) || pin.is_a?(Pin::Constant)) && visibility.include?(pin.visibility)
  }
end

#get_extends(fqns) ⇒ Array<String>

Parameters:

  • fqns (String)

Returns:

  • (Array<String>) 


58
59
60
 
# File 'lib/solargraph/api_map/store.rb', line 58

def get_extends fqns
  extend_references[fqns] || []
end

#get_includes(fqns) ⇒ Array<String>

Parameters:

  • fqns (String)

Returns:

  • (Array<String>) 


46
47
48
 
# File 'lib/solargraph/api_map/store.rb', line 46

def get_includes fqns
  include_references[fqns] || []
end

#get_instance_variables(fqns, scope = :instance) ⇒ Enumerable<Solargraph::Pin::Base>

Parameters:

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

    :class or :instance

Returns:



75
76
77
78
79
 
# File 'lib/solargraph/api_map/store.rb', line 75

def get_instance_variables(fqns, scope = :instance)
  all_instance_variables.select { |pin|
    pin.binder.namespace == fqns && pin.binder.scope == scope
  }
end

#get_methods(fqns, scope: :instance, visibility: [:public]) ⇒ Enumerable<Solargraph::Pin::Method>

Parameters:

  • fqns (String)
  • scope (Symbol) (defaults to: :instance)
  • visibility (Array<Symbol>) (defaults to: [:public])

Returns:



29
30
31
32
33
 
# File 'lib/solargraph/api_map/store.rb', line 29

def get_methods fqns, scope: :instance, visibility: [:public]
  namespace_children(fqns).select do |pin|
    pin.is_a?(Pin::Method) && pin.scope == scope && visibility.include?(pin.visibility)
  end
end

#get_path_pins(path) ⇒ Array<Solargraph::Pin::Base>

Parameters:

  • path (String)

Returns:



64
65
66
 
# File 'lib/solargraph/api_map/store.rb', line 64

def get_path_pins path
  path_pin_hash[path] || []
end

#get_prepends(fqns) ⇒ Array<String>

Parameters:

  • fqns (String)

Returns:

  • (Array<String>) 


52
53
54
 
# File 'lib/solargraph/api_map/store.rb', line 52

def get_prepends fqns
  prepend_references[fqns] || []
end

#get_superclass(fqns) ⇒ String?

Parameters:

  • fqns (String)

Returns:

  • (String, nil) 


37
38
39
40
41
42
 
# File 'lib/solargraph/api_map/store.rb', line 37

def get_superclass fqns
  return superclass_references[fqns].first if superclass_references.key?(fqns)
  return 'Object' if fqns != 'BasicObject' && namespace_exists?(fqns)
  return 'Object' if fqns == 'Boolean'
  nil
end

#get_symbols ⇒ Enumerable<Solargraph::Pin::Base>

Returns:



88
89
90
 
# File 'lib/solargraph/api_map/store.rb', line 88

def get_symbols
  symbols.uniq(&:name)
end

#inspect ⇒ Object 



142
143
144
145
 
# File 'lib/solargraph/api_map/store.rb', line 142

def inspect
  # Avoid insane dumps in specs
  to_s
end

#method_pins ⇒ Enumerable<Solargraph::Pin::Method>

Returns:



109
110
111
 
# File 'lib/solargraph/api_map/store.rb', line 109

def method_pins
  pins_by_class(Solargraph::Pin::Method)
end

#named_macros ⇒ Hash{String => YARD::Tags::MacroDirective}

Returns:

  • (Hash{String => YARD::Tags::MacroDirective}) 


124
125
126
127
128
129
130
131
132
133
134
135
 
# File 'lib/solargraph/api_map/store.rb', line 124

def named_macros
  @named_macros ||= begin
    result = {}
    pins.each do |pin|
      pin.macros.select{|m| m.tag.tag_name == 'macro' && !m.tag.text.empty? }.each do |macro|
        next if macro.tag.name.nil? || macro.tag.name.empty?
        result[macro.tag.name] = macro
      end
    end
    result
  end
end

#namespace_exists?(fqns) ⇒ Boolean

Parameters:

  • fqns (String)

Returns:

  • (Boolean) 


94
95
96
 
# File 'lib/solargraph/api_map/store.rb', line 94

def namespace_exists?(fqns)
  fqns_pins(fqns).any?
end

#namespace_pins ⇒ Array<Solargraph::Pin::Base>

Returns:



104
105
106
 
# File 'lib/solargraph/api_map/store.rb', line 104

def namespace_pins
  pins_by_class(Solargraph::Pin::Namespace)
end

#namespaces ⇒ Set<String>

Returns:

  • (Set<String>) 


99
100
101
 
# File 'lib/solargraph/api_map/store.rb', line 99

def namespaces
  @namespaces ||= Set.new
end

#pins_by_class(klass) ⇒ Array<T>

Parameters:

  • klass (Class<T>)

Returns:

  • (Array<T>) 


150
151
152
153
154
 
# File 'lib/solargraph/api_map/store.rb', line 150

def pins_by_class klass
  # @type [Set<Solargraph::Pin::Base>]
  s = Set.new
  @pin_select_cache[klass] ||= @pin_class_hash.each_with_object(s) { |(key, o), n| n.merge(o) if key <= klass }
end