Class: Rbs::Merge::MergeResult

Inherits:
Ast::Merge::MergeResultBase
  • Object
show all
Defined in:
lib/rbs/merge/merge_result.rb

Overview

Result container for RBS file merge operations.
Inherits from Ast::Merge::MergeResultBase for shared functionality.

Tracks merged content, decisions made during merge, and provides
methods to reconstruct the final merged RBS file.

Examples:

Basic usage

result = MergeResult.new(template_analysis, dest_analysis)
result.add_from_template(0)
result.add_from_destination(1)
merged_content = result.to_s

See Also:

  • Ast::Merge::MergeResultBase

Constant Summary collapse

DECISION_FREEZE_BLOCK =

Decision indicating content was preserved from a freeze block

Returns:

  • (Symbol) 
:freeze_block
DECISION_TEMPLATE =

Decision indicating content came from the template

Returns:

  • (Symbol) 
:template
DECISION_DESTINATION =

Decision indicating content came from the destination (customization preserved)

Returns:

  • (Symbol) 
:destination
DECISION_ADDED =

Decision indicating content was added from template (new in template)

Returns:

  • (Symbol) 
:added
DECISION_RECURSIVE =

Decision indicating content was recursively merged

Returns:

  • (Symbol) 
:recursive

Instance Method Summary collapse

Constructor Details

#initialize(template_analysis, dest_analysis, **options) ⇒ MergeResult

Initialize a new merge result

Parameters:

  • template_analysis (FileAnalysis) —

    Analysis of the template file

  • dest_analysis (FileAnalysis) —

    Analysis of the destination file

  • options (Hash) —

    Additional options for forward compatibility



43
44
45
46
 
# File 'lib/rbs/merge/merge_result.rb', line 43

def initialize(template_analysis, dest_analysis, **options)
  super(template_analysis: template_analysis, dest_analysis: dest_analysis, **options)
  @emitted_freeze_blocks = {}
end

Instance Method Details

#add_freeze_block(freeze_node) ⇒ void

This method returns an undefined value.

Add content from a freeze block

Parameters:

  • freeze_node (FreezeNode) —

    The freeze block to add



87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
 
# File 'lib/rbs/merge/merge_result.rb', line 87

def add_freeze_block(freeze_node)
  # Use the freeze_node's own analysis to get the correct content
  # (template freeze blocks should use template lines, dest freeze blocks use dest lines)
  source_analysis = freeze_node.analysis
  freeze_key = [source_analysis.object_id, freeze_node.start_line, freeze_node.end_line]
  return if @emitted_freeze_blocks[freeze_key]

  lines = extract_lines(freeze_node, source_analysis)
  @lines.concat(lines)
  @emitted_freeze_blocks[freeze_key] = true

  # Determine source based on which analysis the freeze_node belongs to
  source = (source_analysis == @template_analysis) ? :template : :destination

  @decisions << {
    decision: DECISION_FREEZE_BLOCK,
    source: source,
    start_line: freeze_node.start_line,
    end_line: freeze_node.end_line,
    lines: lines.length,
  }
end

#add_from_destination(index, decision: DECISION_DESTINATION, comment_source_statement: nil, comment_source_analysis: nil) ⇒ void

This method returns an undefined value.

Add content from the destination at the given statement index

Parameters:

  • index (Integer) —

    Statement index in destination

  • decision (Symbol) (defaults to: DECISION_DESTINATION) —

    Decision type (default: DECISION_DESTINATION)



70
71
72
73
74
75
76
77
78
79
80
81
82
 
# File 'lib/rbs/merge/merge_result.rb', line 70

def add_from_destination(index, decision: DECISION_DESTINATION, comment_source_statement: nil, comment_source_analysis: nil)
  statement = @dest_analysis.statements[index]
  return unless statement

  lines = extract_lines(
    statement,
    @dest_analysis,
    comment_source_statement: comment_source_statement,
    comment_source_analysis: comment_source_analysis,
  )
  @lines.concat(lines)
  @decisions << {decision: decision, source: :destination, index: index, lines: lines.length}
end

#add_from_template(index, decision: DECISION_TEMPLATE, comment_source_statement: nil, comment_source_analysis: nil) ⇒ void

This method returns an undefined value.

Add content from the template at the given statement index

Parameters:

  • index (Integer) —

    Statement index in template

  • decision (Symbol) (defaults to: DECISION_TEMPLATE) —

    Decision type (default: DECISION_TEMPLATE)



52
53
54
55
56
57
58
59
60
61
62
63
64
 
# File 'lib/rbs/merge/merge_result.rb', line 52

def add_from_template(index, decision: DECISION_TEMPLATE, comment_source_statement: nil, comment_source_analysis: nil)
  statement = @template_analysis.statements[index]
  return unless statement

  lines = extract_lines(
    statement,
    @template_analysis,
    comment_source_statement: comment_source_statement,
    comment_source_analysis: comment_source_analysis,
  )
  @lines.concat(lines)
  @decisions << {decision: decision, source: :template, index: index, lines: lines.length}
end

#add_raw(lines, decision:) ⇒ void

This method returns an undefined value.

Add raw content lines

Parameters:

  • lines (Array<String>) —

    Lines to add

  • decision (Symbol) —

    Decision type



134
135
136
137
 
# File 'lib/rbs/merge/merge_result.rb', line 134

def add_raw(lines, decision:)
  @lines.concat(lines)
  @decisions << {decision: decision, source: :raw, lines: lines.length}
end

#add_recursive_merge(merged_content, template_index:, dest_index:) ⇒ void

This method returns an undefined value.

Add recursively merged content

Parameters:

  • merged_content (String) —

    The merged content string

  • template_index (Integer) —

    Template statement index

  • dest_index (Integer) —

    Destination statement index



115
116
117
118
119
120
121
122
123
124
125
126
127
128
 
# File 'lib/rbs/merge/merge_result.rb', line 115

def add_recursive_merge(merged_content, template_index:, dest_index:)
  # Split without trailing newlines for consistency with other methods
  lines = merged_content.split("\n", -1)
  # Remove trailing empty element if content ended with newline
  lines.pop if lines.last == ""
  @lines.concat(lines)
  @decisions << {
    decision: DECISION_RECURSIVE,
    source: :merged,
    template_index: template_index,
    dest_index: dest_index,
    lines: lines.length,
  }
end

#empty? ⇒ Boolean

Check if any content has been added

Returns:

  • (Boolean) 


153
154
155
 
# File 'lib/rbs/merge/merge_result.rb', line 153

def empty?
  @lines.empty?
end

#summary ⇒ Hash

Get summary of merge decisions

Returns:

  • (Hash) —

    Summary with counts by decision type



159
160
161
162
163
164
165
166
 
# File 'lib/rbs/merge/merge_result.rb', line 159

def summary
  counts = @decisions.group_by { |d| d[:decision] }.transform_values(&:count)
  {
    total_decisions: @decisions.length,
    total_lines: @lines.length,
    by_decision: counts,
  }
end

#to_s ⇒ String

Convert the merged result to a string

Returns:

  • (String) —

    The merged RBS content



141
142
143
144
145
146
147
148
149
 
# File 'lib/rbs/merge/merge_result.rb', line 141

def to_s
  return "" if @lines.empty?

  # Lines are stored without trailing newlines, so join with newlines
  result = @lines.join("\n")
  # Ensure file ends with newline if content is non-empty
  result += "\n" unless result.end_with?("\n")
  result
end