Module: Solargraph::Parser::ParserGem::ClassMethods

Included in:
Solargraph::Parser
Defined in:
lib/solargraph/parser/parser_gem/class_methods.rb

Instance Method Summary collapse

Instance Method Details

#chain(*args) ⇒ Source::Chain

Returns:



98
99
100
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 98

def chain *args
  NodeChainer.chain *args
end

#chain_string(*args) ⇒ Source::Chain

Returns:



103
104
105
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 103

def chain_string *args
  NodeChainer.load_string *args
end

#infer_literal_node_type(node) ⇒ String?

Parameters:

  • node (Parser::AST::Node)

Returns:

  • (String, nil) 


114
115
116
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 114

def infer_literal_node_type node
  NodeMethods.infer_literal_node_type node
end

#inner_node_references(name, top) ⇒ Array<AST::Node>

Parameters:

Returns:



88
89
90
91
92
93
94
95
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 88

def inner_node_references name, top
  result = []
  if top.is_a?(AST::Node) && top.to_s.include?(":#{name}")
    result.push top if top.children.any? { |c| c.to_s == name }
    top.children.each { |c| result.concat inner_node_references(name, c) }
  end
  result
end

#is_ast_node?(node) ⇒ Boolean

Parameters:

  • node (BasicObject)

Returns:

  • (Boolean) 


125
126
127
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 125

def is_ast_node? node
  node.is_a?(::Parser::AST::Node)
end

#map(source) ⇒ Array(Array<Pin::Base>, Array<Pin::Base>)

Parameters:

Returns:



47
48
49
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 47

def map source
  NodeProcessor.process(source.node, Region.new(source: source))
end

#node_range(node) ⇒ Range

Parameters:

  • node (Parser::AST::Node)

Returns:



131
132
133
134
135
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 131

def node_range node
  st = Position.new(node.loc.line, node.loc.column)
  en = Position.new(node.loc.last_line, node.loc.last_column)
  Range.new(st, en)
end

#parse(code, filename = nil, line = 0) ⇒ Parser::AST::Node

Parameters:

  • code (String)
  • filename (String, nil) (defaults to: nil)
  • line (Integer) (defaults to: 0)

Returns:

  • (Parser::AST::Node) 


27
28
29
30
31
32
33
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 27

def parse code, filename = nil, line = 0
  buffer = ::Parser::Source::Buffer.new(filename, line)
  buffer.source = code
  parser.parse(buffer)
rescue ::Parser::SyntaxError => e
  raise Parser::SyntaxError, e.message
end

#parse_with_comments(code, filename = nil) ⇒ Array(Parser::AST::Node, Hash{Integer => String})

Parameters:

  • code (String)
  • filename (String, nil) (defaults to: nil)

Returns:

  • (Array(Parser::AST::Node, Hash{Integer => String})) 


13
14
15
16
17
18
19
20
21
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 13

def parse_with_comments code, filename = nil
  buffer = ::Parser::Source::Buffer.new(filename, 0)
  buffer.source = code
  node = parser.parse(buffer)
  comments = CommentRipper.new(code, filename, 0).parse
  [node, comments]
rescue ::Parser::SyntaxError => e
  raise Parser::SyntaxError, e.message
end

#parser ⇒ ::Parser::Base

Returns:

  • (::Parser::Base) 


36
37
38
39
40
41
42
43
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 36

def parser
  # @todo Consider setting an instance variable. We might not need to
  #   recreate the parser every time we use it.
  parser = ::Parser::CurrentRuby.new(FlawedBuilder.new)
  parser.diagnostics.all_errors_are_fatal = true
  parser.diagnostics.ignore_warnings      = true
  parser
end

#process_node(*args) ⇒ Array(Array<Pin::Base>, Array<Pin::Base>)

Returns:



108
109
110
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 108

def process_node *args
  Solargraph::Parser::NodeProcessor.process *args
end

#references(source, name) ⇒ Array<Location>

Parameters:

  • source (Source)
  • name (String)

Returns:



60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 60

def references source, name
  if name.end_with?("=")
    reg = /#{Regexp.escape name[0..-2]}\s*=/
    # @param code [String]
    # @param offset [Integer]
    extract_offset = ->(code, offset) { reg.match(code, offset).offset(0) }
  else
    # @param code [String]
    # @param offset [Integer]
    extract_offset = ->(code, offset) { [soff = code.index(name, offset), soff + name.length] }
  end
  inner_node_references(name, source.node).map do |n|
    rng = Range.from_node(n)
    offset = Position.to_offset(source.code, rng.start)
    soff, eoff = extract_offset[source.code, offset]
    Location.new(
      source.filename,
      Range.new(
        Position.from_offset(source.code, soff),
        Position.from_offset(source.code, eoff)
      )
    )
  end
end

#returns_from(node) ⇒ Array<Parser::AST::Node>

Parameters:

  • node (Parser::AST::Node)

Returns:

  • (Array<Parser::AST::Node>) 


53
54
55
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 53

def returns_from node
  NodeMethods.returns_from(node)
end

#string_ranges(node) ⇒ Array<Range>

Parameters:

  • node (Parser::AST::Node)

Returns:



139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 139

def string_ranges node
  return [] unless is_ast_node?(node)
  result = []
  if node.type == :str
    result.push Range.from_node(node)
  end
  node.children.each do |child|
    result.concat string_ranges(child)
  end
  if node.type == :dstr && node.children.last.nil?
    last = node.children[-2]
    unless last.nil?
      rng = Range.from_node(last)
      pos = Position.new(rng.ending.line, rng.ending.column - 1)
      result.push Range.new(pos, pos)
    end
  end
  result
end

#version ⇒ void

This method returns an undefined value.



119
120
121
 
# File 'lib/solargraph/parser/parser_gem/class_methods.rb', line 119

def version
  parser.version
end