Class: SyntaxTree::ARef

Inherits:
Node
  • Object
show all
Defined in:
lib/syntax_tree/node.rb

Overview

ARef represents when you’re pulling a value out of a collection at a specific index. Put another way, it’s any time you’re calling the method #[].

collection[index]

The nodes usually contains two children, the collection and the index. In some cases, you don’t necessarily have the second child node, because you can call procs with a pretty esoteric syntax. In the following example, you wouldn’t have a second child node:

collection[]

Instance Attribute Summary collapse

Attributes inherited from Node

#location

Instance Method Summary collapse

Methods inherited from Node

#construct_keys, #pretty_print, #to_json

Constructor Details

#initialize(collection:, index:, location:) ⇒ ARef

Returns a new instance of ARef.



567
568
569
570
571
572
 
# File 'lib/syntax_tree/node.rb', line 567

def initialize(collection:, index:, location:)
  @collection = collection
  @index = index
  @location = location
  @comments = []
end

Instance Attribute Details

#collection ⇒ Object (readonly)

untyped

the value being indexed



559
560
561
 
# File 'lib/syntax_tree/node.rb', line 559

def collection
  @collection
end

#comments ⇒ Object (readonly)

Array[ Comment | EmbDoc ]

the comments attached to this node



565
566
567
 
# File 'lib/syntax_tree/node.rb', line 565

def comments
  @comments
end

#index ⇒ Object (readonly)

nil | Args

the value being passed within the brackets



562
563
564
 
# File 'lib/syntax_tree/node.rb', line 562

def index
  @index
end

Instance Method Details

#===(other) ⇒ Object 



622
623
624
625
 
# File 'lib/syntax_tree/node.rb', line 622

def ===(other)
  other.is_a?(ARef) && collection === other.collection &&
    index === other.index
end

#accept(visitor) ⇒ Object 



574
575
576
 
# File 'lib/syntax_tree/node.rb', line 574

def accept(visitor)
  visitor.visit_aref(self)
end

#child_nodes ⇒ Object Also known as: deconstruct 



578
579
580
 
# File 'lib/syntax_tree/node.rb', line 578

def child_nodes
  [collection, index]
end

#copy(collection: nil, index: nil, location: nil) ⇒ Object 



582
583
584
585
586
587
588
589
590
591
592
 
# File 'lib/syntax_tree/node.rb', line 582

def copy(collection: nil, index: nil, location: nil)
  node =
    ARef.new(
      collection: collection || self.collection,
      index: index || self.index,
      location: location || self.location
    )

  node.comments.concat(comments.map(&:copy))
  node
end

#deconstruct_keys(_keys) ⇒ Object 



596
597
598
599
600
601
602
603
 
# File 'lib/syntax_tree/node.rb', line 596

def deconstruct_keys(_keys)
  {
    collection: collection,
    index: index,
    location: location,
    comments: comments
  }
end

#format(q) ⇒ Object 



605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
 
# File 'lib/syntax_tree/node.rb', line 605

def format(q)
  q.group do
    q.format(collection)
    q.text("[")

    if index
      q.indent do
        q.breakable_empty
        q.format(index)
      end
      q.breakable_empty
    end

    q.text("]")
  end
end