Class: Parser::Source::Comment
- Inherits:
-
Object
- Object
- Parser::Source::Comment
- Defined in:
- lib/parser/source/comment.rb
Overview
A comment in the source code.
Defined Under Namespace
Classes: Associator
Instance Attribute Summary collapse
- #location ⇒ Parser::Source::Map (also: #loc) readonly
- #text ⇒ String readonly
Class Method Summary collapse
-
.associate(ast, comments) ⇒ Hash(Parser::AST::Node, Array(Comment))
Associate
comments
withast
nodes by their location in the source.
Instance Method Summary collapse
-
#==(other) ⇒ Boolean
Compares comments.
-
#document? ⇒ Boolean
True if this is a block comment.
-
#initialize(range) ⇒ Comment
constructor
A new instance of Comment.
-
#inline? ⇒ Boolean
True if this is an inline comment.
-
#inspect ⇒ String
A human-readable representation of this comment.
-
#type ⇒ Symbol
Type of this comment.
Constructor Details
Instance Attribute Details
#location ⇒ Parser::Source::Map (readonly) Also known as: loc
15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 |
# File 'lib/parser/source/comment.rb', line 15 class Comment attr_reader :text attr_reader :location alias_method :loc, :location ## # Associate `comments` with `ast` nodes by their location in the # source. # # @param [Parser::AST::Node] ast # @param [Array(Comment)] comments # @return [Hash(Parser::AST::Node, Array(Comment))] # @see Parser::Source::Comment::Associator # def self.associate(ast, comments) associator = Associator.new(ast, comments) associator.associate end ## # @param [Parser::Source::Range] range # def initialize(range) @location = Parser::Source::Map.new(range) @text = range.source.freeze freeze end ## # Type of this comment. # # * Inline comments correspond to `:inline`: # # # whatever # # * Block comments correspond to `:document`: # # =begin # hi i am a document # =end # # @return [Symbol] # def type case text when /^#/ :inline when /^=begin/ :document end end ## # @see #type # @return [Boolean] true if this is an inline comment. # def inline? type == :inline end ## # @see #type # @return [Boolean] true if this is a block comment. # def document? type == :document end ## # Compares comments. Two comments are equal if they # correspond to the same source range. # # @param [Object] other # @return [Boolean] # def ==(other) other.is_a?(Source::Comment) && @location == other.location end ## # @return [String] a human-readable representation of this comment # def inspect "#<Parser::Source::Comment #{@location.expression.to_s} #{text.inspect}>" end end |
#text ⇒ String (readonly)
15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 |
# File 'lib/parser/source/comment.rb', line 15 class Comment attr_reader :text attr_reader :location alias_method :loc, :location ## # Associate `comments` with `ast` nodes by their location in the # source. # # @param [Parser::AST::Node] ast # @param [Array(Comment)] comments # @return [Hash(Parser::AST::Node, Array(Comment))] # @see Parser::Source::Comment::Associator # def self.associate(ast, comments) associator = Associator.new(ast, comments) associator.associate end ## # @param [Parser::Source::Range] range # def initialize(range) @location = Parser::Source::Map.new(range) @text = range.source.freeze freeze end ## # Type of this comment. # # * Inline comments correspond to `:inline`: # # # whatever # # * Block comments correspond to `:document`: # # =begin # hi i am a document # =end # # @return [Symbol] # def type case text when /^#/ :inline when /^=begin/ :document end end ## # @see #type # @return [Boolean] true if this is an inline comment. # def inline? type == :inline end ## # @see #type # @return [Boolean] true if this is a block comment. # def document? type == :document end ## # Compares comments. Two comments are equal if they # correspond to the same source range. # # @param [Object] other # @return [Boolean] # def ==(other) other.is_a?(Source::Comment) && @location == other.location end ## # @return [String] a human-readable representation of this comment # def inspect "#<Parser::Source::Comment #{@location.expression.to_s} #{text.inspect}>" end end |
Class Method Details
.associate(ast, comments) ⇒ Hash(Parser::AST::Node, Array(Comment))
Associate comments
with ast
nodes by their location in the
source.
30 31 32 33 |
# File 'lib/parser/source/comment.rb', line 30 def self.associate(ast, comments) associator = Associator.new(ast, comments) associator.associate end |
Instance Method Details
#==(other) ⇒ Boolean
Compares comments. Two comments are equal if they correspond to the same source range.
92 93 94 95 |
# File 'lib/parser/source/comment.rb', line 92 def ==(other) other.is_a?(Source::Comment) && @location == other.location end |
#document? ⇒ Boolean
Returns true if this is a block comment.
81 82 83 |
# File 'lib/parser/source/comment.rb', line 81 def document? type == :document end |
#inline? ⇒ Boolean
Returns true if this is an inline comment.
73 74 75 |
# File 'lib/parser/source/comment.rb', line 73 def inline? type == :inline end |
#inspect ⇒ String
Returns a human-readable representation of this comment.
100 101 102 |
# File 'lib/parser/source/comment.rb', line 100 def inspect "#<Parser::Source::Comment #{@location.expression.to_s} #{text.inspect}>" end |
#type ⇒ Symbol
Type of this comment.
Inline comments correspond to
:inline
:# whatever
Block comments correspond to
:document
:=begin hi i am a document =end
60 61 62 63 64 65 66 67 |
# File 'lib/parser/source/comment.rb', line 60 def type case text when /^#/ :inline when /^=begin/ :document end end |