Class: GraphQL::Schema::Argument Private

Inherits:
Object
  • Object
show all
Includes:
Member::AcceptsDefinition, Member::CachedGraphQLDefinition
Defined in:
lib/graphql/schema/argument.rb

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

Constant Summary

NO_DEFAULT =

This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.

:__no_default__

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Member::CachedGraphQLDefinition

#graphql_definition, #initialize_copy

Constructor Details

#initialize(arg_name = nil, type_expr = nil, desc = nil, required:, type: nil, name: nil, description: nil, default_value: NO_DEFAULT, as: nil, camelize: true, prepare: nil, owner:, &definition_block) ⇒ Argument

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of Argument

Parameters:

  • arg_name (Symbol) (defaults to: nil)
  • type_expr (defaults to: nil)
  • desc (String) (defaults to: nil)
  • required (Boolean)

    if true, this argument is non-null; if false, this argument is nullable

  • description (String)
  • default_value (Object)
  • as (Symbol)

    Override the keyword name when passed to a method

  • prepare (Symbol)

    A method to call to tranform this argument’s valuebefore sending it to field resolution

  • camelize (Boolean)

    if true, the name will be camelized when building the schema



31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
# File 'lib/graphql/schema/argument.rb', line 31

def initialize(arg_name = nil, type_expr = nil, desc = nil, required:, type: nil, name: nil, description: nil, default_value: NO_DEFAULT, as: nil, camelize: true, prepare: nil, owner:, &definition_block)
  arg_name ||= name
  @name = camelize ? Member::BuildType.camelize(arg_name.to_s) : arg_name.to_s
  @type_expr = type_expr || type
  @description = desc || description
  @null = !required
  @default_value = default_value
  @owner = owner
  @as = as
  @keyword = as || Schema::Member::BuildType.underscore(@name).to_sym
  @prepare = prepare

  if definition_block
    instance_eval(&definition_block)
  end
end

Instance Attribute Details

#keywordSymbol (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns This argument’s name in Ruby keyword arguments

Returns:

  • (Symbol)

    This argument’s name in Ruby keyword arguments



20
21
22
# File 'lib/graphql/schema/argument.rb', line 20

def keyword
  @keyword
end

#nameString (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns the GraphQL name for this argument, camelized unless camelize: false is provided

Returns:

  • (String)

    the GraphQL name for this argument, camelized unless camelize: false is provided



11
12
13
# File 'lib/graphql/schema/argument.rb', line 11

def name
  @name
end

#ownerGraphQL::Schema::Field, Class (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns The field or input object this argument belongs to

Returns:



14
15
16
# File 'lib/graphql/schema/argument.rb', line 14

def owner
  @owner
end

#prepareSymbol (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns A method to call to transform this value before sending it to field resolution method

Returns:

  • (Symbol)

    A method to call to transform this value before sending it to field resolution method



17
18
19
# File 'lib/graphql/schema/argument.rb', line 17

def prepare
  @prepare
end

Instance Method Details

#description(text = nil) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.



48
49
50
51
52
53
54
# File 'lib/graphql/schema/argument.rb', line 48

def description(text = nil)
  if text
    @description = text
  else
    @description
  end
end

#prepare_value(obj, value) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Apply the #prepare configuration to value, using methods from obj. Used by the runtime.



78
79
80
81
82
83
84
85
86
87
88
89
# File 'lib/graphql/schema/argument.rb', line 78

def prepare_value(obj, value)
  case @prepare
  when nil
    value
  when Symbol, String
    obj.public_send(@prepare, value)
  when Proc
    @prepare.call(value, obj.context)
  else
    raise "Invalid prepare for #{@owner.name}.name: #{@prepare.inspect}"
  end
end

#to_graphqlObject

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.



56
57
58
59
60
61
62
63
64
65
66
67
# File 'lib/graphql/schema/argument.rb', line 56

def to_graphql
  argument = GraphQL::Argument.new
  argument.name = @name
  argument.type = -> { type }
  argument.description = @description
  argument.[:type_class] = self
  argument.as = @as
  if NO_DEFAULT != @default_value
    argument.default_value = @default_value
  end
  argument
end

#typeObject

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.



69
70
71
72
73
# File 'lib/graphql/schema/argument.rb', line 69

def type
  @type ||= Member::BuildType.parse_type(@type_expr, null: @null)
rescue StandardError => err
  raise ArgumentError, "Couldn't build type for Argument #{@owner.name}.#{name}: #{err.class.name}: #{err.message}", err.backtrace
end