rails-graphql 0.1.0

data/lib/rails/graphql/type/union.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Rails # :nodoc:
+  module GraphQL # :nodoc:
+    class Type # :nodoc:
+      # = GraphQL UnionType
+      #
+      # Unions represent an object that could be one of a list of GraphQL
+      # Object types.
+      # See http://spec.graphql.org/June2018/#UnionTypeDefinition
+      class Union < Type
+        setup! output: true
+
+        # The list of accepted classes for members
+        VALID_MEMBER_TYPES = [Type::Object].freeze
+
+        # Define the methods for accessing the members attribute
+        inherited_collection :members
+
+        # The purpose of instantiating an interface is to have access to its
+        # public methods. It then runs from the strategy perspective, pointing
+        # out any other methods to the manually set event
+        delegate_missing_to :event
+        attr_reader :event
+
+        class << self
+          # Return the base type of the objects on this union
+          def of_kind
+            members.first.base_type
+          end
+
+          # Check if the other type is equivalent by checking if the type is
+          # member of any of this union members
+          def =~(other)
+            super || all_members.any? { |item| other =~ item }
+          end
+
+          # Use this method to add members to the union
+          def append(*others)
+            return if others.blank?
+
+            others.flatten!
+            others.map! do |item|
+              next item unless item.is_a?(Symbol)
+              GraphQL.type_map.fetch(item, namespaces: namespaces)
+            end
+
+            checker = others.lazy.map { |item| item.try(:base_type) }.uniq.force
+            raise ArgumentError, <<~MSG.squish unless checker.size === 1
+              All the union members must be of the same base class.
+            MSG
+
+            check_types = members? ? [members.first.base_type] : VALID_MEMBER_TYPES
+            raise ArgumentError, <<~MSG.squish unless (check_types & checker).size === 1
+              A union cannot contain members of different base classes.
+            MSG
+
+            members.concat(others)
+          end
+
+          # Check if the union definition is valid
+          def validate!(*)
+            super if defined? super
+
+            members = all_members
+            raise ArgumentError, <<~MSG.squish unless members.size >= 1
+              A union must contain at least one member.
+            MSG
+
+            size = members.lazy.map(&:base_type).uniq.force.size
+            raise ArgumentError, <<~MSG.squish unless size.eql?(1)
+              All the members of the union must contain the same base class.
+            MSG
+          end
+
+          def inspect # :nodoc:
+            <<~INFO.squish + '>'
+              #<GraphQL::Union #{gql_name}
+              (#{all_members.size})
+              {#{all_members.map(&:gql_name).join(' | ')}}
+            INFO
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rails/graphql/type_map.rb

@@ -0,0 +1,347 @@
+# frozen_string_literal: true
+
+require 'concurrent/map'
+require 'active_support/core_ext/class/subclasses'
+
+module Rails # :nodoc:
+  module GraphQL # :nodoc:
+    # = GraphQL Type Map
+    #
+    # Inspired by ActiveRecord::Type::TypeMap, this class stores all the things
+    # defined, their unique name, their basic settings, and correctly index
+    # them so they are easy to find whenever necessary.
+    #
+    # Items are stored as procs because aliases should fetch whatever the base
+    # object is, even if they change in the another point.
+    #
+    # The cache stores in the following structure:
+    # Namespace -> BaseClass -> ItemKey -> Item
+    class TypeMap
+      FILTER_REGISTER_TRACE = /((inherited|initialize)'$|schema\.rb:\d+)/.freeze
+
+      # Store all the base classes and if they were eager loaded by the type map
+      # Be aware of the order because hard reset is based in this order
+      mattr_accessor :base_classes, instance_writer: false, default: {
+        Type: false,
+        Directive: false,
+        Schema: false,
+      }
+
+      def self.loaded!(base_class)
+        base_classes[base_class] = true
+      end
+
+      # Reset the state of the type mapper
+      def reset!
+        @objects = 0 # Number of types and directives defined
+
+        @pending = []
+        @callbacks = Hash.new { |h, k| h[k] = [] }
+        @skip_register = nil
+
+        @index = Concurrent::Map.new do |h1, key1|                # Namespaces
+          base_class = Concurrent::Map.new do |h2, key2|          # Base classes
+            ensure_base_class!(key2)
+            h2.fetch_or_store(key2, Concurrent::Map.new)          # Items
+          end
+
+          h1.fetch_or_store(key1, base_class)
+        end
+
+        @checkpoint.map(&:register!) if defined?(@checkpoint)
+      end
+
+      alias initialize reset!
+
+      # This will do a full reset of the type map, re-registering all the
+      # descendant classes for all the base classes
+      def hard_reset!
+        remove_instance_variable(:@checkpoint) if defined?(@checkpoint)
+
+        reset!
+        base_classes.each_key do |base_class|
+          GraphQL.const_get(base_class).descendants.each(&:register!)
+        end
+      end
+
+      # Save or restore a checkpoint that can the type map can be reseted to
+      # TODO: With hard reset, we might not need checkpoint anymore
+      def use_checkpoint!
+        return reset! if defined?(@checkpoint)
+
+        register_pending!
+        @checkpoint = objects
+      end
+
+      # Get the list of all registred objects
+      def objects(base_classes: nil, namespaces: nil)
+        (Array.wrap(namespaces).presence || @index.keys).map do |namespace|
+          (Array.wrap(base_classes).presence || @index[namespace].keys).map do |base_class|
+            @index[namespace][base_class].values.map(&:call) \
+              if @index[namespace].key?(base_class)
+          end if @index.key?(namespace)
+        end.flatten.compact.uniq.select do |obj|
+          obj.respond_to?(:register!)
+        end
+      end
+
+      # Same as +fetch+ but it will raise an exception or retry depending if the
+      # base type was already loaded or not
+      def fetch!(*args, base_class: :Type, **xargs)
+        xargs[:base_class] = base_class
+
+        result = fetch(*args, **xargs)
+        return result unless result.nil?
+
+        raise ArgumentError, <<~MSG.squish if base_classes[base_class]
+          Unable to find #{args.first.inspect} #{base_class} object.
+        MSG
+
+        GraphQL.const_get(base_class).eager_load!
+        fetch!(*args, **xargs)
+      end
+
+      # Find the given key or name inside the base class either on the given
+      # namespace or in the base +:base+ namespace
+      def fetch(key_or_name, prevent_register: nil, **xargs)
+        if prevent_register != true
+          skip_register << Array.wrap(prevent_register)
+          register_pending!
+        end
+
+        namespaces = xargs[:namespaces]
+        namespaces = namespaces.is_a?(Set) ? namespaces.to_a : Array.wrap(namespaces)
+        namespaces += [:base] unless xargs.fetch(:exclusive, false)
+
+        possibilities = Array.wrap(key_or_name)
+        possibilities += Array.wrap(xargs[:fallback]) if xargs.key?(:fallback)
+
+        namespaces.uniq.find do |namespace|
+          possibilities.find do |item|
+            result = dig(namespace, xargs.fetch(:base_class, :Type), item)
+            return result.call unless result.nil?
+          end
+        end
+      ensure
+        skip_register.pop
+      end
+
+      # Checks if a given key or name is already defined under the same base
+      # class and namespace. If +exclusive+ is set to +false+, then it won't
+      # check the +:base+ namespace when not found on the given namespace.
+      def exist?(name_or_key, base_class: :Type, namespaces: :base, exclusive: false)
+        namespaces = namespaces.is_a?(Set) ? namespaces.to_a : Array.wrap(namespaces)
+        namespaces += [:base] unless exclusive
+        namespaces.uniq.any? { |namespace| dig(namespace, base_class, name_or_key).present? }
+      end
+
+      # Find if a given object is already defined. If +exclusive+ is set to
+      # +false+, then it won't check the +:base+ namespace
+      def object_exist?(object, **xargs)
+        xargs[:base_class] = find_base_class(object)
+        xargs[:namespaces] ||= object.namespaces
+        exist?(object, **xargs)
+      end
+
+      # Mark the given object to be registered later, when a fetch is triggered
+      # TODO: Improve this with a Backtracer Cleaner
+      def postpone_registration(object)
+        source = caller(3).find { |item| item !~ FILTER_REGISTER_TRACE }
+        @pending << [object, source]
+      end
+
+      # Register a given object, which must be a class where the namespaces and
+      # the base class can be inferred
+      def register(object)
+        namespaces = object.namespaces.dup
+        namespaces = namespaces.is_a?(Set) ? namespaces.to_a : Array.wrap(namespaces)
+
+        base_namespace = namespaces.shift || :base
+        base_class = find_base_class(object)
+        ensure_base_class!(base_class)
+
+        # Cache the name, the key, and the alias proc
+        object_name = object.gql_name
+        object_key = object.to_sym
+        alias_proc = -> do
+          fetch(object_key,
+            base_class: base_class,
+            namespaces: base_namespace,
+            exclusive: true,
+          )
+        end
+
+        # Register the main type object
+        add(base_namespace, base_class, object_key, -> { object })
+
+        # Register all the aliases plus the object name
+        aliases = object.try(:aliases) || []
+        [object_name, *aliases].each do |alias_name|
+          add(base_namespace, base_class, alias_name, alias_proc)
+        end
+
+        # For each remaining namespace, register a key and a name alias
+        namespaces.product([object_key, object_name, *aliases]) do |(namespace, key_or_name)|
+          add(namespace, base_class, key_or_name, alias_proc)
+        end
+
+        # Return the object for chain purposes
+        @objects += 1
+        object
+      end
+
+      # Register an item alias. Either provide a block that trigger the fetch
+      # method to return that item, or a key from the same namespace and base
+      # class
+      def register_alias(name_or_key, key = nil, **xargs, &block)
+        raise ArgumentError, <<~MSG.squish unless key.nil? ^ block.nil?
+          Provide either a key or a block in order to register an alias.
+        MSG
+
+        base_class = xargs.delete(:base_class) || :Type
+        ensure_base_class!(base_class)
+
+        namespaces = xargs.delete(:namespaces) || []
+        namespaces = namespaces.to_a if namespaces.is_a?(Set)
+        namespaces << xargs.delete(:namespace)
+
+        namespaces = namespaces.compact.presence || [:base]
+
+        block ||= -> do
+          fetch(key, base_class: base_class, namespaces: namespaces, exclusive: true)
+        end
+
+        namespaces.each { |ns| add(ns, base_class, name_or_key, block) }
+      end
+
+      # Iterate over the types of the given +base_class+ that are defined on the
+      # given +namespaces+.
+      def each_from(namespaces, base_class: :Type, exclusive: false, &block)
+        register_pending!
+
+        namespaces = namespaces.is_a?(Set) ? namespaces.to_a : Array.wrap(namespaces)
+        namespaces += [:base] unless namespaces.include?(:base) || exclusive
+
+        iterated = []
+        enumerator = Enumerator::Lazy.new(namespaces.uniq) do |yielder, *values|
+          next unless @index.key?(values.last)
+
+          # Only iterate over string based types
+          @index[values.last][base_class]&.each do |_key, value|
+            next if iterated.include?(value = value.call) || value.blank?
+            iterated << value
+            yielder << value
+          end
+        end
+
+        block.present? ? enumerator.each(&block) : enumerator
+      end
+
+      # Add a callback that will trigger when a type is registered under the
+      # given set of settings of this method
+      def after_register(name_or_key, base_class: :Type, namespaces: :base, &block)
+        item = fetch(name_or_key,
+          prevent_register: true,
+          base_class: base_class,
+          namespaces: namespaces,
+        )
+
+        return block.call(item) unless item.nil?
+
+        namespaces = namespaces.is_a?(Set) ? namespaces.to_a : Array.wrap(namespaces)
+        position = callbacks[name_or_key].size
+
+        callbacks[name_or_key] << ->(n, b, result) do
+          return unless b === base_class && namespaces.include?(n)
+          block.call(result)
+          position
+        end
+      end
+
+      def inspect # :nodoc:
+        <<~INFO.squish + '>'
+          #<Rails::GraphQL::TypeMap [index]
+            @namespaces=#{@index.size}
+            @base_classes=#{base_classes.size}
+            @objects=#{@objects}
+            @pending=#{@pending.size}
+        INFO
+      end
+
+      private
+
+        attr_reader :callbacks
+
+        # Add a item to the index and then trigger the callbacks if any
+        def add(namespace, base_class, key, raw_result)
+          @index[namespace][base_class][key] = raw_result
+          return unless callbacks.key?(key)
+
+          result = nil
+          removeables = callbacks[key].map do |callback|
+            callback.call(namespace, base_class, result ||= raw_result.call)
+          end
+
+          removeables.compact.reverse_each(&callbacks[key].method(:delete_at))
+          callbacks.delete(key) if callbacks[key].empty?
+        end
+
+        # A list of classes to prevent the registration, since they might be
+        # the source of a fetch
+        def skip_register
+          @skip_register ||= []
+        end
+
+        # Clear the pending list of classes to be registered
+        def register_pending!
+          return if @pending.blank?
+
+          skip = skip_register.flatten
+          keep = []
+          validate = []
+
+          while (klass, source = @pending.shift)
+            next if klass.registered?
+
+            if skip.include?(klass)
+              keep << [klass, source]
+            else
+              validate << klass.register!
+            end
+          end
+
+          validate.compact.each(&:call)
+        rescue DefinitionError => e
+          raise e.class, e.message + "\n  Defined at: #{source}"
+        ensure
+          @pending += keep unless keep.nil?
+        end
+
+        # Since concurrent map doesn't implement this method, use this to
+        # navigate through the index
+        def dig(*parts)
+          parts.inject(@index) do |h, key|
+            break unless h.key?(key)
+            h.fetch(key)
+          end
+        end
+
+        # Find the base class of an object, which is basically the class that
+        # doesn't inherit any other class (superclass is equal Object)
+        def find_base_class(object)
+          return object.base_type_class if object.respond_to?(:base_type_class)
+
+          base_class = object
+          base_class = base_class.superclass until base_class.superclass === Object
+          base_class.name.demodulize.to_sym
+        end
+
+        # Make sure that the given key is a valid base class key
+        def ensure_base_class!(key)
+          raise ArgumentError, <<~MSG.squish unless base_classes.keys.include?(key)
+            Unsupported base class "#{key.inspect}".
+          MSG
+        end
+    end
+  end
+end

data/lib/rails/graphql/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Rails # :nodoc:
+  module GraphQL # :nodoc:
+    VERSION = '0.1.0'
+  end
+end

data/test/assets/introspection-mem.txt

@@ -0,0 +1 @@
+{"data":{"__schema":{"queryType":{"name":"_Query"},"mutationType":{"name":"_Mutation"},"subscriptionType":{"name":"_Subscription"},"types":[{"kind":"ENUM","name":"Episode","description":"One of the films in the Star Wars Trilogy","fields":[],"inputFields":[],"interfaces":[],"enumValues":[{"name":"NEW_HOPE","description":"Released in 1977.","isDeprecated":false,"deprecationReason":null},{"name":"EMPIRE","description":"Released in 1980.","isDeprecated":false,"deprecationReason":null},{"name":"JEDI","description":"Released in 1983.","isDeprecated":false,"deprecationReason":null}],"possibleTypes":[]},{"kind":"INTERFACE","name":"Character","description":"A character in the Star Wars Trilogy","fields":[{"name":"id","description":"The id of the character","args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"ID","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"name","description":"The name of the character","args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"friends","description":"The friends of the character, or an empty list if they have none","args":[],"type":{"kind":"LIST","name":null,"ofType":{"kind":"INTERFACE","name":"Character","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"appearsIn","description":"Which movies they appear in","args":[],"type":{"kind":"LIST","name":null,"ofType":{"kind":"ENUM","name":"Episode","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"secretBackstory","description":"All secrets about their past","args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null}],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[{"kind":"OBJECT","name":"Human","ofType":null},{"kind":"OBJECT","name":"Droid","ofType":null}]},{"kind":"OBJECT","name":"Human","description":"A humanoid creature in the Star Wars universe","fields":[{"name":"id","description":"The id of the character","args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"ID","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"name","description":"The name of the character","args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"friends","description":"The friends of the character, or an empty list if they have none","args":[],"type":{"kind":"LIST","name":null,"ofType":{"kind":"INTERFACE","name":"Character","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"appearsIn","description":"Which movies they appear in","args":[],"type":{"kind":"LIST","name":null,"ofType":{"kind":"ENUM","name":"Episode","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"secretBackstory","description":"All secrets about their past","args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"homePlanet","description":"The home planet of the human, or null if unknown","args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null}],"inputFields":[],"interfaces":[{"kind":"INTERFACE","name":"Character","ofType":null}],"enumValues":[],"possibleTypes":[]},{"kind":"OBJECT","name":"Droid","description":"A mechanical creature in the Star Wars universe","fields":[{"name":"id","description":"The id of the character","args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"ID","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"name","description":"The name of the character","args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"friends","description":"The friends of the character, or an empty list if they have none","args":[],"type":{"kind":"LIST","name":null,"ofType":{"kind":"INTERFACE","name":"Character","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"appearsIn","description":"Which movies they appear in","args":[],"type":{"kind":"LIST","name":null,"ofType":{"kind":"ENUM","name":"Episode","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"secretBackstory","description":"All secrets about their past","args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"primaryFunction","description":"The primary function of the droid","args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null}],"inputFields":[],"interfaces":[{"kind":"INTERFACE","name":"Character","ofType":null}],"enumValues":[],"possibleTypes":[]},{"kind":"OBJECT","name":"_Query","description":null,"fields":[{"name":"__schema","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"OBJECT","name":"__Schema","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"__type","description":null,"args":[{"name":"name","description":null,"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"String","ofType":null}},"defaultValue":null}],"type":{"kind":"OBJECT","name":"__Type","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"hero","description":"Find the hero of the whole saga","args":[{"name":"episode","description":"Return for a specific episode","type":{"kind":"ENUM","name":"Episode","ofType":null},"defaultValue":null}],"type":{"kind":"INTERFACE","name":"Character","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"human","description":"Find a human character","args":[{"name":"id","description":"ID of the human","type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"ID","ofType":null}},"defaultValue":null}],"type":{"kind":"OBJECT","name":"Human","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"droid","description":"Find a droid character","args":[{"name":"id","description":"ID of the droid","type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"ID","ofType":null}},"defaultValue":null}],"type":{"kind":"OBJECT","name":"Droid","ofType":null},"isDeprecated":false,"deprecationReason":null}],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"OBJECT","name":"_Mutation","description":null,"fields":[{"name":"changeHuman","description":"Change the episodes of a human and return a set of characters","args":[{"name":"id","description":"The ID of the human to be changed","type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"ID","ofType":null}},"defaultValue":null},{"name":"episodes","description":null,"type":{"kind":"LIST","name":null,"ofType":{"kind":"NON_NULL","name":null,"ofType":{"kind":"ENUM","name":"Episode","ofType":null}}},"defaultValue":null}],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"LIST","name":null,"ofType":{"kind":"NON_NULL","name":null,"ofType":{"kind":"INTERFACE","name":"Character","ofType":null}}}},"isDeprecated":false,"deprecationReason":null}],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"ENUM","name":"__TypeKind","description":"The fundamental unit of any GraphQL Schema is the type.\nThis enum enlist all the valid base types.","fields":[],"inputFields":[],"interfaces":[],"enumValues":[{"name":"SCALAR","description":"Scalar types represent primitive leaf values in a GraphQL type system.\n","isDeprecated":false,"deprecationReason":null},{"name":"OBJECT","description":"Objects represent a list of named fields, each of which yield a value of a\nspecific type.\n","isDeprecated":false,"deprecationReason":null},{"name":"INTERFACE","description":"Interfaces represent a list of named fields and their types.\n","isDeprecated":false,"deprecationReason":null},{"name":"UNION","description":"Unions represent an object that could be one of a list of GraphQL Object types.\n","isDeprecated":false,"deprecationReason":null},{"name":"ENUM","description":"Enum types, like scalar types, also represent leaf values in a GraphQL\ntype system. However Enum types describe the set of possible values.\n","isDeprecated":false,"deprecationReason":null},{"name":"INPUT_OBJECT","description":"Objects represent a list of named fields, each of which yield a value of\na specific type.\n","isDeprecated":false,"deprecationReason":null},{"name":"LIST","description":"A GraphQL list is a special collection type which declares the type of\neach item in the List (referred to as the item type of the list).\n","isDeprecated":false,"deprecationReason":null},{"name":"NON_NULL","description":"This type wraps an underlying type, and this type acts identically to that wrapped\ntype, with the exception that null is not a valid response for the wrapping type.\n","isDeprecated":false,"deprecationReason":null}],"possibleTypes":[]},{"kind":"OBJECT","name":"__Directive","description":"Directives provide a way to describe alternate runtime execution\nand type validation behavior in a GraphQL document.\n\nIn some cases, you need to provide options to alter GraphQL’s execution\nbehavior in ways field arguments will not suffice, such as conditionally\nincluding or skipping a field. Directives provide this by describing\nadditional information to the executor.","fields":[{"name":"name","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"String","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"description","description":null,"args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"locations","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"LIST","name":null,"ofType":{"kind":"NON_NULL","name":null,"ofType":{"kind":"ENUM","name":"__DirectiveLocation","ofType":null}}}},"isDeprecated":false,"deprecationReason":null},{"name":"args","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"LIST","name":null,"ofType":{"kind":"NON_NULL","name":null,"ofType":{"kind":"OBJECT","name":"__InputValue","ofType":null}}}},"isDeprecated":false,"deprecationReason":null}],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"OBJECT","name":"__EnumValue","description":"One of the values of an Enum object. It is unique within the Enum set\nof values. It's a string representation, not a numeric representation,\nof a value kept as all caps (ie. ONE_VALUE).","fields":[{"name":"name","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"String","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"description","description":null,"args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"isDeprecated","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"Boolean","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"deprecationReason","description":null,"args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null}],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"OBJECT","name":"__Field","description":"Fields are the elements that compose both Objects and Interfaces. Each\nfield in these other objects may contain arguments and always yields\na value of a specific type.","fields":[{"name":"name","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"String","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"description","description":null,"args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"args","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"LIST","name":null,"ofType":{"kind":"NON_NULL","name":null,"ofType":{"kind":"OBJECT","name":"__InputValue","ofType":null}}}},"isDeprecated":false,"deprecationReason":null},{"name":"type","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"OBJECT","name":"__Type","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"isDeprecated","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"Boolean","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"deprecationReason","description":null,"args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null}],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"OBJECT","name":"__InputValue","description":"Alongside with scalars and enums, input value objects allow the user\nto provide values to arguments on fields and directives. Different\nfrom those, input values accepts a list of keyed values, instead of\na single value.","fields":[{"name":"name","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"String","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"description","description":null,"args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"type","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"OBJECT","name":"__Type","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"defaultValue","description":null,"args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null}],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"OBJECT","name":"__Schema","description":"A GraphQL service’s collective type system capabilities are referred\nto as that service’s \"schema\". A schema is defined in terms of the\ntypes and directives it supports as well as the root operation types\nfor each kind of operation: query, mutation, and subscription; this\ndetermines the place in the type system where those operations begin.","fields":[{"name":"types","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"LIST","name":null,"ofType":{"kind":"NON_NULL","name":null,"ofType":{"kind":"OBJECT","name":"__Type","ofType":null}}}},"isDeprecated":false,"deprecationReason":null},{"name":"queryType","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"OBJECT","name":"__Type","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"mutationType","description":null,"args":[],"type":{"kind":"OBJECT","name":"__Type","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"subscriptionType","description":null,"args":[],"type":{"kind":"OBJECT","name":"__Type","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"directives","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"LIST","name":null,"ofType":{"kind":"NON_NULL","name":null,"ofType":{"kind":"OBJECT","name":"__Directive","ofType":null}}}},"isDeprecated":false,"deprecationReason":null}],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"OBJECT","name":"__Type","description":"The fundamental unit of any GraphQL Schema is the type. There are six\nkinds of named type definitions in GraphQL, and two wrapping types.\n\nThe most basic type is a +Scalar+. A scalar represents a primitive value,\nlike a string or an integer.\n\n+Scalars+ and +Enums+ form the leaves in response trees; the intermediate\nlevels are +Object+ types, which define a set of fields.\n\nAn +Interface+ defines a list of fields; +Object+ types that implement\nthat interface are guaranteed to implement those fields.\n\nA +Union+ defines a list of possible types; similar to interfaces,\nwhenever the type system claims a union will be returned, one of the\npossible types will be returned.\n\nFinally, oftentimes it is useful to provide complex structs as inputs\nto GraphQL field arguments or variables; the +Input Object+ type allows\nthe schema to define exactly what data is expected.","fields":[{"name":"kind","description":null,"args":[],"type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"ENUM","name":"__TypeKind","ofType":null}},"isDeprecated":false,"deprecationReason":null},{"name":"name","description":null,"args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"description","description":null,"args":[],"type":{"kind":"SCALAR","name":"String","ofType":null},"isDeprecated":false,"deprecationReason":null},{"name":"fields","description":"OBJECT and INTERFACE only","args":[{"name":"includeDeprecated","description":null,"type":{"kind":"SCALAR","name":"Boolean","ofType":null},"defaultValue":"false"}],"type":{"kind":"LIST","name":null,"ofType":{"kind":"NON_NULL","name":null,"ofType":{"kind":"OBJECT","name":"__Field","ofType":null}}},"isDeprecated":false,"deprecationReason":null},{"name":"interfaces","description":"OBJECT only","args":[],"type":{"kind":"LIST","name":null,"ofType":{"kind":"NON_NULL","name":null,"ofType":{"kind":"OBJECT","name":"__Type","ofType":null}}},"isDeprecated":false,"deprecationReason":null},{"name":"possibleTypes","description":"INTERFACE and UNION only","args":[],"type":{"kind":"LIST","name":null,"ofType":{"kind":"NON_NULL","name":null,"ofType":{"kind":"OBJECT","name":"__Type","ofType":null}}},"isDeprecated":false,"deprecationReason":null},{"name":"enumValues","description":"ENUM only","args":[{"name":"includeDeprecated","description":null,"type":{"kind":"SCALAR","name":"Boolean","ofType":null},"defaultValue":"false"}],"type":{"kind":"LIST","name":null,"ofType":{"kind":"NON_NULL","name":null,"ofType":{"kind":"OBJECT","name":"__EnumValue","ofType":null}}},"isDeprecated":false,"deprecationReason":null},{"name":"inputFields","description":"INPUT_OBJECT only","args":[],"type":{"kind":"LIST","name":null,"ofType":{"kind":"NON_NULL","name":null,"ofType":{"kind":"OBJECT","name":"__InputValue","ofType":null}}},"isDeprecated":false,"deprecationReason":null},{"name":"ofType","description":"NON_NULL and LIST only","args":[],"type":{"kind":"OBJECT","name":"__Type","ofType":null},"isDeprecated":false,"deprecationReason":null}],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"SCALAR","name":"String","description":"The String scalar type represents textual data, represented as UTF‐8 character\nsequences.","fields":[],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"SCALAR","name":"Boolean","description":"The Boolean scalar type represents true or false.","fields":[],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"SCALAR","name":"ID","description":"The ID scalar type represents a unique identifier and it is serialized in the same\nway as a String but it accepts both numeric and string based values as input.","fields":[],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"SCALAR","name":"Bigint","description":"The Bigint scalar type represents a signed numeric non‐fractional value.\nIt can go beyond the Int 32‐bit limit, but it's exchanged as a string.","fields":[],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"SCALAR","name":"Binary","description":"The Binary scalar type represents a Base64 string.\nNormally used to share files and uploads.","fields":[],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"SCALAR","name":"Date","description":"The Date scalar type represents a ISO 8601 string value.","fields":[],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"SCALAR","name":"DateTime","description":"The DateTime scalar type represents a ISO 8601 string value.","fields":[],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"SCALAR","name":"Decimal","description":"The Decimal scalar type represents signed fractional values with extra precision.\nThe values are exchange as string.","fields":[],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"SCALAR","name":"Time","description":"The Time scalar type that represents a distance in time using hours,\nminutes, seconds, and miliseconds.","fields":[],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"ENUM","name":"__DirectiveLocation","description":"The valid locations that a directive may be placed.","fields":[],"inputFields":[],"interfaces":[],"enumValues":[{"name":"QUERY","description":"Mark as a executable directive usable on query objects.","isDeprecated":false,"deprecationReason":null},{"name":"MUTATION","description":"Mark as a executable directive usable on mutation objects.","isDeprecated":false,"deprecationReason":null},{"name":"SUBSCRIPTION","description":"Mark as a executable directive usable on subscription objects.","isDeprecated":false,"deprecationReason":null},{"name":"FIELD","description":"Mark as a executable directive usable on field objects.","isDeprecated":false,"deprecationReason":null},{"name":"FRAGMENT_DEFINITION","description":"Mark as a executable directive usable on fragment definition objects.","isDeprecated":false,"deprecationReason":null},{"name":"FRAGMENT_SPREAD","description":"Mark as a executable directive usable on fragment spread objects.","isDeprecated":false,"deprecationReason":null},{"name":"INLINE_FRAGMENT","description":"Mark as a executable directive usable on inline fragment objects.","isDeprecated":false,"deprecationReason":null},{"name":"SCHEMA","description":"Mark as a type system directive usable on schema definitions.","isDeprecated":false,"deprecationReason":null},{"name":"SCALAR","description":"Mark as a type system directive usable on scalar definitions.","isDeprecated":false,"deprecationReason":null},{"name":"OBJECT","description":"Mark as a type system directive usable on object definitions.","isDeprecated":false,"deprecationReason":null},{"name":"FIELD_DEFINITION","description":"Mark as a type system directive usable on field definitions.","isDeprecated":false,"deprecationReason":null},{"name":"ARGUMENT_DEFINITION","description":"Mark as a type system directive usable on argument definitions.","isDeprecated":false,"deprecationReason":null},{"name":"INTERFACE","description":"Mark as a type system directive usable on interface definitions.","isDeprecated":false,"deprecationReason":null},{"name":"UNION","description":"Mark as a type system directive usable on union definitions.","isDeprecated":false,"deprecationReason":null},{"name":"ENUM","description":"Mark as a type system directive usable on enum definitions.","isDeprecated":false,"deprecationReason":null},{"name":"ENUM_VALUE","description":"Mark as a type system directive usable on enum value definitions.","isDeprecated":false,"deprecationReason":null},{"name":"INPUT_OBJECT","description":"Mark as a type system directive usable on input object definitions.","isDeprecated":false,"deprecationReason":null},{"name":"INPUT_FIELD_DEFINITION","description":"Mark as a type system directive usable on input field definitions.","isDeprecated":false,"deprecationReason":null}],"possibleTypes":[]},{"kind":"SCALAR","name":"Int","description":"The Int scalar type represents a signed 32‐bit numeric non‐fractional value.","fields":[],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]},{"kind":"SCALAR","name":"Float","description":"The Float scalar type represents signed double‐precision fractional values.","fields":[],"inputFields":[],"interfaces":[],"enumValues":[],"possibleTypes":[]}],"directives":[{"name":"deprecated","description":"Indicate deprecated portions of a GraphQL service’s schema, such as deprecated\nfields on a type or deprecated enum values.","locations":["FIELD_DEFINITION","ENUM_VALUE"],"args":[{"name":"reason","description":"Explain why the underlying element was marked as deprecated. If possible,\nindicate what element should be used instead. This description is formatted\nusing Markdown syntax (as specified by [CommonMark](http://commonmark.org/)).","type":{"kind":"SCALAR","name":"String","ofType":null},"defaultValue":null}]},{"name":"include","description":"Allows for conditional inclusion during execution as described by the if argument.","locations":["FIELD","FRAGMENT_SPREAD","INLINE_FRAGMENT"],"args":[{"name":"if","description":"When false, the underlying element will be automatically marked as null.","type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"Boolean","ofType":null}},"defaultValue":null}]},{"name":"skip","description":"Allows for conditional exclusion during execution as described by the if argument.","locations":["FIELD","FRAGMENT_SPREAD","INLINE_FRAGMENT"],"args":[{"name":"if","description":"When true, the underlying element will be automatically marked as null.","type":{"kind":"NON_NULL","name":null,"ofType":{"kind":"SCALAR","name":"Boolean","ofType":null}},"defaultValue":null}]}]}}}

data/test/assets/introspection.gql

@@ -0,0 +1,91 @@
+query IntrospectionQuery {
+  __schema {
+    queryType { name }
+    mutationType { name }
+    subscriptionType { name }
+    types {
+      ...FullType
+    }
+    directives {
+      name
+      description
+      locations
+      args {
+        ...InputValue
+      }
+    }
+  }
+}
+
+fragment FullType on __Type {
+  kind
+  name
+  description
+  fields(includeDeprecated: true) {
+    name
+    description
+    args {
+      ...InputValue
+    }
+    type {
+      ...TypeRef
+    }
+    isDeprecated
+    deprecationReason
+  }
+  inputFields {
+    ...InputValue
+  }
+  interfaces {
+    ...TypeRef
+  }
+  enumValues(includeDeprecated: true) {
+    name
+    description
+    isDeprecated
+    deprecationReason
+  }
+  possibleTypes {
+    ...TypeRef
+  }
+}
+
+fragment InputValue on __InputValue {
+  name
+  description
+  type { ...TypeRef }
+  defaultValue
+}
+
+fragment TypeRef on __Type {
+  kind
+  name
+  ofType {
+    kind
+    name
+    ofType {
+      kind
+      name
+      ofType {
+        kind
+        name
+        ofType {
+          kind
+          name
+          ofType {
+            kind
+            name
+            ofType {
+              kind
+              name
+              ofType {
+                kind
+                name
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}