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

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

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

{graphql_core-3.2.9 → graphql_core-3.2.11}/.mypy.ini

@@ -1,5 +1,5 @@
 [mypy]
-python_version = 3.9
+python_version = 3.10
 check_untyped_defs = True
 no_implicit_optional = True
 strict_optional = True

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphql-core
-Version: 3.2.9
+Version: 3.2.11
 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.9 of GraphQL-core is up-to-date with GraphQL.js version 16.10.0.
+The current version 3.2.11 of GraphQL-core is up-to-date with GraphQL.js version 16.14.1.
 
 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.9 → graphql_core-3.2.11}/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.9 of GraphQL-core is up-to-date with GraphQL.js version 16.10.0.
+The current version 3.2.11 of GraphQL-core is up-to-date with GraphQL.js version 16.14.1.
 
 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.9 → graphql_core-3.2.11}/docs/conf.py

@@ -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.9"
+version = release = "3.2.11"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -151,6 +151,7 @@ GraphQLErrorExtensions
 GraphQLFormattedErrorExtensions
 GraphQLOutputType
 asyncio.events.AbstractEventLoop
+graphql.execution.execute.CollectedErrors
 graphql.execution.map_async_iterator.MapAsyncIterator
 graphql.language.lexer.EscapeSequence
 graphql.language.visitor.EnterLeaveVisitor

{graphql_core-3.2.9 → graphql_core-3.2.11}/docs/modules/language.rst

@@ -25,6 +25,7 @@ Each kind of AST node has its own class:
 .. autoclass:: ConstValueNode
 .. autoclass:: DefinitionNode
 .. autoclass:: DirectiveDefinitionNode
+.. autoclass:: DirectiveExtensionNode
 .. autoclass:: DirectiveNode
 .. autoclass:: DocumentNode
 .. autoclass:: EnumTypeDefinitionNode
@@ -75,6 +76,15 @@ Each kind of AST node has its own class:
 .. autoclass:: VariableDefinitionNode
 .. autoclass:: VariableNode
 
+Schema coordinates are represented using the following node classes:
+
+.. autoclass:: SchemaCoordinateNode
+.. autoclass:: TypeCoordinateNode
+.. autoclass:: MemberCoordinateNode
+.. autoclass:: ArgumentCoordinateNode
+.. autoclass:: DirectiveCoordinateNode
+.. autoclass:: DirectiveArgumentCoordinateNode
+
 Directive locations are specified using the following enumeration:
 
 .. autoclass:: DirectiveLocation
@@ -91,6 +101,7 @@ You can also check the type of nodes with the following predicates:
 .. autofunction:: is_type_definition_node
 .. autofunction:: is_type_system_extension_node
 .. autofunction:: is_type_extension_node
+.. autofunction:: is_schema_coordinate_node
 
 Lexer
 -----
@@ -116,6 +127,7 @@ Parser
 .. autofunction:: parse_type
 .. autofunction:: parse_value
 .. autofunction:: parse_const_value
+.. autofunction:: parse_schema_coordinate
 
 Printer
 -------

{graphql_core-3.2.9 → graphql_core-3.2.11}/docs/modules/utilities.rst

@@ -112,3 +112,17 @@ Compare two GraphQLSchemas and detect breaking changes:
 .. autoclass:: BreakingChangeType
 .. autoclass:: DangerousChange
 .. autoclass:: DangerousChangeType
+
+Resolve a schema coordinate to the schema element it refers to:
+
+.. autofunction:: resolve_schema_coordinate
+.. autofunction:: resolve_ast_schema_coordinate
+
+.. autoclass:: ResolvedNamedType
+.. autoclass:: ResolvedField
+.. autoclass:: ResolvedInputField
+.. autoclass:: ResolvedEnumValue
+.. autoclass:: ResolvedFieldArgument
+.. autoclass:: ResolvedDirective
+.. autoclass:: ResolvedDirectiveArgument
+.. autoclass:: ResolvedSchemaElement

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

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

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

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "graphql-core"
-version = "3.2.9"
+version = "3.2.11"
 description = """
 GraphQL-core is a Python port of GraphQL.js,\
  the JavaScript reference implementation for GraphQL."""

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

