Class: RuboCop::AST::NodePattern::Compiler

Inherits:
Object
  • Object
show all
Extended by:
SimpleForwardable
Defined in:
lib/rubocop/ast/node_pattern/compiler.rb,
lib/rubocop/ast/node_pattern/compiler/debug.rb,
lib/rubocop/ast/node_pattern/compiler/binding.rb,
lib/rubocop/ast/node_pattern/compiler/subcompiler.rb,
lib/rubocop/ast/node_pattern/compiler/atom_subcompiler.rb,
lib/rubocop/ast/node_pattern/compiler/sequence_subcompiler.rb,
lib/rubocop/ast/node_pattern/compiler/node_pattern_subcompiler.rb

Overview

The top-level compiler holding the global state Defers work to its subcompilers

Doc on how this fits in the compiling process:

/docs/modules/ROOT/pages/node_pattern.adoc

Direct Known Subclasses

Debug

Defined Under Namespace

Classes: AtomSubcompiler, Binding, Debug, NodePatternSubcompiler, SequenceSubcompiler, Subcompiler

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from SimpleForwardable

def_delegators

Constructor Details

#initialize ⇒ Compiler

Returns a new instance of Compiler.



16
17
18
19
20
21
22
23
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 16

def initialize
  @temp_depth = 0 # avoid name clashes between temp variables
  @captures = 0 # number of captures seen
  @positional_parameters = 0 # highest % (param) number seen
  @named_parameters = Set[] # keyword parameters
  @binding = Binding.new # bound variables
  @atom_subcompiler = self.class::AtomSubcompiler.new(self)
end

Instance Attribute Details

#binding ⇒ Object (readonly)

Returns the value of attribute binding.



14
15
16
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 14

def binding
  @binding
end

#captures ⇒ Object (readonly)

Returns the value of attribute captures.



14
15
16
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 14

def captures
  @captures
end

#named_parameters ⇒ Object (readonly)

Returns the value of attribute named_parameters.



14
15
16
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 14

def named_parameters
  @named_parameters
end

#positional_parameters ⇒ Object (readonly)

Returns the value of attribute positional_parameters.



14
15
16
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 14

def positional_parameters
  @positional_parameters
end

Instance Method Details

#compile_as_atom(node) ⇒ Object 



43
44
45
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 43

def compile_as_atom(node)
  @atom_subcompiler.compile(node)
end

#compile_as_node_pattern(node, **options) ⇒ Object 



47
48
49
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 47

def compile_as_node_pattern(node, **options)
  self.class::NodePatternSubcompiler.new(self, **options).compile(node)
end

#compile_sequence(sequence, var:) ⇒ Object 



51
52
53
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 51

def compile_sequence(sequence, var:)
  self.class::SequenceSubcompiler.new(self, sequence: sequence, var: var).compile_sequence
end

#each_union(enum, &block) ⇒ Object

Enumerates ‘enum` while keeping track of state across union branches (captures and unification).



39
40
41
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 39

def each_union(enum, &block)
  enforce_same_captures(binding.union_bind(enum), &block)
end

#freeze ⇒ Object 



75
76
77
78
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 75

def freeze
  @named_parameters.freeze
  super
end

#named_parameter(name) ⇒ Object 



32
33
34
35
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 32

def named_parameter(name)
  @named_parameters << name
  name
end

#next_capture ⇒ Object 



71
72
73
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 71

def next_capture
  "captures[#{new_capture}]"
end

#parser ⇒ Object 



55
56
57
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 55

def parser
  @parser ||= Parser.new
end

#positional_parameter(number) ⇒ Object 



27
28
29
30
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 27

def positional_parameter(number)
  @positional_parameters = number if number > @positional_parameters
  "param#{number}"
end

#with_temp_variables(*names, &block) ⇒ Object

Utilities



61
62
63
64
65
66
67
68
69
 
# File 'lib/rubocop/ast/node_pattern/compiler.rb', line 61

def with_temp_variables(*names, &block)
  @temp_depth += 1
  suffix = @temp_depth if @temp_depth > 1
  names = block.parameters.map(&:last) if names.empty?
  names.map! { |name| "#{name}#{suffix}" }
  yield(*names)
ensure
  @temp_depth -= 1
end