Class: GraphQL::Query::Arguments

Inherits:
Object
  • Object
show all
Extended by:
Delegate
Defined in:
lib/graphql/query/arguments.rb

Overview

Read-only access to values, normalizing all keys to strings

Arguments recursively wraps the input in Arguments instances.

Defined Under Namespace

Classes: ArgumentValue

Constant Summary collapse

NO_ARGS = 
self.new({}, argument_definitions: [], defaults_used: Set.new)

Class Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Delegate

def_delegators

Constructor Details

#initialize(values, argument_definitions:, defaults_used:) ⇒ Arguments

Returns a new instance of Arguments.



39
40
41
42
43
44
45
46
47
48
49
50
51
 
# File 'lib/graphql/query/arguments.rb', line 39

def initialize(values, argument_definitions:, defaults_used:)
  @argument_values = values.inject({}) do |memo, (inner_key, inner_value)|
    arg_name = inner_key.to_s

    arg_defn = argument_definitions[arg_name]
    arg_default_used = defaults_used.include?(arg_name)

    arg_value = wrap_value(inner_value, arg_defn.type)
    string_key = arg_defn.expose_as
    memo[string_key] = ArgumentValue.new(string_key, arg_value, arg_defn, arg_default_used)
    memo
  end
end

Class Attribute Details

.argument_definitions ⇒ Object

Returns the value of attribute argument_definitions.



101
102
103
 
# File 'lib/graphql/query/arguments.rb', line 101

def argument_definitions
  @argument_definitions
end

Class Method Details

.construct_arguments_class(argument_owner) ⇒ Object 



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
 
# File 'lib/graphql/query/arguments.rb', line 10

def self.construct_arguments_class(argument_owner)
  argument_definitions = argument_owner.arguments
  argument_owner.arguments_class = Class.new(self) do
    self.argument_definitions = argument_definitions

    def initialize(values, defaults_used)
      super(values, argument_definitions: self.class.argument_definitions, defaults_used: defaults_used)
    end

    argument_definitions.each do |_arg_name, arg_definition|
      expose_as = arg_definition.expose_as.to_s

      # Don't define a helper method if it would override something.
      if instance_methods.include?(expose_as)
        warn(
          "Unable to define a helper for argument with name '#{expose_as}' "\
          "as this is a reserved name. If you're using an argument such as "\
          "`argument #{expose_as}`, consider renaming this argument.`"
        )
        next
      end

      define_method(expose_as) do
        self[expose_as]
      end
    end
  end
end

Instance Method Details

#[](key) ⇒ Object

Returns the argument at that key.

Parameters:

  • key (String, Symbol) —

    name or index of value to access

Returns:

  • (Object) —

    the argument at that key



55
56
57
58
 
# File 'lib/graphql/query/arguments.rb', line 55

def [](key)
  key_s = key.is_a?(String) ? key : key.to_s
  @argument_values.fetch(key_s, NULL_ARGUMENT_VALUE).value
end

#default_used?(key) ⇒ Boolean

Returns true if the argument default was passed as the argument value to the resolver.

Parameters:

  • key (String, Symbol) —

    name of value to access

Returns:

  • (Boolean) —

    true if the argument default was passed as the argument value to the resolver



69
70
71
72
 
# File 'lib/graphql/query/arguments.rb', line 69

def default_used?(key)
  key_s = key.is_a?(String) ? key : key.to_s
  @argument_values.fetch(key_s, NULL_ARGUMENT_VALUE).default_used?
end

#each_value {|argument_value| ... } ⇒ Object

Access each key, value and type for the arguments in this set.

Yields:

Yield Parameters:



92
93
94
95
96
 
# File 'lib/graphql/query/arguments.rb', line 92

def each_value
  @argument_values.each_value do |argument_value|
    yield(argument_value)
  end
end

#key?(key) ⇒ Boolean

Returns true if the argument was present in this field.

Parameters:

  • key (String, Symbol) —

    name of value to access

Returns:

  • (Boolean) —

    true if the argument was present in this field



62
63
64
65
 
# File 'lib/graphql/query/arguments.rb', line 62

def key?(key)
  key_s = key.is_a?(String) ? key : key.to_s
  @argument_values.key?(key_s)
end

#to_h ⇒ Hash

Get the hash of all values, with stringified keys

Returns:

  • (Hash) —

    the stringified hash



76
77
78
79
80
81
82
83
84
85
 
# File 'lib/graphql/query/arguments.rb', line 76

def to_h
  @to_h ||= begin
    h = {}
    each_value do |arg_value|
      arg_key = arg_value.definition.expose_as
      h[arg_key] = unwrap_value(arg_value.value)
    end
    h
  end
end