Class: Eggshell::ParseTree

Inherits:
Object
  • Object
show all
Defined in:
lib/eggshell/parse-tree.rb

Overview

Holds a hierarchical collection of blocks and macros. The tree follows this structure:

pre. [ String*, [:block, ‘block_name’, [], line_start]* # last entry is array of Eggshell::Line, [:macro, ‘macro_name’, {}, [ __repeat_of_parse_tree ] ], line_start* ]

Constant Summary collapse

BH = 
Eggshell::BlockHandler
MH = 
Eggshell::MacroHandler
IDX_TYPE = 
0
IDX_NAME = 
1
IDX_ARGS = 
2
IDX_LINES = 
3
IDX_LINES_START = 
4
IDX_LINES_END = 
5

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ ParseTree

Returns a new instance of ParseTree.



23
24
25
26
27
28
29
30
31
32
 
# File 'lib/eggshell/parse-tree.rb', line 23

def initialize
  #@eggshell = eggshell
  @modes = [:nil]
  @tree = []
  @lines = []
  @macro_delims = []
  @macro_open = []
  @macro_ptr = []
  @ptr = @tree
end

Class Method Details

.condense(processor, units) ⇒ Object

Groups together chained macros. This ensures proper block-chain flow. Note that a related sequence is grouped within a {pipe} macro.



163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
 
# File 'lib/eggshell/parse-tree.rb', line 163

def self.condense(processor, units)
  condensed  = []

  last_macro = nil
  units.each do |unit|
    if !unit.is_a?(Array) || unit[0] == :block
      condensed << unit
    else
      mhandler = processor.get_macro_handler(unit[1])
      chain_type = nil
      chain_macro = nil
      chain_type, chain_macro = mhandler.chain_type(unit[1]) if mhandler
      if chain_type != MH::CHAIN_NONE
        if chain_type == MH::CHAIN_START
          unit[3] = condense(processor, unit[3])
          condensed << [:macro, 'pipe', [{'chained'=>chain_macro}], [unit], unit[4], -1]
          last_macro = unit[1]
        elsif chain_type == MH::CHAIN_CONTINUE && chain_macro == last_macro
          unit[3] = condense(processor, unit[3])
          condensed[-1][3] << unit
        elsif chain_type == MH::CHAIN_END && chain_macro == last_macro
          unit[3] = condense(processor, unit[3])
          condensed[-1][3] << unit
          condensed[-1][5] = unit[5]
          last_macro = nil
        else
          condensed << unit
          last_macro = nil
        end
      else
        condensed << unit
      end
    end
  end

  condensed
end

.walk(struct = nil, indent = 0, out = nil) ⇒ Object

Does basic output of parse tree structure to visually inspect parsed info.



142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
 
# File 'lib/eggshell/parse-tree.rb', line 142

def self.walk(struct = nil, indent = 0, out = nil)
  out = $stdout if !out
  struct.each do |row|
    if row.is_a?(Eggshell::Line)
      out.write "#{'  '*indent}#{row.to_s.inspect} ##{row.line_num}\n"
    elsif row.is_a?(Array)
      if row[0] == :macro
        out.write "#{'  '*indent}@#{row[1]}(#{row[2].inspect}) | end=#{row[-1]}\n"
        walk(row[3], indent + 1, out)
      elsif row[0] == :block
        out.write "#{'  '*indent}#{row[1]}(#{row[2].inspect}) | end=#{row[-1]}\n"
        walk(row[3], indent + 1, out)
      end
    else
      out.write "#{'  '*indent}#{row.inspect} ?\n"
    end
  end
end

Instance Method Details

#collect(line_obj) ⇒ Object 



106
107
108
109
110
111
112
113
114
115
116
117
 
# File 'lib/eggshell/parse-tree.rb', line 106

def collect(line_obj)
  more = @cur_block[0].continue_with(line_obj.line)
  if more != BH::RETRY
    @lines << line_obj
    if more == BH::DONE
      push_block
    end
  else
    push_block
  end
  more
end

#collect_macro_raw(line_obj) ⇒ Object 



119
120
121
 
# File 'lib/eggshell/parse-tree.rb', line 119

def collect_macro_raw(line_obj)
  @ptr << line_obj
end

#collect_mode ⇒ Object 



137
138
139
 
# File 'lib/eggshell/parse-tree.rb', line 137

def collect_mode
  @collect_modes[-1]
end

#macro_delim_match(line_obj, line_num) ⇒ Object 



54
55
56
57
58
59
60
61
62
63
64
65
66
67
 
# File 'lib/eggshell/parse-tree.rb', line 54

def macro_delim_match(line_obj, line_num)
  if @macro_delims[-1] == line_obj.line
    if @modes[-1] == :block
      push_block
    end
    @macro_delims.pop
    @macro_open.pop
    @ptr = @macro_ptr.pop
    @ptr[-1][-1] = line_num
    last_mode = @modes.pop
    return true
  end
  return false
end

#mode ⇒ Object 



133
134
135
 
# File 'lib/eggshell/parse-tree.rb', line 133

def mode
  @modes[-1]
end

#new_block(handler, type, line_obj, consume_mode, line_start, eggshell) ⇒ Object 



69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
 
# File 'lib/eggshell/parse-tree.rb', line 69

def new_block(handler, type, line_obj, consume_mode, line_start, eggshell)
  block_type, args, line = eggshell.parse_block_start(line_obj.line)
  nline = Eggshell::Line.new(line, line_obj.tab_str, line_obj.indent_lvl, line_obj.line_num)

  if consume_mode != BH::DONE
    #@modes << :block
    if line != ''
      @lines << nline
      line_start -= 1
    end
    @cur_block = [handler, type, args, line_start]
    if consume_mode == BH::COLLECT_RAW
      #mode = :raw
      @modes << :raw
    else consume_mode == BH::COLLECT
      #mode = :block
      @modes << :block
    end
  else
    @ptr << [:block, type, args, [nline], line_start, line_start]
  end
end

#new_macro(line_obj, line_start, macro, args, delim, mode) ⇒ Object 



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
# File 'lib/eggshell/parse-tree.rb', line 34

def new_macro(line_obj, line_start, macro, args, delim, mode)
  line = line_obj.line
  #macro, args, delim = Eggshell::Processor.parse_macro_start(line)

  push_block

  if delim
    @modes << (mode == MH::COLLECT_RAW_MACRO ? :macro_raw : macro)
    @macro_delims << delim #delim.reverse.gsub('[', ']').gsub('(', ')').gsub('{', '}')
    @macro_open << line
    @macro_ptr << @ptr
    # set ptr to entry's tree
    entry = [:macro, macro, args, [], line_start, line_start]
    @ptr << entry
    @ptr = entry[IDX_LINES]
  else
    @ptr << [:macro, macro, args, [], line_start, line_start]
  end
end

#push_block ⇒ Object 



92
93
94
95
96
97
98
99
100
101
102
103
104
 
# File 'lib/eggshell/parse-tree.rb', line 92

def push_block
  if @modes[-1] == :block || @modes[-1] == :raw
    if @cur_block
      line_end = @cur_block[3]
      line_end = @lines[-1].line_num if @lines[-1]
      @ptr << [:block, @cur_block[1], @cur_block[2], @lines, @cur_block[3], line_end]
      @lines = []
      @cur_block[0].reset
      @cur_block = nil
    end
    @modes.pop
  end
end

#raw_line(line_obj) ⇒ Object 



123
124
125
 
# File 'lib/eggshell/parse-tree.rb', line 123

def raw_line(line_obj)
  @ptr << line_obj
end

#tree ⇒ Object 



127
128
129
 
# File 'lib/eggshell/parse-tree.rb', line 127

def tree
  @tree.clone
end