Class: Rubinius::AST::Node
- Inherits:
-
Object
- Object
- Rubinius::AST::Node
- Defined in:
- lib/compiler/ast/node.rb
Direct Known Subclasses
ActualArguments, Alias, And, ArrayLiteral, BackRef, Begin, Block, BlockArgument, BlockPass, Break, Case, Class, ClassName, ClosedScope, CollectSplat, ConcatArgs, ConstantAccess, ConstantAssignment, CurrentException, DefaultArguments, DefineSingleton, Defined, EmptyArray, EmptyBody, EmptySplat, Encoding, EndData, Ensure, FalseLiteral, File, Flip2, FloatLiteral, For19Arguments, FormalArguments, HashLiteral, If, Iter, IterArguments, Match, Match2, Match3, Module, ModuleName, MultipleAssignment, Negate, NilLiteral, Not, NthRef, NumberLiteral, OpAssign1, OpAssign2, OpAssignAnd, PatternArguments, PatternVariable, PostArg, PreExe, PushArgs, Range, RegexLiteral, Rescue, RescueCondition, RescueSplat, Return, SClass, SValue, ScopedConstant, Self, Send, SplatAssignment, SplatValue, SplatWhen, StringLiteral, SymbolLiteral, ToArray, ToString, ToplevelConstant, TrueLiteral, TypeConstant, Undef, VariableAccess, VariableAssignment, When, While
Defined Under Namespace
Classes: TransformState
Instance Attribute Summary collapse
-
#line ⇒ Object
Returns the value of attribute line.
Class Method Summary collapse
- .match_arguments?(arguments, count) ⇒ Boolean
- .match_send?(node, receiver, method, name) ⇒ Boolean
-
.node_name ⇒ Object
The equivalent of Some::Module.demodulize.underscore in ActiveSupport.
- .transform(category, name, comment) ⇒ Object
- .transform_comment ⇒ Object
- .transform_kind ⇒ Object
- .transform_kind=(k) ⇒ Object
- .transform_name ⇒ Object
Instance Method Summary collapse
- #ascii_graph ⇒ Object
-
#attributes ⇒ Object
Yields each attribute and its name to the block.
-
#children ⇒ Object
Yields each child of this Node to the block.
-
#initialize(line) ⇒ Node
constructor
A new instance of Node.
- #new_block_generator(g, arguments) ⇒ Object
- #new_generator(g, name, arguments = nil) ⇒ Object
- #node_name ⇒ Object
- #pos(g) ⇒ Object
-
#set_child(name, node) ⇒ Object
Called by #transform to update the child of a Node instance.
- #to_sexp ⇒ Object
-
#transform(visitor, parent = nil, state = nil) ⇒ Object
A fixed-point algorithm for transforming an AST with a visitor.
-
#visit(visitor, parent = nil) ⇒ Object
Supports the Visitor pattern on a tree of Nodes.
-
#walk(arg = true, &block) ⇒ Object
This method implements a sort of tree iterator, yielding each Node instance to the provided block with the first argument to #walk.
Constructor Details
#initialize(line) ⇒ Node
Returns a new instance of Node.
48 49 50 |
# File 'lib/compiler/ast/node.rb', line 48 def initialize(line) @line = line end |
Instance Attribute Details
#line ⇒ Object
Returns the value of attribute line.
6 7 8 |
# File 'lib/compiler/ast/node.rb', line 6 def line @line end |
Class Method Details
.match_arguments?(arguments, count) ⇒ Boolean
37 38 39 40 41 42 43 44 45 46 |
# File 'lib/compiler/ast/node.rb', line 37 def self.match_arguments?(arguments, count) case arguments when ArrayLiteral arguments.body.size == count when nil count == 0 else false end end |
.match_send?(node, receiver, method, name) ⇒ Boolean
31 32 33 34 35 |
# File 'lib/compiler/ast/node.rb', line 31 def self.match_send?(node, receiver, method, name) node.kind_of? ConstantAccess and node.name == receiver and method == name end |
.node_name ⇒ Object
The equivalent of Some::Module.demodulize.underscore in ActiveSupport. The code is shamelessly borrowed as well.
120 121 122 123 124 125 126 127 128 129 |
# File 'lib/compiler/ast/node.rb', line 120 def self.node_name @node_name ||= begin name = self.name.gsub(/^.*::/, '') name.gsub!(/([A-Z]+)([A-Z][a-z])/,'\1_\2') name.gsub!(/([a-z\d])([A-Z])/,'\1_\2') name.downcase! name end end |
.transform(category, name, comment) ⇒ Object
8 9 10 11 12 13 |
# File 'lib/compiler/ast/node.rb', line 8 def self.transform(category, name, comment) Transforms.register category, name, self @transform_name = name @transform_comment = comment @transform_kind = :call end |
.transform_comment ⇒ Object
19 20 21 |
# File 'lib/compiler/ast/node.rb', line 19 def self.transform_comment @transform_comment end |
.transform_kind ⇒ Object
23 24 25 |
# File 'lib/compiler/ast/node.rb', line 23 def self.transform_kind @transform_kind end |
.transform_kind=(k) ⇒ Object
27 28 29 |
# File 'lib/compiler/ast/node.rb', line 27 def self.transform_kind=(k) @transform_kind = k end |
.transform_name ⇒ Object
15 16 17 |
# File 'lib/compiler/ast/node.rb', line 15 def self.transform_name @transform_name end |
Instance Method Details
#ascii_graph ⇒ Object
97 98 99 |
# File 'lib/compiler/ast/node.rb', line 97 def ascii_graph AsciiGrapher.new(self).print end |
#attributes ⇒ Object
Yields each attribute and its name to the block.
157 158 159 160 161 162 163 |
# File 'lib/compiler/ast/node.rb', line 157 def attributes instance_variables.each do |var| child = instance_variable_get var name = var.to_s[1..-1] yield child, name end end |
#children ⇒ Object
Yields each child of this Node to the block. Additionally, for any attribute that is an Array, yields each element that is a Node.
107 108 109 110 111 112 113 114 115 116 |
# File 'lib/compiler/ast/node.rb', line 107 def children instance_variables.each do |var| child = instance_variable_get var if child.kind_of? Node yield child elsif child.kind_of? Array child.each { |x| yield x if x.kind_of? Node } end end end |
#new_block_generator(g, arguments) ⇒ Object
56 57 58 59 60 61 62 63 64 65 66 67 |
# File 'lib/compiler/ast/node.rb', line 56 def new_block_generator(g, arguments) blk = g.class.new blk.name = g.state.name || :__block__ blk.file = g.file blk.for_block = true blk.required_args = arguments.required_args blk.post_args = arguments.post_args blk.total_args = arguments.total_args blk end |
#new_generator(g, name, arguments = nil) ⇒ Object
69 70 71 72 73 74 75 76 77 78 79 80 81 82 |
# File 'lib/compiler/ast/node.rb', line 69 def new_generator(g, name, arguments=nil) meth = g.class.new meth.name = name meth.file = g.file if arguments meth.required_args = arguments.required_args meth.post_args = arguments.post_args meth.total_args = arguments.total_args meth.splat_index = arguments.splat_index end meth end |
#node_name ⇒ Object
131 132 133 |
# File 'lib/compiler/ast/node.rb', line 131 def node_name self.class.node_name end |
#pos(g) ⇒ Object
52 53 54 |
# File 'lib/compiler/ast/node.rb', line 52 def pos(g) g.set_line @line end |
#set_child(name, node) ⇒ Object
Called by #transform to update the child of a Node instance. The default just calls the attr_accessor for the child. However, Node subclasses that must synchronize other internal state can override this method.
152 153 154 |
# File 'lib/compiler/ast/node.rb', line 152 def set_child(name, node) send :"#{name}=", node end |
#to_sexp ⇒ Object
101 102 103 |
# File 'lib/compiler/ast/node.rb', line 101 def to_sexp [:node, self.class.name] end |
#transform(visitor, parent = nil, state = nil) ⇒ Object
A fixed-point algorithm for transforming an AST with a visitor. The traversal is top-down. The visitor object’s method corresponding to each node (see #node_name) is called for each node, passing the node and its parent.
To replace the node in the tree, the visitor method should return a new node; otherwise, return the existing node. The visitor is free to change values in the node, but substituting a node causes the entire tree to be walked repeatedly until no modifications are made.
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 200 201 202 203 204 205 206 207 |
# File 'lib/compiler/ast/node.rb', line 174 def transform(visitor, parent=nil, state=nil) state ||= TransformState.new node = visitor.send :"node_#{node_name}", self, parent state.modify unless equal? node node.attributes do |attr, name| if attr.kind_of? Node child = attr.transform visitor, node, state unless attr.equal? child state.modify node.set_child name, child end elsif attr.kind_of? Array attr.each_with_index do |x, i| if x.kind_of? Node child = x.transform visitor, node, state unless x.equal? child state.modify attr[i] = child end end end end end # Repeat the walk until the tree is not modified. if parent.nil? and state.modified? state.unmodify node = transform visitor, nil, state end node end |
#visit(visitor, parent = nil) ⇒ Object
Supports the Visitor pattern on a tree of Nodes. The visitor
should be an object that responds to methods named after the Node subclasses. The method called is determined by the #node_name method. Passes both the node and its parent so that the visitor can maintain nesting information if desired.
The #visit implements a read-only traversal of the tree. To modify the tree, see the #transform methed.
143 144 145 146 |
# File 'lib/compiler/ast/node.rb', line 143 def visit(visitor, parent=nil) visitor.__send__ self.node_name, self, parent children { |c| c.visit visitor, self } end |
#walk(arg = true, &block) ⇒ Object
This method implements a sort of tree iterator, yielding each Node instance to the provided block with the first argument to #walk. If the block returns a non-true value, the walk is terminated.
This method is really an iterator, not a Visitor pattern.
89 90 91 92 93 94 95 |
# File 'lib/compiler/ast/node.rb', line 89 def walk(arg=true, &block) children do |child| if ch_arg = block.call(arg, child) child.walk(ch_arg, &block) end end end |