Module: Ast::Merge::Comment

Defined in:

lib/ast/merge/comment.rb,
lib/ast/merge/comment/line.rb,
lib/ast/merge/comment/block.rb,
lib/ast/merge/comment/empty.rb,
lib/ast/merge/comment/style.rb,
lib/ast/merge/comment/parser.rb

Overview

Comment AST nodes for representing comment-only content.

This module provides generic, language-agnostic comment representation
that supports multiple comment syntax styles:

• :hash_comment - Ruby/Python/YAML/Shell style (# comment)
• :html_comment - HTML/XML/Markdown style (<!-- comment -->)
• :c_style_line - C/JavaScript/Go line comments (// comment)
• :c_style_block - C/JavaScript/CSS block comments (/* comment */)
• :semicolon_comment - Lisp/Clojure/Assembly style (; comment)
• :double_dash_comment - SQL/Haskell/Lua style (-- comment)

Examples:

Parsing Ruby-style comments

lines = ["# frozen_string_literal: true", "", "# Main comment"]
nodes = Comment::Parser.parse(lines, style: :hash_comment)

Parsing JavaScript-style comments

lines = ["// Header comment", "// continues here"]
nodes = Comment::Parser.parse(lines, style: :c_style_line)

Auto-detecting style

lines = ["<!-- HTML comment -->"]
nodes = Comment::Parser.parse(lines, style: :auto)

Defined Under Namespace

Classes: Block, Empty, Line, Parser, Style