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] << 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.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
		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