Module: GraphQL::Language::Generation

Extended by:
Generation
Included in:
Generation
Defined in:
lib/graphql/language/generation.rb

Overview

Exposes #generate, which turns AST nodes back into query strings.

Instance Method Summary collapse

Instance Method Details

#generate(node, indent: "") ⇒ String

Turn an AST node back into a string.

Examples:

Turning a document into a query

document = GraphQL.parse(query_string)
GraphQL::Language::Generation.generate(document)
# => "{ ... }"

Parameters:

Returns:

  • (String) —

    Valid GraphQL for ‘node`



17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
 
# File 'lib/graphql/language/generation.rb', line 17

def generate(node, indent: "")
  case node
  when Nodes::Document
    node.definitions.map { |d| generate(d) }.join("\n\n")
  when Nodes::Argument
    "#{node.name}: #{generate(node.value)}"
  when Nodes::Directive
    out = "@#{node.name}"
    out << "(#{node.arguments.map { |a| generate(a) }.join(", ")})" if node.arguments.any?
    out
  when Nodes::Enum
    "#{node.name}"
  when Nodes::Field
    out = "#{indent}"
    out << "#{node.alias}: " if node.alias
    out << "#{node.name}"
    out << "(#{node.arguments.map { |a| generate(a) }.join(", ")})" if node.arguments.any?
    out << generate_directives(node.directives)
    out << generate_selections(node.selections, indent: indent)
    out
  when Nodes::FragmentDefinition
    out = "#{indent}fragment #{node.name}"
    out << " on #{node.type}" if node.type
    out << generate_directives(node.directives)
    out << generate_selections(node.selections, indent: indent)
    out
  when Nodes::FragmentSpread
    out = "#{indent}...#{node.name}"
    out << generate_directives(node.directives)
    out
  when Nodes::InlineFragment
    out = "#{indent}..."
    out << " on #{node.type}" if node.type
    out << generate_directives(node.directives)
    out << generate_selections(node.selections, indent: indent)
    out
  when Nodes::InputObject
    generate(node.to_h)
  when Nodes::ListType
    "[#{generate(node.of_type)}]"
  when Nodes::NonNullType
    "#{generate(node.of_type)}!"
  when Nodes::OperationDefinition
    out = "#{indent}#{node.operation_type}"
    out << " #{node.name}" if node.name
    out << "(#{node.variables.map { |v| generate(v) }.join(", ")})" if node.variables.any?
    out << generate_directives(node.directives)
    out << generate_selections(node.selections, indent: indent)
    out
  when Nodes::TypeName
    "#{node.name}"
  when Nodes::VariableDefinition
    out = "$#{node.name}: #{generate(node.type)}"
    out << " = #{generate(node.default_value)}" unless node.default_value.nil?
    out
  when Nodes::VariableIdentifier
    "$#{node.name}"
  when Nodes::SchemaDefinition
    if (node.query.nil? || node.query == 'Query') &&
       (node.mutation.nil? || node.mutation == 'Mutation') &&
       (node.subscription.nil? || node.subscription == 'Subscription')
      return
    end

    out = "schema {\n"
    out << "  query: #{node.query}\n" if node.query
    out << "  mutation: #{node.mutation}\n" if node.mutation
    out << "  subscription: #{node.subscription}\n" if node.subscription
    out << "}"
  when Nodes::ScalarTypeDefinition
    out = generate_description(node)
    out << "scalar #{node.name}"
    out << generate_directives(node.directives)
  when Nodes::ObjectTypeDefinition
    out = generate_description(node)
    out << "type #{node.name}"
    out << generate_directives(node.directives)
    out << " implements " << node.interfaces.map(&:name).join(", ") unless node.interfaces.empty?
    out << generate_field_definitions(node.fields)
  when Nodes::InputValueDefinition
    out = "#{node.name}: #{generate(node.type)}"
    out << " = #{generate(node.default_value)}" unless node.default_value.nil?
    out << generate_directives(node.directives)
  when Nodes::FieldDefinition
    out = node.name.dup
    unless node.arguments.empty?
      out << "(" << node.arguments.map{ |arg| generate(arg) }.join(", ") << ")"
    end
    out << ": #{generate(node.type)}"
    out << generate_directives(node.directives)
  when Nodes::InterfaceTypeDefinition
    out = generate_description(node)
    out << "interface #{node.name}"
    out << generate_directives(node.directives)
    out << generate_field_definitions(node.fields)
  when Nodes::UnionTypeDefinition
    out = generate_description(node)
    out << "union #{node.name}"
    out << generate_directives(node.directives)
    out << " = " + node.types.map(&:name).join(" | ")
  when Nodes::EnumTypeDefinition
    out = generate_description(node)
    out << "enum #{node.name}#{generate_directives(node.directives)} {\n"
    node.values.each.with_index do |value, i|
      out << generate_description(value, indent: '  ', first_in_block: i == 0)
      out << generate(value)
    end
    out << "}"
  when Nodes::EnumValueDefinition
    out = "  #{node.name}"
    out << generate_directives(node.directives)
    out << "\n"
  when Nodes::InputObjectTypeDefinition
    out = generate_description(node)
    out << "input #{node.name}"
    out << generate_directives(node.directives)
    out << " {\n"
    node.fields.each.with_index do |field, i|
      out << generate_description(field, indent: '  ', first_in_block: i == 0)
      out << "  #{generate(field)}\n"
    end
    out << "}"
  when Nodes::DirectiveDefinition
    out = generate_description(node)
    out << "directive @#{node.name}"
    out << "(#{node.arguments.map { |a| generate(a) }.join(", ")})" if node.arguments.any?
    out << " on #{node.locations.join(' | ')}"
  when Nodes::AbstractNode
    node.to_query_string(indent: indent)
  when FalseClass, Float, Integer, NilClass, String, TrueClass
    JSON.generate(node, quirks_mode: true)
  when Array
    "[#{node.map { |v| generate(v) }.join(", ")}]"
  when Hash
    "{#{node.map { |k, v| "#{k}: #{generate(v)}" }.join(", ")}}"
  else
    raise TypeError
  end
end