GeneralManager 0.41.1__tar.gz → 0.41.3__tar.gz

{generalmanager-0.41.1/src/GeneralManager.egg-info → generalmanager-0.41.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: GeneralManager
-Version: 0.41.1
+Version: 0.41.3
 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.41.1 → generalmanager-0.41.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "GeneralManager"
-version = "0.41.1"
+version = "0.41.3"
 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.41.1 → generalmanager-0.41.3/src/GeneralManager.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: GeneralManager
-Version: 0.41.1
+Version: 0.41.3
 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.41.1 → generalmanager-0.41.3}/src/general_manager/interface/capabilities/orm_utils/field_descriptors.py

@@ -11,6 +11,7 @@ from uuid import UUID
 
 from django.apps import apps
 from django.contrib.contenttypes.fields import GenericForeignKey
+from django.core.exceptions import ObjectDoesNotExist
 from django.db import models
 
 from general_manager.interface.base_interface import AttributeTypedDict
@@ -35,6 +36,23 @@ class FieldDescriptor:
     accessor: DescriptorAccessor
 
 
+class MissingRelatedFieldsError(RuntimeError):
+    """Raised when a GeneralManager collection relation cannot be scoped."""
+
+    def __init__(
+        self,
+        *,
+        accessor_name: str,
+        related_model: type[models.Model],
+        source_model: type[models.Model],
+    ) -> None:
+        super().__init__(
+            "Unable to resolve related fields for collection relation "
+            f"'{accessor_name}' from {source_model.__name__} to "
+            f"{related_model.__name__}."
+        )
+
+
 TRANSLATION: dict[type[models.Field], type] = {
     models.fields.BigAutoField: int,
     models.AutoField: int,
@@ -135,6 +153,7 @@ class _FieldDescriptorBuilder:
         self._add_custom_fields()
         self._add_model_fields()
         self._add_foreign_key_fields()
+        self._add_reverse_one_to_one_relations()
         self._add_collection_relations()
         return self._descriptors
 
@@ -209,6 +228,41 @@ class _FieldDescriptorBuilder:
                 filter_lookup=field.name,
             )
 
+    def _add_reverse_one_to_one_relations(self) -> None:
+        """Register snake_case aliases for reverse one-to-one relation accessors."""
+        for relation in _iter_reverse_one_to_one_relations(self.model):
+            related_model = self._resolve_related_model(
+                getattr(relation, "related_model", None)
+            )
+            if related_model is None:
+                continue
+            accessor_name = relation.get_accessor_name() or relation.name
+            attribute_name = _to_snake_case(related_model.__name__)
+            if attribute_name in self._descriptors:
+                continue
+            general_manager_class = getattr(
+                related_model, "_general_manager_class", None
+            )
+            if general_manager_class:
+                accessor = _general_manager_accessor(
+                    accessor_name, general_manager_class
+                )
+                relation_type = cast(type, general_manager_class)
+            else:
+                accessor = _instance_attribute_accessor(accessor_name)
+                relation_type = cast(type, related_model)
+            self._register(
+                attribute_name=attribute_name,
+                raw_type=relation_type,
+                is_required=False,
+                is_editable=False,
+                default=None,
+                is_derived=True,
+                accessor=accessor,
+                relation_kind="direct",
+                filter_lookup=relation.name,
+            )
+
     def _add_collection_relations(self) -> None:
         """
         Register collection relation field descriptors for the builder's model.
@@ -521,6 +575,22 @@ def _iter_many_to_many_fields(
             yield cast(models.Field, field)
 
 
+def _iter_reverse_one_to_one_relations(
+    model: type[models.Model],
+) -> Iterable[models.OneToOneRel]:
+    """Yield reverse one-to-one relations declared on a Django model."""
+    meta = getattr(model, "_meta", None)
+    get_fields = getattr(meta, "get_fields", None)
+    if not callable(get_fields):
+        return
+    for field in get_fields():
+        if getattr(field, "is_relation", False) and getattr(field, "one_to_one", False):
+            if getattr(field, "auto_created", False) and not getattr(
+                field, "concrete", False
+            ):
+                yield cast(models.OneToOneRel, field)
+
+
 def _iter_reverse_relations(
     model: type[models.Model],
 ) -> Iterable[models.ManyToOneRel]:
@@ -558,7 +628,10 @@ def _instance_attribute_accessor(field_name: str) -> DescriptorAccessor:
         Returns:
             The attribute value retrieved from the underlying model instance.
         """
-        return getattr(self._instance, field_name)
+        try:
+            return getattr(self._instance, field_name)
+        except ObjectDoesNotExist:
+            return None
 
     return getter
 
@@ -584,7 +657,10 @@ def _general_manager_accessor(
         Returns:
             The value produced by calling `manager_class` with the related object's primary key, or `None` if the related object is `None`.
         """
-        related = getattr(self._instance, field_name)
+        try:
+            related = getattr(self._instance, field_name)
+        except ObjectDoesNotExist:
+            return None
         if related is None:
             return None
         return manager_class(related.pk)
@@ -632,6 +708,12 @@ def _general_manager_many_accessor(
         """
         filter_kwargs = {field.name: self.pk for field in related_fields}
         manager_cls = cast(Any, general_manager_class)
+        if not filter_kwargs:
+            raise MissingRelatedFieldsError(
+                accessor_name=accessor_name,
+                related_model=related_model,
+                source_model=source_model,
+            )
         return manager_cls.filter(**filter_kwargs)
 
     return getter