Class: Solargraph::SourceMap::Mapper

Inherits:
Object
  • Object
show all
Defined in:
lib/solargraph/source_map/mapper.rb

Overview

The Mapper generates pins and other data for SourceMaps.

This class is used internally by the SourceMap class. Users should not normally need to call it directly.

Constant Summary collapse

MACRO_REGEXP = 
/(@\!method|@\!attribute|@\!domain|@\!macro|@\!parse|@\!override)/.freeze

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.map(source) ⇒ Array

Parameters:

Returns:



48
49
50
51
 
# File 'lib/solargraph/source_map/mapper.rb', line 48

def map source
  return new.unmap(source.filename, source.code) unless source.parsed?
  new.map source
end

Instance Method Details

#closure_at(position) ⇒ Object 



59
60
61
 
# File 'lib/solargraph/source_map/mapper.rb', line 59

def closure_at(position)
  @pins.select{|pin| pin.is_a?(Pin::Closure) and pin.location.range.contain?(position)}.last
end

#find_directive_line_number(comment, tag, start) ⇒ Integer

Parameters:

  • comment (String)

Returns:

  • (Integer) 


84
85
86
87
88
89
90
91
92
93
 
# File 'lib/solargraph/source_map/mapper.rb', line 84

def find_directive_line_number comment, tag, start
  # Avoid overruning the index
  return start unless start < comment.lines.length
  num = comment.lines[start..-1].find_index do |line|
    # Legacy method directives might be `@method` instead of `@!method`
    # @todo Legacy syntax should probably emit a warning
    line.include?("@!#{tag}") || (tag == 'method' && line.include?("@#{tag}"))
  end
  num.to_i + start
end

#map(source) ⇒ Array

Generate the data.

Parameters:

Returns:



21
22
23
24
25
26
27
28
29
30
31
32
33
 
# File 'lib/solargraph/source_map/mapper.rb', line 21

def map source
  @source = source
  @filename = source.filename
  @code = source.code
  @comments = source.comments
  @pins, @locals = Parser.map(source)
  process_comment_directives
  [@pins, @locals]
# rescue Exception => e
#   Solargraph.logger.warn "Error mapping #{source.filename}: [#{e.class}] #{e.message}"
#   Solargraph.logger.warn e.backtrace.join("\n")
#   [[], []]
end

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

Returns:



55
56
57
 
# File 'lib/solargraph/source_map/mapper.rb', line 55

def pins
  @pins ||= []
end

#process_comment(source_position, comment_position, comment) ⇒ Object 



63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
 
# File 'lib/solargraph/source_map/mapper.rb', line 63

def process_comment source_position, comment_position, comment
  return unless comment =~ MACRO_REGEXP
  cmnt = remove_inline_comment_hashes(comment)
  parse = Solargraph::Source.parse_docstring(cmnt)
  last_line = 0
  # @param d [YARD::Tags::Directive]
  parse.directives.each do |d|
    line_num = find_directive_line_number(cmnt, d.tag.tag_name, last_line)
    pos = Solargraph::Position.new(comment_position.line + line_num - 1, comment_position.column)
    process_directive(source_position, pos, d)
    last_line = line_num + 1
    # @todo The below call assumes the topmost comment line. The above
    #   process occasionally emits incorrect comment positions due to
    #   blank lines in comment blocks, but at least it processes all the
    #   directives.
    # process_directive(source_position, comment_position, d)
  end
end

#process_comment_directives ⇒ void

This method returns an undefined value.



204
205
206
207
208
209
210
211
212
 
# File 'lib/solargraph/source_map/mapper.rb', line 204

def process_comment_directives
  return unless @code =~ MACRO_REGEXP
  code_lines = @code.lines
  @source.associated_comments.each do |line, comments|
    src_pos = line ? Position.new(line, code_lines[line].to_s.chomp.index(/[^\s]/) || 0) : Position.new(code_lines.length, 0)
    com_pos = Position.new(line + 1 - comments.lines.length, 0)
    process_comment(src_pos, com_pos, comments)
  end
end

#process_directive(source_position, comment_position, directive) ⇒ void

This method returns an undefined value.

Parameters:

  • source_position (Position)
  • comment_position (Position)
  • directive (YARD::Tags::Directive) 


99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
 
# File 'lib/solargraph/source_map/mapper.rb', line 99

