GeneralManager 0.82.3__tar.gz → 0.82.4__tar.gz

{generalmanager-0.82.3/src/GeneralManager.egg-info → generalmanager-0.82.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: GeneralManager
-Version: 0.82.3
+Version: 0.82.4
 Summary: Modular Django-based data management framework with ORM, GraphQL, fine-grained permissions, rule validation, calculations and caching.
 Author-email: Tim Kleindick <tkleindick@yahoo.de>
 License: MIT License

{generalmanager-0.82.3 → generalmanager-0.82.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "GeneralManager"
-version = "0.82.3"
+version = "0.82.4"
 description = "Modular Django-based data management framework with ORM, GraphQL, fine-grained permissions, rule validation, calculations and caching."
 readme = "README.md"
 authors = [{ name = "Tim Kleindick", email = "tkleindick@yahoo.de" }]

{generalmanager-0.82.3 → generalmanager-0.82.4/src/GeneralManager.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: GeneralManager
-Version: 0.82.3
+Version: 0.82.4
 Summary: Modular Django-based data management framework with ORM, GraphQL, fine-grained permissions, rule validation, calculations and caching.
 Author-email: Tim Kleindick <tkleindick@yahoo.de>
 License: MIT License

{generalmanager-0.82.3 → generalmanager-0.82.4}/src/general_manager/api/graphql.py

@@ -100,6 +100,7 @@ from general_manager.api.graphql_mutations import (
     generate_delete_mutation_class as _generate_delete_mutation_class_fn,
 )
 from general_manager.api.graphql_output import (
+    GraphQLOutputIdentityMetadataError,
     create_output_field_resolver,
     map_graphql_output_annotation,
     resolve_output_type_hints,
@@ -518,6 +519,11 @@ class GraphQL:
         )
         fields: dict[str, graphene.Field] = {}
         for declared_field in dataclasses.fields(output_class):
+            is_identifier = declared_field.metadata.get("is_identifier", False)
+            if not isinstance(is_identifier, bool):
+                raise GraphQLOutputIdentityMetadataError(
+                    output_name, declared_field.name, is_identifier
+                )
             mapped = map_graphql_output_annotation(
                 hints[declared_field.name],
                 owner_name=output_name,
@@ -528,6 +534,7 @@ class GraphQL:
                 output_type_registry=cls.graphql_output_type_registry,
                 measurement_type=MeasurementType,
                 scalar_mapper=cls._map_field_to_graphene_base_type,
+                is_identifier=is_identifier,
             )
             field = cast(graphene.Field, mapped.field)
             field.resolver = create_output_field_resolver(

{generalmanager-0.82.3 → generalmanager-0.82.4}/src/general_manager/api/graphql_output.py

@@ -9,6 +9,7 @@ from decimal import Decimal
 import sys
 from types import UnionType
 from typing import Any, ForwardRef, Union, get_args, get_origin, get_type_hints
+from uuid import UUID
 
 import graphene
 
@@ -40,6 +41,16 @@ class GraphQLOutputAnnotationError(TypeError):
         )
 
 
+class GraphQLOutputIdentityMetadataError(TypeError):
+    """Raised when an output field's identity flag is not boolean."""
+
+    def __init__(self, owner_name: str, field_name: str, flag: object) -> None:
+        super().__init__(
+            f"Invalid is_identifier metadata for {owner_name}.{field_name}: "
+            f"expected bool, got {flag!r}"
+        )
+
+
 @dataclass(frozen=True, slots=True)
 class _MappedAnnotation:
     """Internal Graphene type metadata before a field wrapper is mounted."""
@@ -144,6 +155,7 @@ def _map_collection_annotation(
     output_type_registry: Mapping[str, type[graphene.ObjectType]],
     measurement_type: type[graphene.ObjectType],
     scalar_mapper: Callable[[type], type],
+    is_identifier: bool = False,
 ) -> _MappedAnnotation:
     origin = get_origin(annotation)
     if origin not in (list, tuple, set):
@@ -159,6 +171,13 @@ def _map_collection_annotation(
             raise _annotation_error(owner_name, field_name, annotation)
         element_annotation = args[0]
 
+    if is_identifier:
+        _, identity_type = _unwrap_optional_annotation(
+            element_annotation, owner_name=owner_name, field_name=field_name
+        )
+        if identity_type not in (int, str, UUID):
+            raise _annotation_error(owner_name, field_name, annotation)
+
     element = _map_annotation(
         element_annotation,
         owner_name=owner_name,
@@ -169,6 +188,7 @@ def _map_collection_annotation(
         output_type_registry=output_type_registry,
         measurement_type=measurement_type,
         scalar_mapper=scalar_mapper,
+        is_identifier=is_identifier,
     )
     element_type = element.graphene_type
     if not element.nullable:
@@ -192,6 +212,7 @@ def _map_non_optional_value(
     output_type_registry: Mapping[str, type[graphene.ObjectType]],
     measurement_type: type[graphene.ObjectType],
     scalar_mapper: Callable[[type], type],
+    is_identifier: bool = False,
 ) -> _MappedAnnotation:
     annotation = _resolve_registered_name(
         annotation,
@@ -220,6 +241,17 @@ def _map_non_optional_value(
             output_type_registry=output_type_registry,
             measurement_type=measurement_type,
             scalar_mapper=scalar_mapper,
+            is_identifier=is_identifier,
+        )
+
+    if is_identifier:
+        if annotation not in (int, str, UUID):
+            raise _annotation_error(owner_name, field_name, annotation)
+        return _MappedAnnotation(
+            graphene.ID,
+            annotation,
+            nullable=False,
+            contains_measurement=False,
         )
 
     if safe_issubclass(annotation, GraphQLType):
@@ -290,6 +322,7 @@ def _map_annotation(
     output_type_registry: Mapping[str, type[graphene.ObjectType]],
     measurement_type: type[graphene.ObjectType],
     scalar_mapper: Callable[[type], type],
+    is_identifier: bool = False,
 ) -> _MappedAnnotation:
     nullable, concrete = _unwrap_optional_annotation(
         annotation,
@@ -306,6 +339,7 @@ def _map_annotation(
         output_type_registry=output_type_registry,
         measurement_type=measurement_type,
         scalar_mapper=scalar_mapper,
+        is_identifier=is_identifier,
     )
     return replace(mapped, nullable=nullable)
 
@@ -322,6 +356,7 @@ def _map_non_optional_annotation(
     measurement_type: type[graphene.ObjectType],
     scalar_mapper: Callable[[type], type],
     required: bool,
+    is_identifier: bool = False,
 ) -> MappedGraphQLOutput:
     """Map one non-optional annotation to a Graphene field."""
     mapped = _map_non_optional_value(
@@ -334,6 +369,7 @@ def _map_non_optional_annotation(
         output_type_registry=output_type_registry,
         measurement_type=measurement_type,
         scalar_mapper=scalar_mapper,
+        is_identifier=is_identifier,
     )
     field_kwargs: dict[str, object] = {}
     if mapped.contains_measurement:
@@ -355,8 +391,14 @@ def map_graphql_output_annotation(
     output_type_registry: Mapping[str, type[graphene.ObjectType]],
     measurement_type: type[graphene.ObjectType],
     scalar_mapper: Callable[[type], type],
+    is_identifier: bool = False,
 ) -> MappedGraphQLOutput:
-    """Map a strict GraphQL output annotation to a mounted Graphene field."""
+    """Map a strict output hint, preserving nullability and native values.
+
+    Explicit identity fields accept int, str, UUID, and supported flat
+    collections of those types. Their resolver type stays native while the
+    generated scalar is ID. Unmarked fields retain the strict legacy mapping.
+    """
     nullable, concrete_type = _unwrap_optional_annotation(
         annotation,
         owner_name=owner_name,
@@ -374,6 +416,7 @@ def map_graphql_output_annotation(
             measurement_type=measurement_type,
             scalar_mapper=scalar_mapper,
             required=not nullable,
+            is_identifier=is_identifier,
         )
     except GraphQLOutputAnnotationError as error:
         # Preserve the annotation written on the owning field in diagnostics,

{generalmanager-0.82.3 → generalmanager-0.82.4}/src/general_manager/api/graphql_type.py

@@ -29,7 +29,14 @@ class GraphQLTypeMeta(type):
 
 
 class GraphQLType(metaclass=GraphQLTypeMeta):
-    """Frozen annotated value exposed only as a GraphQL output object."""
+    """Frozen annotated value exposed only as a GraphQL output object.
+
+    Use ``dataclasses.field(metadata={"is_identifier": True})`` to declare
+    native int, str, or UUID identity fields and their supported homogeneous
+    collections. Schema generation preserves annotation nullability and native
+    values while exposing ID scalars. Missing or false metadata keeps existing
+    output types; other flag values fail schema generation with TypeError.
+    """
 
 
 def get_registered_graphql_types() -> tuple[type[GraphQLType], ...]: