graphql-core 3.2.7__tar.gz → 3.2.9__tar.gz

{graphql_core-3.2.7 → graphql_core-3.2.9}/.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 3.2.7
+current_version = 3.2.9
 commit = False
 tag = False
 

{graphql_core-3.2.7 → graphql_core-3.2.9}/.readthedocs.yaml

@@ -5,9 +5,9 @@
 version: 2
 
 build:
-  os: ubuntu-20.04
+  os: ubuntu-24.04
   tools:
-    python: "3.9"
+    python: "3.12"
 
 sphinx:
    configuration: docs/conf.py

{graphql_core-3.2.7 → graphql_core-3.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphql-core
-Version: 3.2.7
+Version: 3.2.9
 Summary: GraphQL implementation for Python, a port of GraphQL.js, the JavaScript reference implementation for GraphQL.
 Home-page: https://github.com/graphql-python/graphql-core
 Author: Christoph Zwerschke
@@ -50,7 +50,7 @@ a query language for APIs created by Facebook.
 ![Lint Status](https://github.com/graphql-python/graphql-core/actions/workflows/lint.yml/badge.svg)
 [![Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
 
-The current version 3.2.7 of GraphQL-core is up-to-date with GraphQL.js version 16.9.0.
+The current version 3.2.9 of GraphQL-core is up-to-date with GraphQL.js version 16.10.0.
 
 An extensive test suite with over 2500 unit tests and 100% coverage comprises a
 replication of the complete test suite of GraphQL.js, making sure this port is

{graphql_core-3.2.7 → graphql_core-3.2.9}/README.md

@@ -10,7 +10,7 @@ a query language for APIs created by Facebook.
 ![Lint Status](https://github.com/graphql-python/graphql-core/actions/workflows/lint.yml/badge.svg)
 [![Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
 
-The current version 3.2.7 of GraphQL-core is up-to-date with GraphQL.js version 16.9.0.
+The current version 3.2.9 of GraphQL-core is up-to-date with GraphQL.js version 16.10.0.
 
 An extensive test suite with over 2500 unit tests and 100% coverage comprises a
 replication of the complete test suite of GraphQL.js, making sure this port is

{graphql_core-3.2.7 → graphql_core-3.2.9}/docs/conf.py

@@ -51,7 +51,7 @@ master_doc = "index"
 
 # General information about the project.
 project = "GraphQL-core 3"
-copyright = "2025, Christoph Zwerschke"
+copyright = "2026, Christoph Zwerschke"
 author = "Christoph Zwerschke"
 
 # The version info for the project you're documenting, acts as replacement for
@@ -61,7 +61,7 @@ author = "Christoph Zwerschke"
 # The short X.Y version.
 # version = '3.2'
 # The full version, including alpha/beta/rc tags.
-version = release = "3.2.7"
+version = release = "3.2.9"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -139,6 +139,8 @@ graphql_classes = {
 ignore_references = set(
     """
 GNT GT KT T VT
+_asyncio.Future
+asyncio.queues.Queue
 enum.Enum
 traceback
 types.TracebackType
@@ -146,6 +148,7 @@ EnterLeaveVisitor
 FormattedSourceLocation
 GraphQLAbstractType
 GraphQLErrorExtensions
+GraphQLFormattedErrorExtensions
 GraphQLOutputType
 asyncio.events.AbstractEventLoop
 graphql.execution.map_async_iterator.MapAsyncIterator

graphql_core-3.2.9/docs/requirements.txt

@@ -0,0 +1,2 @@
+sphinx>=9.1,<10
+sphinx_rtd_theme>=3.1,<4

{graphql_core-3.2.7 → graphql_core-3.2.9}/docs/usage/introspection.rst

@@ -28,7 +28,7 @@ The ``data`` attribute of the introspection query result now gives us a dictiona
 which constitutes a third way of describing a GraphQL schema::
 
     {'__schema': {
-        'queryType': {'name': 'Query'},
+        'queryType': {'name': 'Query', 'kind': 'OBJECT'},
         'mutationType': None, 'subscriptionType': None,
         'types': [
             {'kind': 'OBJECT', 'name': 'Query', 'description': None,

{graphql_core-3.2.7 → graphql_core-3.2.9}/poetry.lock

@@ -1,4 +1,4 @@
-# This file is automatically @generated by Poetry 2.2.1 and should not be changed by hand.
+# This file is automatically @generated by Poetry 2.3.2 and should not be changed by hand.
 
 [[package]]
 name = "typing-extensions"

{graphql_core-3.2.7 → graphql_core-3.2.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "graphql-core"
-version = "3.2.7"
+version = "3.2.9"
 description = """
 GraphQL-core is a Python port of GraphQL.js,\
  the JavaScript reference implementation for GraphQL."""
@@ -87,5 +87,5 @@ disable = [
 ]
 
 [build-system]
-requires = ["poetry_core>=1,<3", "setuptools>=59,<81"]
+requires = ["poetry_core>=1,<3", "setuptools>=59,<83"]
 build-backend = "poetry.core.masonry.api"

{graphql_core-3.2.7 → graphql_core-3.2.9}/src/graphql/__init__.py

@@ -48,6 +48,7 @@ from .error import (
     GraphQLError,
     GraphQLErrorExtensions,
     GraphQLFormattedError,
+    GraphQLFormattedErrorExtensions,
     GraphQLSyntaxError,
     located_error,
 )
@@ -748,6 +749,7 @@ __all__ = [
     "GraphQLError",
     "GraphQLErrorExtensions",
     "GraphQLFormattedError",
+    "GraphQLFormattedErrorExtensions",
     "GraphQLSyntaxError",
     "located_error",
     "get_introspection_query",

{graphql_core-3.2.7 → graphql_core-3.2.9}/src/graphql/error/__init__.py

@@ -4,7 +4,12 @@ The :mod:`graphql.error` package is responsible for creating and formatting Grap
 errors.
 """
 
-from .graphql_error import GraphQLError, GraphQLErrorExtensions, GraphQLFormattedError
+from .graphql_error import (
+    GraphQLError,
+    GraphQLErrorExtensions,
+    GraphQLFormattedError,
+    GraphQLFormattedErrorExtensions,
+)
 
 from .syntax_error import GraphQLSyntaxError
 
@@ -14,6 +19,7 @@ __all__ = [
     "GraphQLError",
     "GraphQLErrorExtensions",
     "GraphQLFormattedError",
+    "GraphQLFormattedErrorExtensions",
     "GraphQLSyntaxError",
     "located_error",
 ]

{graphql_core-3.2.7 → graphql_core-3.2.9}/src/graphql/error/graphql_error.py

@@ -14,7 +14,12 @@ if TYPE_CHECKING:
     )  # noqa: F401
     from ..language.source import Source  # noqa: F401
 
-__all__ = ["GraphQLError", "GraphQLErrorExtensions", "GraphQLFormattedError"]
+__all__ = [
+    "GraphQLError",
+    "GraphQLErrorExtensions",
+    "GraphQLFormattedError",
+    "GraphQLFormattedErrorExtensions",
+]
 
 
 # Custom extensions
@@ -25,6 +30,14 @@ GraphQLErrorExtensions = Dict[str, Any]
 # a dictionary which can contain all the values you need.
 
 
+# Custom formatted extensions
+GraphQLFormattedErrorExtensions = Dict[str, Any]
+# Use a unique identifier name for your extension, for example the name of
+# your library or project. Do not use a shortened identifier as this increases
+# the risk of conflicts. We recommend you add at most one extension key,
+# a dictionary which can contain all the values you need.
+
+
 class GraphQLFormattedError(TypedDict, total=False):
     """Formatted GraphQL error"""
 
@@ -41,7 +54,7 @@ class GraphQLFormattedError(TypedDict, total=False):
     path: List[Union[str, int]]
     # Reserved for implementors to extend the protocol however they see fit,
     # and hence there are no additional restrictions on its contents.
-    extensions: GraphQLErrorExtensions
+    extensions: GraphQLFormattedErrorExtensions
 
 
 class GraphQLError(Exception):

{graphql_core-3.2.7 → graphql_core-3.2.9}/src/graphql/language/ast.py

@@ -411,6 +411,11 @@ class DocumentNode(Node):
     __slots__ = ("definitions",)
 
     definitions: Tuple["DefinitionNode", ...]
+    # The number of tokens in the parsed document. Set by the parser per instance
+    # and deliberately kept out of ``__slots__`` (and therefore out of ``keys``) so
+    # that it is not treated as a traversable attribute, the equivalent of the
+    # non-enumerable ``tokenCount`` property in graphql-js.
+    token_count: int = 0
 
 
 class DefinitionNode(Node):

{graphql_core-3.2.7 → graphql_core-3.2.9}/src/graphql/language/parser.py

@@ -234,13 +234,21 @@ class Parser:
 
     # Implement the parsing rules in the Document section.
 
+    @property
+    def token_count(self) -> int:
+        """Get the number of tokens that have been parsed so far."""
+        return self._token_counter
+
     def parse_document(self) -> DocumentNode:
         """Document: Definition+"""
         start = self._lexer.token
-        return DocumentNode(
+        document = DocumentNode(
             definitions=self.many(TokenKind.SOF, self.parse_definition, TokenKind.EOF),
             loc=self.loc(start),
         )
+        # Expose the token count as a (non-traversable) attribute on the document.
+        document.token_count = self.token_count
+        return document
 
     _parse_type_system_definition_method_names: Dict[str, str] = {
         "schema": "schema_definition",
@@ -1177,12 +1185,12 @@ class Parser:
         return nodes
 
     def advance_lexer(self) -> None:
-        max_tokens = self._max_tokens
         token = self._lexer.advance()
 
-        if max_tokens is not None and token.kind != TokenKind.EOF:
+        if token.kind != TokenKind.EOF:
             self._token_counter += 1
-            if self._token_counter > max_tokens:
+            max_tokens = self._max_tokens
+            if max_tokens is not None and self._token_counter > max_tokens:
                 raise GraphQLSyntaxError(
                     self._lexer.source,
                     token.start,

{graphql_core-3.2.7 → graphql_core-3.2.9}/src/graphql/language/print_location.py

@@ -5,7 +5,6 @@ from .ast import Location
 from .location import SourceLocation, get_location
 from .source import Source
 
-
 __all__ = ["print_location", "print_source_location"]
 
 

{graphql_core-3.2.7 → graphql_core-3.2.9}/src/graphql/pyutils/description.py

@@ -1,4 +1,4 @@
-from typing import Any, Tuple, Union
+from typing import Any, Tuple, Type, Union
 
 __all__ = [
     "Description",
@@ -17,14 +17,14 @@ class Description:
     If you register(object), any object will be allowed as description.
     """
 
-    bases: Union[type, Tuple[type, ...]] = str
+    bases: Union[Type[Any], Tuple[Type[Any], ...]] = str
 
     @classmethod
     def isinstance(cls, obj: Any) -> bool:
         return isinstance(obj, cls.bases)
 
     @classmethod
-    def register(cls, base: type) -> None:
+    def register(cls, base: Type[Any]) -> None:
         """Register a class that shall be accepted as a description."""
         if not isinstance(base, type):
             raise TypeError("Only types can be registered.")
@@ -39,7 +39,7 @@ class Description:
             cls.bases += (base,)
 
     @classmethod
-    def unregister(cls, base: type) -> None:
+    def unregister(cls, base: Type[Any]) -> None:
         """Unregister a class that shall no more be accepted as a description."""
         if not isinstance(base, type):
             raise TypeError("Only types can be unregistered.")

{graphql_core-3.2.7 → graphql_core-3.2.9}/src/graphql/type/introspection.py

@@ -390,6 +390,9 @@ class TypeFields(GraphQLFieldMap):
         return type_.is_one_of if is_input_object_type(type_) else None
 
 
+TypeResolvers = TypeFields  # for backward compatibility
+
+
 _Type: GraphQLObjectType = GraphQLObjectType(
     name="__Type",
     description="The fundamental unit of any GraphQL Schema is the type."

{graphql_core-3.2.7 → graphql_core-3.2.9}/src/graphql/type/validate.py

@@ -154,6 +154,12 @@ class SchemaValidationContext:
             # Ensure they are named correctly.
             self.validate_name(directive)
 
+            if not directive.locations:
+                self.report_error(
+                    f"Directive @{directive.name} must include 1 or more locations.",
+                    directive.ast_node,
+                )
+
             # Ensure the arguments are valid.
             for arg_name, arg in directive.args.items():
                 # Ensure they are named correctly.
@@ -583,7 +589,8 @@ class InputObjectCircularRefsValidator:
 
 
 def get_all_implements_interface_nodes(
-    type_: Union[GraphQLObjectType, GraphQLInterfaceType], iface: GraphQLInterfaceType
+    type_: Union[GraphQLObjectType, GraphQLInterfaceType],
+    iface: Union[GraphQLObjectType, GraphQLInterfaceType],
 ) -> List[NamedTypeNode]:
     ast_node = type_.ast_node
     nodes = type_.extension_ast_nodes

{graphql_core-3.2.7 → graphql_core-3.2.9}/src/graphql/utilities/get_introspection_query.py

@@ -51,14 +51,13 @@ def get_introspection_query(
     def input_deprecation(string: str) -> Optional[str]:
         return string if input_value_deprecation else ""
 
-    return dedent(
-        f"""
+    return dedent(f"""
         query IntrospectionQuery {{
           __schema {{
             {maybe_schema_description}
-            queryType {{ name }}
-            mutationType {{ name }}
-            subscriptionType {{ name }}
+            queryType {{ name kind }}
+            mutationType {{ name kind }}
+            subscriptionType {{ name kind }}
             types {{
               ...FullType
             }}
@@ -158,8 +157,7 @@ def get_introspection_query(
             }}
           }}
         }}
-        """
-    )
+        """)
 
 
 # Unfortunately, the following type definitions are a bit simplistic

{graphql_core-3.2.7 → graphql_core-3.2.9}/src/graphql/utilities/lexicographic_sort_schema.py

@@ -92,13 +92,13 @@ def lexicographic_sort_schema(schema: GraphQLSchema) -> GraphQLSchema:
     ) -> Dict[str, GraphQLInputField]:
         return {
             name: GraphQLInputField(
-                cast(
-                    GraphQLInputType, replace_type(cast(GraphQLNamedType, field.type))
-                ),
-                description=field.description,
-                default_value=field.default_value,
-                extensions=field.extensions,
-                ast_node=field.ast_node,
+                **merge_kwargs(
+                    field.to_kwargs(),
+                    type_=cast(
+                        GraphQLInputType,
+                        replace_type(cast(GraphQLNamedType, field.type)),
+                    ),
+                )
             )
             for name, field in sorted(fields_map.items())
         }
@@ -169,20 +169,24 @@ def lexicographic_sort_schema(schema: GraphQLSchema) -> GraphQLSchema:
     }
 
     return GraphQLSchema(
-        types=type_map.values(),
-        directives=[
-            sort_directive(directive)
-            for directive in sorted(schema.directives, key=sort_by_name_key)
-        ],
-        query=cast(Optional[GraphQLObjectType], replace_maybe_type(schema.query_type)),
-        mutation=cast(
-            Optional[GraphQLObjectType], replace_maybe_type(schema.mutation_type)
-        ),
-        subscription=cast(
-            Optional[GraphQLObjectType], replace_maybe_type(schema.subscription_type)
-        ),
-        extensions=schema.extensions,
-        ast_node=schema.ast_node,
+        **merge_kwargs(
+            schema.to_kwargs(),
+            types=type_map.values(),
+            directives=[
+                sort_directive(directive)
+                for directive in sorted(schema.directives, key=sort_by_name_key)
+            ],
+            query=cast(
+                Optional[GraphQLObjectType], replace_maybe_type(schema.query_type)
+            ),
+            mutation=cast(
+                Optional[GraphQLObjectType], replace_maybe_type(schema.mutation_type)
+            ),
+            subscription=cast(
+                Optional[GraphQLObjectType],
+                replace_maybe_type(schema.subscription_type),
+            ),
+        )
     )
 
 

{graphql_core-3.2.7 → graphql_core-3.2.9}/src/graphql/utilities/type_comparators.py

@@ -29,12 +29,12 @@ def is_equal_type(type_a: GraphQLType, type_b: GraphQLType) -> bool:
     # If either type is non-null, the other must also be non-null.
     if is_non_null_type(type_a) and is_non_null_type(type_b):
         # noinspection PyUnresolvedReferences
-        return is_equal_type(type_a.of_type, type_b.of_type)  # type:ignore
+        return is_equal_type(type_a.of_type, type_b.of_type)  # type: ignore
 
     # If either type is a list, the other must also be a list.
     if is_list_type(type_a) and is_list_type(type_b):
         # noinspection PyUnresolvedReferences
-        return is_equal_type(type_a.of_type, type_b.of_type)  # type:ignore
+        return is_equal_type(type_a.of_type, type_b.of_type)  # type: ignore
 
     # Otherwise the types are not equal.
     return False