strawberry-graphql 0.288.4__py3-none-any.whl → 0.289.1__py3-none-any.whl

strawberry/execution/__init__.py

@@ -0,0 +1,5 @@
+"""Execution utilities for Strawberry GraphQL."""
+
+from .is_awaitable import optimized_is_awaitable
+
+__all__ = ["optimized_is_awaitable"]

strawberry/execution/is_awaitable.py

@@ -0,0 +1,59 @@
+"""Optimized is_awaitable implementation for GraphQL execution.
+
+This module provides a highly optimized is_awaitable function that adds a fast path
+for common synchronous types, significantly improving performance when dealing with
+large result sets containing primitive values.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from graphql.pyutils.is_awaitable import is_awaitable as graphql_core_is_awaitable
+
+__all__ = ["optimized_is_awaitable"]
+
+# Common synchronous types that are never awaitable
+# Using a frozenset for O(1) lookup
+_NON_AWAITABLE_TYPES: frozenset[type] = frozenset(
+    {
+        type(None),
+        bool,
+        int,
+        float,
+        str,
+        bytes,
+        bytearray,
+        list,
+        tuple,
+        dict,
+        set,
+        frozenset,
+    }
+)
+
+
+def optimized_is_awaitable(value: Any) -> bool:
+    """Return true if object can be passed to an ``await`` expression.
+
+    This is an optimized version of graphql-core's is_awaitable that adds a fast path
+    for common synchronous types. For large result sets containing mostly primitive
+    values (ints, strings, lists, etc.), this can provide significant performance
+    improvements.
+
+    Performance characteristics:
+    - Fast path for primitives: O(1) type lookup
+    - Falls back to graphql-core's is_awaitable for other types
+
+    Args:
+        value: The value to check
+
+    Returns:
+        True if the value is awaitable, False otherwise
+    """
+    # Fast path: check if the type is a known non-awaitable type
+    if type(value) in _NON_AWAITABLE_TYPES:
+        return False
+
+    # Fallback to graphql-core's implementation for other types
+    return graphql_core_is_awaitable(value)

strawberry/schema/schema.py

@@ -39,6 +39,7 @@ from graphql.validation import validate
 from strawberry import relay
 from strawberry.annotation import StrawberryAnnotation
 from strawberry.exceptions import MissingQueryError
+from strawberry.execution import optimized_is_awaitable
 from strawberry.extensions import SchemaExtension
 from strawberry.extensions.directives import (
     DirectivesExtension,
@@ -617,6 +618,7 @@ class Schema(BaseSchema):
                                 operation_name=execution_context.operation_name,
                                 context_value=execution_context.context,
                                 execution_context_class=self.execution_context_class,
+                                is_awaitable=optimized_is_awaitable,
                                 **custom_context_kwargs,
                             )
                         )
@@ -752,6 +754,7 @@ class Schema(BaseSchema):
                             operation_name=execution_context.operation_name,
                             context_value=execution_context.context,
                             execution_context_class=self.execution_context_class,
+                            is_awaitable=optimized_is_awaitable,
                             **custom_context_kwargs,
                         )
 

strawberry/types/enum.py

@@ -1,7 +1,7 @@
 import dataclasses
 from collections.abc import Callable, Iterable, Mapping
 from enum import EnumMeta
-from typing import TYPE_CHECKING, Any, TypeGuard, TypeVar, overload
+from typing import TYPE_CHECKING, Any, Literal, TypeGuard, TypeVar, overload
 
 from strawberry.exceptions import ObjectIsNotAnEnumError
 from strawberry.types.base import (
@@ -103,6 +103,7 @@ def enum_value(
 
 
 EnumType = TypeVar("EnumType", bound=EnumMeta)
+GraphqlEnumNameFrom = Literal["key", "value"]
 
 
 def _process_enum(
@@ -110,6 +111,7 @@ def _process_enum(
     name: str | None = None,
     description: str | None = None,
     directives: Iterable[object] = (),
+    graphql_name_from: GraphqlEnumNameFrom = "key",
 ) -> EnumType:
     if not isinstance(cls, EnumMeta):
         raise ObjectIsNotAnEnumError(cls)
@@ -119,6 +121,7 @@ def _process_enum(
 
     values = []
     for item in cls:  # type: ignore
+        graphql_name = None
         item_value = item.value
         item_name = item.name
         deprecation_reason = None
@@ -135,13 +138,19 @@ def _process_enum(
             cls._value2member_map_[item_value.value] = item
             cls._member_map_[item_name]._value_ = item_value.value
 
-            if item_value.graphql_name:
-                item_name = item_value.graphql_name
-
+            graphql_name = item_value.graphql_name
             item_value = item_value.value
 
+        if not graphql_name:
+            if graphql_name_from == "key":
+                graphql_name = item_name
+            elif graphql_name_from == "value":
+                graphql_name = item_value
+            else:
+                raise ValueError(f"Invalid mode: {graphql_name_from}")
+
         value = EnumValue(
-            item_name,
+            graphql_name,
             item_value,
             deprecation_reason=deprecation_reason,
             directives=item_directives,
@@ -174,6 +183,7 @@ def enum(
     name: str | None = None,
     description: str | None = None,
     directives: Iterable[object] = (),
+    graphql_name_from: GraphqlEnumNameFrom = "key",
 ) -> EnumType: ...
 
 
@@ -184,6 +194,7 @@ def enum(
     name: str | None = None,
     description: str | None = None,
     directives: Iterable[object] = (),
+    graphql_name_from: GraphqlEnumNameFrom = "key",
 ) -> Callable[[EnumType], EnumType]: ...
 
 
@@ -193,18 +204,20 @@ def enum(
     name: str | None = None,
     description: str | None = None,
     directives: Iterable[object] = (),
+    graphql_name_from: GraphqlEnumNameFrom = "key",
 ) -> EnumType | Callable[[EnumType], EnumType]:
     """Annotates an Enum class a GraphQL enum.
 
     GraphQL enums only have names, while Python enums have names and values,
