introduce GroupedFieldSet type

Replicates graphql/graphql-js@45f2a59

Author: Cito

src/graphql/execution/collect_fields.py

@@ -4,7 +4,7 @@
 
 import sys
 from collections import defaultdict
-from typing import Any, List, NamedTuple
+from typing import Any, Dict, List, NamedTuple
 
 from ..language import (
     FieldNode,
@@ -32,25 +32,33 @@
     from typing_extensions import TypeAlias
 
 
-__all__ = ["collect_fields", "collect_subfields", "FieldGroup", "FieldsAndPatches"]
+__all__ = [
+    "collect_fields",
+    "collect_subfields",
+    "FieldGroup",
+    "FieldsAndPatches",
+    "GroupedFieldSet",
+]
 
 if sys.version_info < (3, 9):
     FieldGroup: TypeAlias = List[FieldNode]
+    GroupedFieldSet = Dict[str, FieldGroup]
 else:  # Python >= 3.9
     FieldGroup: TypeAlias = list[FieldNode]
+    GroupedFieldSet = dict[str, FieldGroup]
 
 
 class PatchFields(NamedTuple):
     """Optionally labelled set of fields to be used as a patch."""
 
     label: str | None
-    fields: dict[str, FieldGroup]
+    fields: GroupedFieldSet
 
 
 class FieldsAndPatches(NamedTuple):
     """Tuple of collected fields and patches to be applied."""
 
-    fields: dict[str, FieldGroup]
+    fields: GroupedFieldSet
     patches: list[PatchFields]
 
 

src/graphql/execution/execute.py

@@ -77,6 +77,7 @@
 from .collect_fields import (
     FieldGroup,
     FieldsAndPatches,
+    GroupedFieldSet,
     collect_fields,
     collect_subfields,
 )
@@ -841,7 +842,7 @@ def execute_fields_serially(
         parent_type: GraphQLObjectType,
         source_value: Any,
         path: Path | None,
-        fields: dict[str, FieldGroup],
+        fields: GroupedFieldSet,
     ) -> AwaitableOrValue[dict[str, Any]]:
         """Execute the given fields serially.
 
@@ -881,7 +882,7 @@ def execute_fields(
         parent_type: GraphQLObjectType,
         source_value: Any,
         path: Path | None,
-        fields: dict[str, FieldGroup],
+        fields: GroupedFieldSet,
         async_payload_record: AsyncPayloadRecord | None = None,
     ) -> AwaitableOrValue[dict[str, Any]]:
         """Execute the given fields concurrently.
@@ -1692,7 +1693,7 @@ def execute_deferred_fragment(
         self,
         parent_type: GraphQLObjectType,
         source_value: Any,
-        fields: dict[str, FieldGroup],
+        fields: GroupedFieldSet,
         label: str | None = None,
         path: Path | None = None,
         parent_context: AsyncPayloadRecord | None = None,