@@ -68,6 +68,7 @@ from .language import (
     parse_value,
     parse_const_value,
     parse_type,
+    parse_schema_coordinate,
     # Print
     print_ast,
     # Visit
@@ -92,6 +93,7 @@ from .language import (
     is_type_definition_node,
     is_type_system_extension_node,
     is_type_extension_node,
+    is_schema_coordinate_node,
     # Types
     SourceLocation,
     Location,
@@ -158,6 +160,14 @@ from .language import (
     UnionTypeExtensionNode,
     EnumTypeExtensionNode,
     InputObjectTypeExtensionNode,
+    DirectiveExtensionNode,
+    # Schema Coordinates
+    SchemaCoordinateNode,
+    TypeCoordinateNode,
+    MemberCoordinateNode,
+    ArgumentCoordinateNode,
+    DirectiveCoordinateNode,
+    DirectiveArgumentCoordinateNode,
 )
 
 # Utilities for operating on GraphQL type schema and parsed sources.
@@ -226,6 +236,17 @@ from .utilities import (
     DangerousChangeType,
     find_breaking_changes,
     find_dangerous_changes,
+    # Resolve a schema coordinate to a schema element.
+    resolve_schema_coordinate,
+    resolve_ast_schema_coordinate,
+    ResolvedNamedType,
+    ResolvedField,
+    ResolvedInputField,
+    ResolvedEnumValue,
+    ResolvedFieldArgument,
+    ResolvedDirective,
+    ResolvedDirectiveArgument,
+    ResolvedSchemaElement,
 )
 
 # Create and operate on GraphQL type definitions and schema.
@@ -602,6 +623,7 @@ __all__ = [
     "parse_value",
     "parse_const_value",
     "parse_type",
+    "parse_schema_coordinate",
     "print_ast",
     "visit",
     "ParallelVisitor",
@@ -624,6 +646,7 @@ __all__ = [
     "is_type_definition_node",
     "is_type_system_extension_node",
     "is_type_extension_node",
+    "is_schema_coordinate_node",
     "SourceLocation",
     "Location",
     "Token",
@@ -687,6 +710,13 @@ __all__ = [
     "UnionTypeExtensionNode",
     "EnumTypeExtensionNode",
     "InputObjectTypeExtensionNode",
+    "DirectiveExtensionNode",
+    "SchemaCoordinateNode",
+    "TypeCoordinateNode",
+    "MemberCoordinateNode",
+    "ArgumentCoordinateNode",
+    "DirectiveCoordinateNode",
+    "DirectiveArgumentCoordinateNode",
     "execute",
     "execute_sync",
     "default_field_resolver",
@@ -786,6 +816,16 @@ __all__ = [
     "BreakingChangeType",
     "DangerousChange",
     "DangerousChangeType",
+    "resolve_schema_coordinate",
+    "resolve_ast_schema_coordinate",
+    "ResolvedNamedType",
+    "ResolvedField",
+    "ResolvedInputField",
+    "ResolvedEnumValue",
+    "ResolvedFieldArgument",
+    "ResolvedDirective",
+    "ResolvedDirectiveArgument",
+    "ResolvedSchemaElement",
     "Undefined",
     "UndefinedType",
 ]

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

@@ -254,6 +254,8 @@ def print_error(error: GraphQLError) -> str:
     """Print a GraphQLError to a string.
 
     Represents useful location information about the error's position in the source.
+    This deprecated helper is retained for backwards compatibility; call ``str(error)``
+    instead because ``print_error`` will be removed in v3.3.
 
     .. deprecated:: 3.2
        Please use ``str(error)`` instead. Will be removed in v3.3.
@@ -267,7 +269,9 @@ def format_error(error: GraphQLError) -> GraphQLFormattedError:
     """Format a GraphQL error.
 
     Given a GraphQLError, format it according to the rules described by the "Response
-    Format, Errors" section of the GraphQL Specification.
+    Format, Errors" section of the GraphQL Specification. This deprecated helper is
+    retained for backwards compatibility; use ``error.formatted`` instead because
+    ``format_error`` will be removed in v3.3.
 
     .. deprecated:: 3.2
        Please use ``error.formatted`` instead. Will be removed in v3.3.

{graphql_core-3.2.9 → graphql_core-3.2.11}/src/graphql/execution/execute.py

@@ -1,5 +1,6 @@
 from asyncio import ensure_future, gather
 from collections.abc import Mapping
+from contextlib import suppress
 from inspect import isawaitable
 from typing import (
     Any,
@@ -10,6 +11,7 @@ from typing import (
     Iterable,
     List,
     Optional,
+    Set,
     Tuple,
     Type,
     Union,
@@ -173,6 +175,42 @@ class ExecutionResult:
 Middleware = Optional[Union[Tuple, List, MiddlewareManager]]
 
 
+class CollectedErrors:
+    """A list of errors collected during execution, ignoring nulled positions.
+
+    For internal use only.
+    """
+
+    _error_positions: Set[Optional[Path]]
+    _errors: List[GraphQLError]
+
+    def __init__(self) -> None:
+        self._error_positions = set()
+        self._errors = []
+
+    @property
+    def errors(self) -> List[GraphQLError]:
+        return self._errors
+
+    def add(self, error: GraphQLError, path: Optional[Path]) -> None:
+        # Do not modify errors list if the execution position for this error or
+        # any of its ancestors has already been nulled via error propagation.
+        # This check should be unnecessary for implementations able to implement
+        # actual cancellation.
+        if self._has_nulled_position(path):
+            return
+        self._error_positions.add(path)
+        self._errors.append(error)
+
+    def _has_nulled_position(self, start_path: Optional[Path]) -> bool:
+        path = start_path
+        while path is not None:
+            if path in self._error_positions:
+                return True
+            path = path.prev
+        return None in self._error_positions
+
+
 class ExecutionContext:
     """Data that must be available at all points during query execution.
 
@@ -189,7 +227,7 @@ class ExecutionContext:
     field_resolver: GraphQLFieldResolver
     type_resolver: GraphQLTypeResolver
     subscribe_field_resolver: GraphQLFieldResolver
-    errors: List[GraphQLError]
+    collected_errors: CollectedErrors
     middleware_manager: Optional[MiddlewareManager]
 
     is_awaitable = staticmethod(default_is_awaitable)
@@ -205,7 +243,7 @@ class ExecutionContext:
         field_resolver: GraphQLFieldResolver,
         type_resolver: GraphQLTypeResolver,
         subscribe_field_resolver: GraphQLFieldResolver,
-        errors: List[GraphQLError],
+        collected_errors: CollectedErrors,
         middleware_manager: Optional[MiddlewareManager],
         is_awaitable: Optional[Callable[[Any], bool]],
     ) -> None:
@@ -218,7 +256,7 @@ class ExecutionContext:
         self.field_resolver = field_resolver
         self.type_resolver = type_resolver
         self.subscribe_field_resolver = subscribe_field_resolver
-        self.errors = errors
+        self.collected_errors = collected_errors
         self.middleware_manager = middleware_manager
         if is_awaitable:
             self.is_awaitable = is_awaitable  # type: ignore
@@ -236,6 +274,7 @@ class ExecutionContext:
         field_resolver: Optional[GraphQLFieldResolver] = None,
         type_resolver: Optional[GraphQLTypeResolver] = None,
         subscribe_field_resolver: Optional[GraphQLFieldResolver] = None,
+        max_coercion_errors: int = 50,
         middleware: Optional[Middleware] = None,
         is_awaitable: Optional[Callable[[Any], bool]] = None,
     ) -> Union[List[GraphQLError], "ExecutionContext"]:
@@ -288,7 +327,7 @@ class ExecutionContext:
             schema,
             operation.variable_definitions or (),
             raw_variable_values or {},
-            max_errors=50,
+            max_errors=max_coercion_errors,
         )
 
         if isinstance(coerced_variable_values, list):
@@ -304,7 +343,7 @@ class ExecutionContext:
             field_resolver or default_field_resolver,
             type_resolver or default_type_resolver,
             subscribe_field_resolver or default_field_resolver,
-            [],
+            CollectedErrors(),
             middleware_manager,
             is_awaitable,
         )
@@ -534,7 +573,7 @@ class ExecutionContext:
                         return completed
                     except Exception as raw_error:
                         error = located_error(raw_error, field_nodes, path.as_list())
-                        self.handle_field_error(error, return_type)
+                        self.handle_field_error(error, return_type, path)
                         return None
 
                 return await_result()
@@ -549,7 +588,7 @@ class ExecutionContext:
                         return await completed
                     except Exception as raw_error:
                         error = located_error(raw_error, field_nodes, path.as_list())
-                        self.handle_field_error(error, return_type)
+                        self.handle_field_error(error, return_type, path)
                         return None
 
                 return await_completed()
@@ -557,13 +596,14 @@ class ExecutionContext:
             return completed
         except Exception as raw_error:
             error = located_error(raw_error, field_nodes, path.as_list())
-            self.handle_field_error(error, return_type)
+            self.handle_field_error(error, return_type, path)
             return None
 
     def handle_field_error(
         self,
         error: GraphQLError,
         return_type: GraphQLOutputType,
+        path: Path,
     ) -> None:
         # If the field type is non-nullable, then it is resolved without any protection
         # from errors, however it still properly locates the error.
@@ -571,7 +611,7 @@ class ExecutionContext:
             raise error
         # Otherwise, error protection is applied, logging the error and resolving a
         # null value for this field if one is encountered.
-        self.errors.append(error)
+        self.collected_errors.add(error, path)
         return None
 
     def complete_value(
@@ -719,7 +759,7 @@ class ExecutionContext:
                         error = located_error(
                             raw_error, field_nodes, item_path.as_list()
                         )
-                        self.handle_field_error(error, item_type)
+                        self.handle_field_error(error, item_type, item_path)
                         return None
 
                 completed_item = await_completed(item, item_path)
@@ -737,13 +777,13 @@ class ExecutionContext:
                                 error = located_error(
                                     raw_error, field_nodes, item_path.as_list()
                                 )
-                                self.handle_field_error(error, item_type)
+                                self.handle_field_error(error, item_type, item_path)
                                 return None
 
                         completed_item = await_completed(completed_item, item_path)
                 except Exception as raw_error:
                     error = located_error(raw_error, field_nodes, item_path.as_list())
-                    self.handle_field_error(error, item_type)
+                    self.handle_field_error(error, item_type, item_path)
                     completed_item = None
 
             if is_awaitable(completed_item):
@@ -974,6 +1014,7 @@ def execute(
     field_resolver: Optional[GraphQLFieldResolver] = None,
     type_resolver: Optional[GraphQLTypeResolver] = None,
     subscribe_field_resolver: Optional[GraphQLFieldResolver] = None,
+    max_coercion_errors: int = 50,
     middleware: Optional[Middleware] = None,
     execution_context_class: Optional[Type["ExecutionContext"]] = None,
     is_awaitable: Optional[Callable[[Any], bool]] = None,
@@ -1006,6 +1047,7 @@ def execute(
         field_resolver,
         type_resolver,
         subscribe_field_resolver,
+        max_coercion_errors,
         middleware,
         is_awaitable,
     )
@@ -1025,7 +1067,7 @@ def execute(
     # Errors from sub-fields of a NonNull type may propagate to the top level,
     # at which point we still log the error and null the parent field, which
     # in this case is the entire response.
-    errors = exe_context.errors
+    collected_errors = exe_context.collected_errors
     build_response = exe_context.build_response
     try:
         operation = exe_context.operation
@@ -1035,17 +1077,18 @@ def execute(
             # noinspection PyShadowingNames
             async def await_result() -> Any:
                 try:
-                    return build_response(await result, errors)  # type: ignore
+                    data = await result  # type: ignore
+                    return build_response(data, collected_errors.errors)
                 except GraphQLError as error:
-                    errors.append(error)
-                    return build_response(None, errors)
+                    collected_errors.add(error, None)
+                    return build_response(None, collected_errors.errors)
 
             return await_result()
     except GraphQLError as error:
-        errors.append(error)
-        return build_response(None, errors)
+        collected_errors.add(error, None)
+        return build_response(None, collected_errors.errors)
     else:
-        return build_response(result, errors)  # type: ignore
+        return build_response(result, collected_errors.errors)  # type: ignore
 
 
 def assume_not_awaitable(_value: Any) -> bool:
@@ -1062,6 +1105,7 @@ def execute_sync(
     operation_name: Optional[str] = None,
     field_resolver: Optional[GraphQLFieldResolver] = None,
     type_resolver: Optional[GraphQLTypeResolver] = None,
+    max_coercion_errors: int = 50,
     middleware: Optional[Middleware] = None,
     execution_context_class: Optional[Type["ExecutionContext"]] = None,
     check_sync: bool = False,
@@ -1091,6 +1135,7 @@ def execute_sync(
         field_resolver,
         type_resolver,
         None,
+        max_coercion_errors,
         middleware,
         execution_context_class,
         is_awaitable,
@@ -1214,6 +1259,16 @@ def default_type_resolver(
                 append_awaitable_results(cast(Awaitable, is_type_of_result))
                 append_awaitable_types(type_)
             elif is_type_of_result:
+                if awaitable_is_type_of_results:
+                    # noinspection PyShadowingNames
+                    async def await_is_type_of_and_return_type(
+                        resolved_type_name: str = type_.name,
+                    ) -> str:
+                        with suppress(Exception):
+                            await gather(*awaitable_is_type_of_results)
+                        return resolved_type_name
+
+                    return await_is_type_of_and_return_type()
                 return type_.name
 
     if awaitable_is_type_of_results:

{graphql_core-3.2.9 → graphql_core-3.2.11}/src/graphql/execution/subscribe.py

@@ -35,6 +35,7 @@ async def subscribe(
     operation_name: Optional[str] = None,
     field_resolver: Optional[GraphQLFieldResolver] = None,
     subscribe_field_resolver: Optional[GraphQLFieldResolver] = None,
+    max_coercion_errors: int = 50,
 ) -> Union[AsyncIterator[ExecutionResult], ExecutionResult]:
     """Create a GraphQL subscription.
 
@@ -63,6 +64,7 @@ async def subscribe(
         variable_values,
         operation_name,
         subscribe_field_resolver,
+        max_coercion_errors,
     )
     if isinstance(result_or_stream, ExecutionResult):
         return result_or_stream
@@ -100,6 +102,7 @@ async def create_source_event_stream(
     variable_values: Optional[Dict[str, Any]] = None,
     operation_name: Optional[str] = None,
     subscribe_field_resolver: Optional[GraphQLFieldResolver] = None,
+    max_coercion_errors: int = 50,
 ) -> Union[AsyncIterable[Any], ExecutionResult]:
     """Create source event stream
 
@@ -138,6 +141,7 @@ async def create_source_event_stream(
         variable_values,
         operation_name,
         subscribe_field_resolver=subscribe_field_resolver,
+        max_coercion_errors=max_coercion_errors,
     )
 
     # Return early errors if execution context failed.

{graphql_core-3.2.9 → graphql_core-3.2.11}/src/graphql/execution/values.py

@@ -2,6 +2,8 @@ from typing import Any, Callable, Collection, Dict, List, Optional, Union, cast
 
 from ..error import GraphQLError
 from ..language import (
+    DirectiveDefinitionNode,
+    DirectiveExtensionNode,
     DirectiveNode,
     EnumValueDefinitionNode,
     ExecutableDefinitionNode,
@@ -224,6 +226,8 @@ def get_argument_values(
 
 
 NodeWithDirective = Union[
+    DirectiveDefinitionNode,
+    DirectiveExtensionNode,
     EnumValueDefinitionNode,
     ExecutableDefinitionNode,
     FieldDefinitionNode,

{graphql_core-3.2.9 → graphql_core-3.2.11}/src/graphql/graphql.py

@@ -192,6 +192,7 @@ def graphql_impl(
         field_resolver,
         type_resolver,
         None,
+        50,
         middleware,
         execution_context_class,
         is_awaitable,

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

@@ -14,7 +14,13 @@ from .token_kind import TokenKind
 
 from .lexer import Lexer
 
-from .parser import parse, parse_type, parse_value, parse_const_value
+from .parser import (
+    parse,
+    parse_type,
+    parse_value,
+    parse_const_value,
+    parse_schema_coordinate,
+)
 
 from .printer import print_ast
 
@@ -94,6 +100,13 @@ from .ast import (
     UnionTypeExtensionNode,
     EnumTypeExtensionNode,
     InputObjectTypeExtensionNode,
+    DirectiveExtensionNode,
+    SchemaCoordinateNode,
+    TypeCoordinateNode,
+    MemberCoordinateNode,
+    ArgumentCoordinateNode,
+    DirectiveCoordinateNode,
+    DirectiveArgumentCoordinateNode,
 )
 from .predicates import (
     is_definition_node,
@@ -106,6 +119,7 @@ from .predicates import (
     is_type_definition_node,
     is_type_system_extension_node,
     is_type_extension_node,
+    is_schema_coordinate_node,
 )
 from .directive_locations import DirectiveLocation
 
@@ -121,6 +135,7 @@ __all__ = [
     "parse_value",
     "parse_const_value",
     "parse_type",
+    "parse_schema_coordinate",
     "print_ast",
     "Source",
     "visit",
@@ -195,6 +210,13 @@ __all__ = [
     "UnionTypeExtensionNode",
     "EnumTypeExtensionNode",
     "InputObjectTypeExtensionNode",
+    "DirectiveExtensionNode",
+    "SchemaCoordinateNode",
+    "TypeCoordinateNode",
+    "MemberCoordinateNode",
+    "ArgumentCoordinateNode",
+    "DirectiveCoordinateNode",
+    "DirectiveArgumentCoordinateNode",
     "is_definition_node",
     "is_executable_definition_node",
     "is_selection_node",
@@ -205,4 +227,5 @@ __all__ = [
     "is_type_definition_node",
     "is_type_system_extension_node",
     "is_type_extension_node",
+    "is_schema_coordinate_node",
 ]