2017-10-26 17:47:42 +00:00
|
|
|
module Ameba
|
2017-10-30 20:00:01 +00:00
|
|
|
# An entity that represents a Crystal source file.
|
2018-06-10 21:15:12 +00:00
|
|
|
# Has path, lines of code and issues reported by rules.
|
2017-10-26 17:47:42 +00:00
|
|
|
class Source
|
2018-01-29 22:25:36 +00:00
|
|
|
include InlineComments
|
2018-06-10 21:15:12 +00:00
|
|
|
include Reportable
|
2017-10-26 21:01:23 +00:00
|
|
|
|
2017-11-15 18:49:09 +00:00
|
|
|
# Path to the source file.
|
2017-12-18 11:06:19 +00:00
|
|
|
getter path : String
|
2017-11-15 18:49:09 +00:00
|
|
|
|
|
|
|
# Crystal code (content of a source file).
|
2017-11-07 20:02:51 +00:00
|
|
|
getter code : String
|
2017-10-26 17:47:42 +00:00
|
|
|
|
2017-11-15 18:49:09 +00:00
|
|
|
@lines : Array(String)?
|
|
|
|
@ast : Crystal::ASTNode?
|
2017-12-18 11:06:19 +00:00
|
|
|
@fullpath : String?
|
2017-11-15 18:49:09 +00:00
|
|
|
|
|
|
|
# Creates a new source by `code` and `path`.
|
|
|
|
#
|
|
|
|
# For example:
|
|
|
|
#
|
|
|
|
# ```
|
|
|
|
# path = "./src/source.cr"
|
|
|
|
# Ameba::Source.new File.read(path), path
|
|
|
|
# ```
|
|
|
|
#
|
2017-12-18 11:06:19 +00:00
|
|
|
def initialize(@code : String, @path = "")
|
2017-10-30 20:00:01 +00:00
|
|
|
end
|
|
|
|
|
2017-11-15 18:49:09 +00:00
|
|
|
# Returns lines of code splitted by new line character.
|
|
|
|
# Since `code` is immutable and can't be changed, this
|
|
|
|
# method caches lines in an instance variable, so calling
|
|
|
|
# it second time will not perform a split, but will return
|
|
|
|
# lines instantly.
|
|
|
|
#
|
|
|
|
# ```
|
|
|
|
# source = Ameba::Source.new "a = 1\nb = 2", path
|
|
|
|
# source.lines # => ["a = 1", "b = 2"]
|
|
|
|
# ```
|
|
|
|
#
|
2017-10-31 22:47:29 +00:00
|
|
|
def lines
|
2017-11-07 20:02:51 +00:00
|
|
|
@lines ||= @code.split("\n")
|
2017-10-31 22:47:29 +00:00
|
|
|
end
|
2017-11-06 18:54:58 +00:00
|
|
|
|
2017-11-15 18:49:09 +00:00
|
|
|
# Returns AST nodes constructed by `Crystal::Parser`.
|
|
|
|
#
|
|
|
|
# ```
|
|
|
|
# source = Ameba::Source.new code, path
|
|
|
|
# source.ast
|
|
|
|
# ```
|
|
|
|
#
|
2017-11-06 18:54:58 +00:00
|
|
|
def ast
|
|
|
|
@ast ||=
|
2017-11-07 20:02:51 +00:00
|
|
|
Crystal::Parser.new(code)
|
2019-07-22 13:23:59 +00:00
|
|
|
.tap { |parser| parser.wants_doc = true }
|
2018-09-02 21:17:56 +00:00
|
|
|
.tap { |parser| parser.filename = @path }
|
|
|
|
.parse
|
2017-11-06 18:54:58 +00:00
|
|
|
end
|
2017-11-07 20:02:51 +00:00
|
|
|
|
2017-12-18 11:06:19 +00:00
|
|
|
def fullpath
|
|
|
|
@fullpath ||= File.expand_path @path
|
|
|
|
end
|
2018-05-29 10:19:00 +00:00
|
|
|
|
|
|
|
# Returns true if *filepath* matches the source's path, false if it does not.
|
|
|
|
def matches_path?(filepath)
|
|
|
|
path == filepath || path == File.expand_path(filepath)
|
|
|
|
end
|
2017-10-26 17:47:42 +00:00
|
|
|
end
|
|
|
|
end
|