Class: SyntaxTree::ClassDeclaration

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

Overview

Class represents defining a class using the class keyword.

class Container
end

Classes can have path names as their class name in case it’s being nested under a namespace, as in:

class Namespace::Container
end

Classes can also be defined as a top-level path, in the case that it’s already in a namespace but you want to define it at the top-level instead, as in:

module OtherNamespace
  class ::Namespace::Container
  end
end

All of these declarations can also have an optional superclass reference, as in:

class Child < Parent
end

That superclass can actually be any Ruby expression, it doesn’t necessarily need to be a constant, as in:

class Child < method
end

Instance Attribute Summary collapse

Attributes inherited from Node

#location

Instance Method Summary collapse

Methods inherited from Node

#construct_keys, #end_char, #pretty_print, #start_char, #to_json, #to_mermaid

Constructor Details

#initialize(constant:, superclass:, bodystmt:, location:) ⇒ ClassDeclaration

Returns a new instance of ClassDeclaration.



3329
3330
3331
3332
3333
3334
3335
 
# File 'lib/syntax_tree/node.rb', line 3329

def initialize(constant:, superclass:, bodystmt:, location:)
  @constant = constant
  @superclass = superclass
  @bodystmt = bodystmt
  @location = location
  @comments = []
end

Instance Attribute Details

#bodystmt ⇒ Object (readonly)

BodyStmt

the expressions to execute within the context of the class



3324
3325
3326
 
# File 'lib/syntax_tree/node.rb', line 3324

def bodystmt
  @bodystmt
end

#comments ⇒ Object (readonly)

Array[ Comment | EmbDoc ]

the comments attached to this node



3327
3328
3329
 
# File 'lib/syntax_tree/node.rb', line 3327

def comments
  @comments
end

#constant ⇒ Object (readonly)

ConstPathRef | ConstRef | TopConstRef

the name of the class being

defined



3318
3319
3320
 
# File 'lib/syntax_tree/node.rb', line 3318

def constant
  @constant
end

#superclass ⇒ Object (readonly)

nil | Node

the optional superclass declaration



3321
3322
3323
 
# File 'lib/syntax_tree/node.rb', line 3321

def superclass
  @superclass
end

Instance Method Details

#===(other) ⇒ Object 



3392
3393
3394
3395
 
# File 'lib/syntax_tree/node.rb', line 3392

def ===(other)
  other.is_a?(ClassDeclaration) && constant === other.constant &&
    superclass === other.superclass && bodystmt === other.bodystmt
end

#accept(visitor) ⇒ Object 



3337
3338
3339
 
# File 'lib/syntax_tree/node.rb', line 3337

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

#child_nodes ⇒ Object Also known as: deconstruct 



3341
3342
3343
 
# File 'lib/syntax_tree/node.rb', line 3341

def child_nodes
  [constant, superclass, bodystmt]
end

#copy(constant: nil, superclass: nil, bodystmt: nil, location: nil) ⇒ Object 



3345
3346
3347
3348
3349
3350
3351
3352
3353
3354
3355
3356
 
# File 'lib/syntax_tree/node.rb', line 3345

def copy(constant: nil, superclass: nil, bodystmt: nil, location: nil)
  node =
    ClassDeclaration.new(
      constant: constant || self.constant,
      superclass: superclass || self.superclass,
      bodystmt: bodystmt || self.bodystmt,
      location: location || self.location
    )

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

#deconstruct_keys(_keys) ⇒ Object 



3360
3361
3362
3363
3364
3365
3366
3367
3368
 
# File 'lib/syntax_tree/node.rb', line 3360

def deconstruct_keys(_keys)
  {
    constant: constant,
    superclass: superclass,
    bodystmt: bodystmt,
    location: location,
    comments: comments
  }
end

#format(q) ⇒ Object 



3370
3371
3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
3384
3385
3386
3387
3388
3389
3390
 
# File 'lib/syntax_tree/node.rb', line 3370

def format(q)
  if bodystmt.empty?
    q.group do
      format_declaration(q)
      q.breakable_force
      q.text("end")
    end
  else
    q.group do
      format_declaration(q)

      q.indent do
        q.breakable_force
        q.format(bodystmt)
      end

      q.breakable_force
      q.text("end")
    end
  end
end