-    Strawberry will use the names of the Python enum as the names of the
-    GraphQL enum values.
+    Strawberry will by default use the names of the Python enum as the names of the
+    GraphQL enum values. You can use the values instead by using mode="value".
 
     Args:
         cls: The Enum class to be annotated.
         name: The name of the GraphQL enum.
         description: The description of the GraphQL enum.
         directives: The directives to attach to the GraphQL enum.
+        graphql_name_from: Whether to use the names (key) or values of the Python enums in GraphQL.
 
     Returns:
         The decorated Enum class.
@@ -235,7 +248,13 @@ def enum(
     """
 
     def wrap(cls: EnumType) -> EnumType:
-        return _process_enum(cls, name, description, directives=directives)
+        return _process_enum(
+            cls,
+            name,
+            description,
+            directives=directives,
+            graphql_name_from=graphql_name_from,
+        )
 
     if not cls:
         return wrap

{strawberry_graphql-0.288.4.dist-info → strawberry_graphql-0.289.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: strawberry-graphql
-Version: 0.288.4
+Version: 0.289.1
 Summary: A library for creating GraphQL APIs
 License: MIT
 License-File: LICENSE

{strawberry_graphql-0.288.4.dist-info → strawberry_graphql-0.289.1.dist-info}/RECORD

@@ -76,6 +76,8 @@ strawberry/exceptions/syntax.py,sha256=A8_qoYI-PEYCpxBCzrvDOrZOdz96rvh8Q4vxGgvtV
 strawberry/exceptions/unresolved_field_type.py,sha256=TZvJ_6Dg0IMhDE8IFx9ENLS5MR7m8u0R11MaOchX9xo,1864
 strawberry/exceptions/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 strawberry/exceptions/utils/source_finder.py,sha256=PPgNivWC8M-Fj-Y-ZiAgOd3HD4kl3D6igdkuoyqAAdA,22487
+strawberry/execution/__init__.py,sha256=DIWjV8COzSgVsingGeef-nZ6K8sJPGDrhhUqFpeOokE,138
+strawberry/execution/is_awaitable.py,sha256=vOPp7x6Y8K3b0w_wuIhr7SFU7_b5Prl_u3uwB1kwWBM,1705
 strawberry/experimental/__init__.py,sha256=2HP5XtxL8ZKsPp4EDRAbMCqiP7p2V4Cca278JUGxnt0,102
 strawberry/experimental/pydantic/__init__.py,sha256=UpO8wHNXGpoCYp34YStViInO1tsrGsMyhTVubTpJY7Y,255
 strawberry/experimental/pydantic/_compat.py,sha256=7dJWzQ5Hs7mD0pSLbJdZvW0l3cROQjsu__GBqKmv_hk,9753
@@ -176,7 +178,7 @@ strawberry/schema/compat.py,sha256=ui3ZsRRo86PgtUxBHbjNF2tqqrPA9eUW-sFY8itGuvc,1
 strawberry/schema/config.py,sha256=1i80WOoml_9qzOV-kfcx-LYMXYwWYl0uisdcZX1vMEg,2330
 strawberry/schema/exceptions.py,sha256=SaEWtahVAg_f43coyg2h7H2UMZP10CZ_GJg72khBIAs,1105
 strawberry/schema/name_converter.py,sha256=G3yOj-BmZ6E0bcvvSbb2cWu8ngsXi8M6W0c6rKROMjc,6933
-strawberry/schema/schema.py,sha256=owMOE-Bgte2DTTN4OCXVpZpr6LkR77KOzzGrAWZkDeM,39416
+strawberry/schema/schema.py,sha256=FKtqHGrOCnYMWhMwy1qWU_VXtw2IxyjpZZScL4PmVlg,39606
 strawberry/schema/schema_converter.py,sha256=nzTZIOyIwe9jCX66ZT7m7vm8UzpcUs-AW25XWnZC9J0,40791
 strawberry/schema/types/__init__.py,sha256=oHO3COWhL3L1KLYCJNY1XFf5xt2GGtHiMC-UaYbFfnA,68
 strawberry/schema/types/base_scalars.py,sha256=ajMeN4W45AALhCnJO8MIisRb9slDZRyIl1S61LvHfSQ,2678
@@ -210,7 +212,7 @@ strawberry/types/arguments.py,sha256=3Rt1WlVDMc0KKYmJOnMUckeTB0egJv96Uw7RMopM4DM
 strawberry/types/auto.py,sha256=4sDflIg-Kz-QpK7Qo7bCSFblw7VE-0752rgayukFznU,2954
 strawberry/types/base.py,sha256=Hubo7u6OsU1v1v-w-vBCwlNVTqHaNn4zPOJuX93WR5U,15699
 strawberry/types/cast.py,sha256=fx86MkLW77GIximBAwUk5vZxSGwDqUA6XicXvz8EXwQ,916
-strawberry/types/enum.py,sha256=Dc1emdlBi1m9pK9h6rdyq8VRaBLafQO7MQdKhVgYXvs,7286
+strawberry/types/enum.py,sha256=sL7SMLx7W9h0-zxtKews6drfYtLUVZ1VorXuXp83mj4,8103
 strawberry/types/execution.py,sha256=z84AekAD_V_F4vGGHMPMGlAT0Htiw5JhEVvw1F9sGYQ,4019
 strawberry/types/field.py,sha256=-E5jfq7YXzI2CUepttfGzgmXFA1BTR2hmts44P-JpEk,20422
 strawberry/types/fields/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -238,8 +240,8 @@ strawberry/utils/logging.py,sha256=Dnivjd0ZhK_lAvjvuyCDkEWDhuURBoK9d3Kt_mIqbRg,7
 strawberry/utils/operation.py,sha256=Qs3ttbuC415xEVqmJ6YsWQpJNUo8CZJq9AoMB-yV65w,1215
 strawberry/utils/str_converters.py,sha256=-eH1Cl16IO_wrBlsGM-km4IY0IKsjhjnSNGRGOwQjVM,897
 strawberry/utils/typing.py,sha256=eE9NeMfASeXRstbjLnQFfOPymcSX8xwg3FGw_HCp95E,11828
-strawberry_graphql-0.288.4.dist-info/METADATA,sha256=LiS09hr9ulZqpMfHbqvHv4rVtV7Ej_WIgApx4CQU-C0,7627
-strawberry_graphql-0.288.4.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-strawberry_graphql-0.288.4.dist-info/entry_points.txt,sha256=Nk7-aT3_uEwCgyqtHESV9H6Mc31cK-VAvhnQNTzTb4k,49
-strawberry_graphql-0.288.4.dist-info/licenses/LICENSE,sha256=m-XnIVUKqlG_AWnfi9NReh9JfKhYOB-gJfKE45WM1W8,1072
-strawberry_graphql-0.288.4.dist-info/RECORD,,
+strawberry_graphql-0.289.1.dist-info/METADATA,sha256=bbupgRYRkCQ5q4LdqolspO2jFu9Xy8bCoX2qwvg8RjM,7627
+strawberry_graphql-0.289.1.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
+strawberry_graphql-0.289.1.dist-info/entry_points.txt,sha256=Nk7-aT3_uEwCgyqtHESV9H6Mc31cK-VAvhnQNTzTb4k,49
+strawberry_graphql-0.289.1.dist-info/licenses/LICENSE,sha256=m-XnIVUKqlG_AWnfi9NReh9JfKhYOB-gJfKE45WM1W8,1072
+strawberry_graphql-0.289.1.dist-info/RECORD,,

{strawberry_graphql-0.288.4.dist-info → strawberry_graphql-0.289.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.2.1
+Generator: poetry-core 2.3.0
 Root-Is-Purelib: true
 Tag: py3-none-any