Class: GraphQL::Language::Nodes::AbstractNode
- Inherits:
-
Object
- Object
- GraphQL::Language::Nodes::AbstractNode
- 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
Direct Known Subclasses
Argument, Directive, DirectiveDefinition, Document, EnumTypeDefinition, EnumTypeExtension, EnumValueDefinition, Field, FieldDefinition, FragmentDefinition, FragmentSpread, InlineFragment, InputObject, InputObjectTypeDefinition, InputObjectTypeExtension, InputValueDefinition, InterfaceTypeDefinition, InterfaceTypeExtension, NameOnlyNode, ObjectTypeDefinition, ObjectTypeExtension, OperationDefinition, ScalarTypeDefinition, ScalarTypeExtension, SchemaDefinition, SchemaExtension, UnionTypeDefinition, UnionTypeExtension, VariableDefinition, WrapperType
Defined Under Namespace
Modules: DefinitionNode
Constant Summary collapse
- NO_CHILDREN =
[].freeze
Instance Attribute Summary collapse
-
#col ⇒ Object
readonly
Returns the value of attribute col.
-
#filename ⇒ Object
readonly
Returns the value of attribute filename.
-
#line ⇒ Object
readonly
Returns the value of attribute line.
Class Method Summary collapse
-
.children_of_type ⇒ Object
-
.inherited(child_class) ⇒ Object
Add a default
#visit_method
and#children_method_name
using the class name.
Instance Method Summary collapse
-
#==(other) ⇒ Boolean
Value equality.
-
#children ⇒ Array<GraphQL::Language::Nodes::AbstractNode>
All nodes in the tree below this one.
-
#children_method_name ⇒ Object
-
#delete_child(previous_child) ⇒ Object
TODO DRY with
replace_child
. -
#initialize(options = {}) ⇒ AbstractNode
constructor
Initialize a node by extracting its position, then calling the class’s
initialize_node
method. -
#initialize_copy(other) ⇒ Object
This might be unnecessary, but its easiest to add it here.
-
#merge(new_options) ⇒ AbstractNode
This creates a copy of
self
, withnew_options
applied. -
#position ⇒ Object
-
#replace_child(previous_child, new_child) ⇒ Object
Copy
self
, but modify the copy so thatprevious_child
is replaced bynew_child
. -
#scalars ⇒ Array<Integer, Float, String, Boolean, Array>
Scalar values attached to this node.
-
#to_query_string(printer: GraphQL::Language::Printer.new) ⇒ Object
Constructor Details
#initialize(options = {}) ⇒ AbstractNode
Initialize a node by extracting its position,
then calling the class’s initialize_node
method.
28 29 30 31 32 33 34 35 36 37 38 |
# File 'lib/graphql/language/nodes.rb', line 28 def initialize( = {}) if .key?(:position_source) position_source = .delete(:position_source) @line = position_source[1] @col = position_source[2] end @filename = .delete(:filename) initialize_node(**) end |
Instance Attribute Details
#col ⇒ Object (readonly)
Returns the value of attribute col.
23 24 25 |
# File 'lib/graphql/language/nodes.rb', line 23 def col @col end |
#filename ⇒ Object (readonly)
Returns the value of attribute filename.
23 24 25 |
# File 'lib/graphql/language/nodes.rb', line 23 def filename @filename end |
#line ⇒ Object (readonly)
Returns the value of attribute line.
23 24 25 |
# File 'lib/graphql/language/nodes.rb', line 23 def line @line end |
Class Method Details
.children_of_type ⇒ Object
160 161 162 |
# File 'lib/graphql/language/nodes.rb', line 160 def children_of_type @children_methods end |
.inherited(child_class) ⇒ Object
Add a default #visit_method
and #children_method_name
using the class name
137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 |
# File 'lib/graphql/language/nodes.rb', line 137 def inherited(child_class) super name_underscored = child_class.name .split("::").last .gsub(/([a-z])([A-Z])/,'\1_\2') # insert underscores .downcase # remove caps child_class.module_eval <<-RUBY, __FILE__, __LINE__ def visit_method :on_#{name_underscored} end class << self attr_accessor :children_method_name def visit_method :on_#{name_underscored} end end self.children_method_name = :#{name_underscored}s RUBY end |
Instance Method Details
#==(other) ⇒ Boolean
Value equality
42 43 44 45 46 47 |
# File 'lib/graphql/language/nodes.rb', line 42 def ==(other) return true if equal?(other) other.kind_of?(self.class) && other.scalars == self.scalars && other.children == self.children end |
#children ⇒ Array<GraphQL::Language::Nodes::AbstractNode>
Returns all nodes in the tree below this one.
52 53 54 |
# File 'lib/graphql/language/nodes.rb', line 52 def children NO_CHILDREN end |
#children_method_name ⇒ Object
68 69 70 |
# File 'lib/graphql/language/nodes.rb', line 68 def children_method_name self.class.children_method_name end |
#delete_child(previous_child) ⇒ Object
TODO DRY with replace_child
114 115 116 117 118 119 120 121 122 123 124 |
# File 'lib/graphql/language/nodes.rb', line 114 def delete_child(previous_child) # Figure out which list `previous_child` may be found in method_name = previous_child.children_method_name # Copy that list, and delete previous_child new_children = public_send(method_name).dup new_children.delete(previous_child) # Copy this node, but with the new list of children: copy_of_self = merge(method_name => new_children) # Return the copy: copy_of_self end |
#initialize_copy(other) ⇒ Object
This might be unnecessary, but its easiest to add it here.
62 63 64 65 66 |
# File 'lib/graphql/language/nodes.rb', line 62 def initialize_copy(other) @children = nil @scalars = nil @query_string = nil end |
#merge(new_options) ⇒ AbstractNode
This creates a copy of self
, with new_options
applied.
87 88 89 |
# File 'lib/graphql/language/nodes.rb', line 87 def merge() dup.merge!() end |
#position ⇒ Object
72 73 74 |
# File 'lib/graphql/language/nodes.rb', line 72 def position [line, col] end |
#replace_child(previous_child, new_child) ⇒ Object
Copy self
, but modify the copy so that previous_child
is replaced by new_child
92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 |
# File 'lib/graphql/language/nodes.rb', line 92 def replace_child(previous_child, new_child) # Figure out which list `previous_child` may be found in method_name = previous_child.children_method_name # Get the value from this (original) node prev_children = public_send(method_name) if prev_children.is_a?(Array) # Copy that list, and replace `previous_child` with `new_child` # in the list. new_children = prev_children.dup prev_idx = new_children.index(previous_child) new_children[prev_idx] = new_child else # Use the new value for the given attribute new_children = new_child end # Copy this node, but with the new child value copy_of_self = merge(method_name => new_children) # Return the copy: copy_of_self end |
#scalars ⇒ Array<Integer, Float, String, Boolean, Array>
Returns Scalar values attached to this node.
57 58 59 |
# File 'lib/graphql/language/nodes.rb', line 57 def scalars NO_CHILDREN end |
#to_query_string(printer: GraphQL::Language::Printer.new) ⇒ Object
76 77 78 79 80 81 82 |
# File 'lib/graphql/language/nodes.rb', line 76 def to_query_string(printer: GraphQL::Language::Printer.new) if printer.is_a?(GraphQL::Language::Printer) @query_string ||= printer.print(self) else printer.print(self) end end |