Class: GraphQL::Language::Nodes::AbstractNode

Inherits:
Object
  • Object
show all
Defined in:
lib/graphql/language/nodes.rb

Overview

AbstractNode is the base class for all nodes in a GraphQL AST.

It provides some APIs for working with ASTs:

  • children returns all AST nodes attached to this one. Used for tree traversal.
  • scalars returns all scalar (Ruby) values attached to this one. Used for comparing nodes.
  • to_query_string turns an AST node into a GraphQL string

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = {}) ⇒ AbstractNode

Initialize a node by extracting its position, then calling the class's initialize_node method.

Parameters:

  • options (Hash) (defaults to: {})

    Initial attributes for this node



16
17
18
19
20
21
22
23
# File 'lib/graphql/language/nodes.rb', line 16

def initialize(options={})
  if options.key?(:position_source)
    position_source = options.delete(:position_source)
    @line, @col = position_source.line_and_column
  end

  initialize_node(options)
end

Instance Attribute Details

#colObject

Returns the value of attribute col.



11
12
13
# File 'lib/graphql/language/nodes.rb', line 11

def col
  @col
end

#lineObject

Returns the value of attribute line.



11
12
13
# File 'lib/graphql/language/nodes.rb', line 11

def line
  @line
end

Class Method Details

.child_attributes(*attr_names) ⇒ Object

define attr_names as places where child nodes may be attached to this node



67
68
69
70
# File 'lib/graphql/language/nodes.rb', line 67

def child_attributes(*attr_names)
  @child_attributes ||= []
  @child_attributes += attr_names
end

.inherited(subclass) ⇒ Object

A node subclass inherits scalar_attributes and child_attributes from its parent



55
56
57
58
# File 'lib/graphql/language/nodes.rb', line 55

def inherited(subclass)
  subclass.scalar_attributes(*@scalar_attributes)
  subclass.child_attributes(*@child_attributes)
end

.scalar_attributes(*attr_names) ⇒ Object

define attr_names as places where scalars may be attached to this node



61
62
63
64
# File 'lib/graphql/language/nodes.rb', line 61

def scalar_attributes(*attr_names)
  @scalar_attributes ||= []
  @scalar_attributes += attr_names
end

Instance Method Details

#childrenArray<GraphQL::Language::Nodes::AbstractNode>

Returns all nodes in the tree below this one.

Returns:



40
41
42
43
44
# File 'lib/graphql/language/nodes.rb', line 40

def children
  self.class.child_attributes
    .map { |attr_name| public_send(attr_name) }
    .flatten
end

#eql?(other) ⇒ Boolean

Value equality

Returns:

  • (Boolean)

    True if self is equivalent to other



32
33
34
35
36
37
# File 'lib/graphql/language/nodes.rb', line 32

def eql?(other)
  return true if equal?(other)
  other.is_a?(self.class) &&
    other.scalars.eql?(self.scalars) &&
    other.children.eql?(self.children)
end

#initialize_node(options = {}) ⇒ Object

This is called with node-specific options

Raises:

  • (NotImplementedError)


26
27
28
# File 'lib/graphql/language/nodes.rb', line 26

def initialize_node(options={})
  raise NotImplementedError
end

#positionObject



73
74
75
# File 'lib/graphql/language/nodes.rb', line 73

def position
  [line, col]
end

#scalarsArray<Integer, Float, String, Boolean, Array>

Returns Scalar values attached to this node.

Returns:

  • (Array<Integer, Float, String, Boolean, Array>)

    Scalar values attached to this node



47
48
49
50
# File 'lib/graphql/language/nodes.rb', line 47

def scalars
  self.class.scalar_attributes
    .map { |attr_name| public_send(attr_name) }
end

#to_query_stringObject



77
78
79
# File 'lib/graphql/language/nodes.rb', line 77

def to_query_string
  Generation.generate(self)
end