1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
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
|
# frozen_string_literal: true
module GraphQL
module Execution
class Interpreter
# A wrapper for argument hashes in GraphQL queries.
#
# This object is immutable so that the runtime code can be sure that
# modifications don't leak from one use to another
#
# @see GraphQL::Query#arguments_for to get access to these objects.
class Arguments
extend Forwardable
include GraphQL::Dig
# The Ruby-style arguments hash, ready for a resolver.
# This hash is the one used at runtime.
#
# @return [Hash<Symbol, Object>]
attr_reader :keyword_arguments
# @param argument_values [nil, Hash{Symbol => ArgumentValue}]
# @param keyword_arguments [nil, Hash{Symbol => Object}]
def initialize(keyword_arguments: nil, argument_values:)
@empty = argument_values.nil? || argument_values.empty?
# This is only present when `extras` have been merged in:
if keyword_arguments
# This is a little crazy. We expect the `:argument_details` extra to _include extras_,
# but the object isn't created until _after_ extras are put together.
# So, we have to use a special flag here to say, "at the last minute, add yourself to the keyword args."
#
# Otherwise:
# - We can't access the final Arguments instance _while_ we're preparing extras
# - After we _can_ access it, it's frozen, so we can't add anything.
#
# So, this flag gives us a chance to sneak it in before freezing, _and_ while we have access
# to the new Arguments instance itself.
if keyword_arguments[:argument_details] == :__arguments_add_self
keyword_arguments[:argument_details] = self
end
@keyword_arguments = keyword_arguments.freeze
elsif !@empty
@keyword_arguments = {}
argument_values.each do |name, arg_val|
@keyword_arguments[name] = arg_val.value
end
@keyword_arguments.freeze
else
@keyword_arguments = NO_ARGS
end
@argument_values = argument_values ? argument_values.freeze : NO_ARGS
freeze
end
# @return [Hash{Symbol => ArgumentValue}]
attr_reader :argument_values
def empty?
@empty
end
def_delegators :keyword_arguments, :key?, :[], :fetch, :keys, :each, :values, :size, :to_h
def_delegators :argument_values, :each_value
def inspect
"#<#{self.class} @keyword_arguments=#{keyword_arguments.inspect}>"
end
# Create a new arguments instance which includes these extras.
#
# This is called by the runtime to implement field `extras: [...]`
#
# @param extra_args [Hash<Symbol => Object>]
# @return [Interpreter::Arguments]
# @api private
def merge_extras(extra_args)
self.class.new(
argument_values: argument_values,
keyword_arguments: keyword_arguments.merge(extra_args)
)
end
NO_ARGS = GraphQL::EmptyObjects::EMPTY_HASH
EMPTY = self.new(argument_values: nil, keyword_arguments: NO_ARGS).freeze
end
end
end
end
|