def process_directive source_position, comment_position, directive
  docstring = Solargraph::Source.parse_docstring(directive.tag.text).to_docstring
  location = Location.new(@filename, Range.new(comment_position, comment_position))
  case directive.tag.tag_name
  when 'method'
    namespace = closure_at(source_position) || @pins.first
    if namespace.location.range.start.line < comment_position.line
      namespace = closure_at(comment_position)
    end
    begin
      src = Solargraph::Source.load_string("def #{directive.tag.name};end", @source.filename)
      region = Parser::Region.new(source: src, closure: namespace)
      gen_pin = Parser.process_node(src.node, region).first.last
      return if gen_pin.nil?
      # Move the location to the end of the line so it gets recognized
      # as originating from a comment
      shifted = Solargraph::Position.new(comment_position.line, @code.lines[comment_position.line].to_s.chomp.length)
      # @todo: Smelly instance variable access
      gen_pin.instance_variable_set(:@comments, docstring.all.to_s)
      gen_pin.instance_variable_set(:@location, Solargraph::Location.new(@filename, Range.new(shifted, shifted)))
      gen_pin.instance_variable_set(:@explicit, false)
      @pins.push gen_pin
    rescue Parser::SyntaxError => e
      # @todo Handle error in directive
    end
  when 'attribute'
    return if directive.tag.name.nil?
    namespace = closure_at(source_position)
    t = (directive.tag.types.nil? || directive.tag.types.empty?) ? nil : directive.tag.types.flatten.join('')
    if t.nil? || t.include?('r')
      pins.push Solargraph::Pin::Method.new(
        location: location,
        closure: namespace,
        name: directive.tag.name,
        comments: docstring.all.to_s,
        scope: namespace.is_a?(Pin::Singleton) ? :class : :instance,
        visibility: :public,
        explicit: false,
        attribute: true
      )
    end
    if t.nil? || t.include?('w')
      pins.push Solargraph::Pin::Method.new(
        location: location,
        closure: namespace,
        name: "#{directive.tag.name}=",
        comments: docstring.all.to_s,
        scope: namespace.is_a?(Pin::Singleton) ? :class : :instance,
        visibility: :public,
        attribute: true
      )
      pins.last.parameters.push Pin::Parameter.new(name: 'value', decl: :arg, closure: pins.last)
      if pins.last.return_type.defined?
        pins.last.docstring.add_tag YARD::Tags::Tag.new(:param, '', pins.last.return_type.to_s.split(', '), 'value')
      end
    end
  when 'parse'
    begin
      ns = closure_at(source_position)
      src = Solargraph::Source.load_string(directive.tag.text, @source.filename)
      region = Parser::Region.new(source: src, closure: ns)
      # @todo These pins may need to be marked not explicit
      index = @pins.length
      loff = if @code.lines[comment_position.line].strip.end_with?('@!parse')
        comment_position.line + 1
      else
        comment_position.line
      end
      Parser.process_node(src.node, region, @pins)
      @pins[index..-1].each do |p|
        # @todo Smelly instance variable access
        p.location.range.start.instance_variable_set(:@line, p.location.range.start.line + loff)
        p.location.range.ending.instance_variable_set(:@line, p.location.range.ending.line + loff)
      end
    rescue Parser::SyntaxError => e
      # @todo Handle parser errors in !parse directives
    end
  when 'domain'
    namespace = closure_at(source_position)
    namespace.domains.concat directive.tag.types unless directive.tag.types.nil?
  when 'override'
    pins.push Pin::Reference::Override.new(location, directive.tag.name, docstring.tags)
  end
end

#remove_inline_comment_hashes(comment) ⇒ Object 



184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
 
# File 'lib/solargraph/source_map/mapper.rb', line 184

def remove_inline_comment_hashes comment
  ctxt = ''
  num = nil
  started = false
  comment.lines.each { |l|
    # Trim the comment and minimum leading whitespace
    p = l.gsub(/^#/, '')
    if num.nil? && !p.strip.empty?
      num = p.index(/[^ ]/)
      started = true
    elsif started && !p.strip.empty?
      cur = p.index(/[^ ]/)
      num = cur if cur < num
    end
    ctxt += "#{p[num..-1]}" if started
  }
  ctxt
end

#unmap(filename, code) ⇒ Array

Parameters:

  • filename (String)
  • code (String)

Returns:



38
39
40
41
42
43
 
# File 'lib/solargraph/source_map/mapper.rb', line 38

def unmap filename, code
  s = Position.new(0, 0)
  e = Position.from_offset(code, code.length)
  location = Location.new(filename, Range.new(s, e))
  [[Pin::Namespace.new(location: location, name: '')], []]
end