GeneralManager 0.14.0__tar.gz → 0.15.0__tar.gz

generalmanager-0.15.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tim Kleindick
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{generalmanager-0.14.0/GeneralManager.egg-info → generalmanager-0.15.0}/PKG-INFO

@@ -1,14 +1,42 @@
 Metadata-Version: 2.4
 Name: GeneralManager
-Version: 0.14.0
+Version: 0.15.0
 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-Expression: MIT
+License: MIT License
+        
+        Copyright (c) 2025 Tim Kleindick
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Framework :: Django
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: asgiref>=3.8.1
-Requires-Dist: Django>=5.2
+Requires-Dist: Django>=5.2.7
 Requires-Dist: django-simple-history>=3.8.0
 Requires-Dist: exrex>=0.12.0
 Requires-Dist: factory_boy>=3.3.3
@@ -37,6 +65,12 @@ Dynamic: license-file
 
 # GeneralManager
 
+[![PyPI](https://img.shields.io/pypi/v/GeneralManager.svg)](https://pypi.org/project/GeneralManager/)
+[![Python](https://img.shields.io/pypi/pyversions/GeneralManager.svg)](https://pypi.org/project/GeneralManager/)
+[![Build](https://github.com/TimKleindick/general_manager/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/TimKleindick/general_manager/actions/workflows/test.yml)
+[![Coverage](https://img.shields.io/codecov/c/github/TimKleindick/general_manager)](https://app.codecov.io/gh/TimKleindick/general_manager)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
 ## Overview
 
 GeneralManager is a powerful and flexible framework designed for managing and processing data. It provides a modular structure that enables developers to implement complex business logic efficiently. The module is written entirely in Python and uses Django as the backend framework.
@@ -176,4 +210,4 @@ query {
 
 ## License
 
-This project is distributed under the **Non-Commercial MIT License**. It may only be used for non-commercial purposes. For further details see the [LICENSE](./LICENSE) file.
+This project is distributed under the **MIT License**. For further details see the [LICENSE](./LICENSE) file.

{generalmanager-0.14.0 → generalmanager-0.15.0}/README.md

@@ -1,5 +1,11 @@
 # GeneralManager
 
+[![PyPI](https://img.shields.io/pypi/v/GeneralManager.svg)](https://pypi.org/project/GeneralManager/)
+[![Python](https://img.shields.io/pypi/pyversions/GeneralManager.svg)](https://pypi.org/project/GeneralManager/)
+[![Build](https://github.com/TimKleindick/general_manager/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/TimKleindick/general_manager/actions/workflows/test.yml)
+[![Coverage](https://img.shields.io/codecov/c/github/TimKleindick/general_manager)](https://app.codecov.io/gh/TimKleindick/general_manager)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
 ## Overview
 
 GeneralManager is a powerful and flexible framework designed for managing and processing data. It provides a modular structure that enables developers to implement complex business logic efficiently. The module is written entirely in Python and uses Django as the backend framework.
@@ -139,4 +145,4 @@ query {
 
 ## License
 
-This project is distributed under the **Non-Commercial MIT License**. It may only be used for non-commercial purposes. For further details see the [LICENSE](./LICENSE) file.
+This project is distributed under the **MIT License**. For further details see the [LICENSE](./LICENSE) file.

{generalmanager-0.14.0 → generalmanager-0.15.0}/pyproject.toml

@@ -4,16 +4,25 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "GeneralManager"
-version = "0.14.0"
+version = "0.15.0"
 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" }]
-license = "MIT"
-license-files = ["LICENSE"]
+license = { file = "LICENSE" }
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Framework :: Django",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+]
 requires-python = ">=3.12"
 dependencies = [
     "asgiref>=3.8.1",
-    "Django>=5.2",
+    "Django>=5.2.7",
     "django-simple-history>=3.8.0",
     "exrex>=0.12.0",
     "factory_boy>=3.3.3",
@@ -41,7 +50,7 @@ dependencies = [
 ]
 
 [tool.setuptools.packages.find]
-where = ["src", "general_manager"]
+where = ["src"]
 
 [tool.semantic_release]
 allow_zero_version = true

{generalmanager-0.14.0 → generalmanager-0.15.0/src/GeneralManager.egg-info}/PKG-INFO

@@ -1,14 +1,42 @@
 Metadata-Version: 2.4
 Name: GeneralManager
-Version: 0.14.0
+Version: 0.15.0
 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-Expression: MIT
+License: MIT License
+        
+        Copyright (c) 2025 Tim Kleindick
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Framework :: Django
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: asgiref>=3.8.1
-Requires-Dist: Django>=5.2
+Requires-Dist: Django>=5.2.7
 Requires-Dist: django-simple-history>=3.8.0
 Requires-Dist: exrex>=0.12.0
 Requires-Dist: factory_boy>=3.3.3
@@ -37,6 +65,12 @@ Dynamic: license-file
 
 # GeneralManager
 
+[![PyPI](https://img.shields.io/pypi/v/GeneralManager.svg)](https://pypi.org/project/GeneralManager/)
+[![Python](https://img.shields.io/pypi/pyversions/GeneralManager.svg)](https://pypi.org/project/GeneralManager/)
+[![Build](https://github.com/TimKleindick/general_manager/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/TimKleindick/general_manager/actions/workflows/test.yml)
+[![Coverage](https://img.shields.io/codecov/c/github/TimKleindick/general_manager)](https://app.codecov.io/gh/TimKleindick/general_manager)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
 ## Overview
 
 GeneralManager is a powerful and flexible framework designed for managing and processing data. It provides a modular structure that enables developers to implement complex business logic efficiently. The module is written entirely in Python and uses Django as the backend framework.
@@ -176,4 +210,4 @@ query {
 
 ## License
 
-This project is distributed under the **Non-Commercial MIT License**. It may only be used for non-commercial purposes. For further details see the [LICENSE](./LICENSE) file.
+This project is distributed under the **MIT License**. For further details see the [LICENSE](./LICENSE) file.

{generalmanager-0.14.0 → generalmanager-0.15.0/src}/GeneralManager.egg-info/SOURCES.txt

@@ -1,20 +1,23 @@
 LICENSE
 README.md
 pyproject.toml
-GeneralManager.egg-info/PKG-INFO
-GeneralManager.egg-info/SOURCES.txt
-GeneralManager.egg-info/dependency_links.txt
-GeneralManager.egg-info/requires.txt
-GeneralManager.egg-info/top_level.txt
+src/GeneralManager.egg-info/PKG-INFO
+src/GeneralManager.egg-info/SOURCES.txt
+src/GeneralManager.egg-info/dependency_links.txt
+src/GeneralManager.egg-info/requires.txt
+src/GeneralManager.egg-info/top_level.txt
 src/general_manager/__init__.py
 src/general_manager/apps.py
+src/general_manager/api/__init__.py
 src/general_manager/api/graphql.py
 src/general_manager/api/mutation.py
 src/general_manager/api/property.py
+src/general_manager/bucket/__init__.py
 src/general_manager/bucket/baseBucket.py
 src/general_manager/bucket/calculationBucket.py
 src/general_manager/bucket/databaseBucket.py
 src/general_manager/bucket/groupBucket.py
+src/general_manager/cache/__init__.py
 src/general_manager/cache/cacheDecorator.py
 src/general_manager/cache/cacheTracker.py
 src/general_manager/cache/dependencyIndex.py
@@ -58,6 +61,7 @@ src/general_manager/utils/jsonEncoder.py
 src/general_manager/utils/makeCacheKey.py
 src/general_manager/utils/noneToZero.py
 src/general_manager/utils/pathMapping.py
+src/general_manager/utils/public_api.py
 src/general_manager/utils/testing.py
 tests/test_settings.py
 tests/test_urls.py

{generalmanager-0.14.0 → generalmanager-0.15.0/src}/GeneralManager.egg-info/requires.txt

@@ -1,5 +1,5 @@
 asgiref>=3.8.1
-Django>=5.2
+Django>=5.2.7
 django-simple-history>=3.8.0
 exrex>=0.12.0
 factory_boy>=3.3.3

generalmanager-0.15.0/src/general_manager/__init__.py

@@ -0,0 +1,49 @@
+"""Convenience access to GeneralManager core components."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from general_manager.utils.public_api import build_module_dir, resolve_export
+
+__all__ = [
+    "GraphQL",
+    "GeneralManager",
+    "GeneralManagerMeta",
+    "Input",
+    "graphQlProperty",
+    "graphQlMutation",
+    "Bucket",
+    "DatabaseBucket",
+    "CalculationBucket",
+    "GroupBucket",
+]
+
+_MODULE_MAP = {
+    "GraphQL": ("general_manager.api.graphql", "GraphQL"),
+    "graphQlProperty": ("general_manager.api.property", "graphQlProperty"),
+    "graphQlMutation": ("general_manager.api.mutation", "graphQlMutation"),
+    "GeneralManager": ("general_manager.manager.generalManager", "GeneralManager"),
+    "GeneralManagerMeta": ("general_manager.manager.meta", "GeneralManagerMeta"),
+    "Input": ("general_manager.manager.input", "Input"),
+    "Bucket": ("general_manager.bucket.baseBucket", "Bucket"),
+    "DatabaseBucket": ("general_manager.bucket.databaseBucket", "DatabaseBucket"),
+    "CalculationBucket": (
+        "general_manager.bucket.calculationBucket",
+        "CalculationBucket",
+    ),
+    "GroupBucket": ("general_manager.bucket.groupBucket", "GroupBucket"),
+}
+
+
+def __getattr__(name: str) -> Any:
+    return resolve_export(
+        name,
+        module_all=__all__,
+        module_map=_MODULE_MAP,
+        module_globals=globals(),
+    )
+
+
+def __dir__() -> list[str]:
+    return build_module_dir(module_all=__all__, module_globals=globals())

generalmanager-0.15.0/src/general_manager/api/__init__.py

@@ -0,0 +1,36 @@
+"""GraphQL helpers for GeneralManager."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from general_manager.utils.public_api import build_module_dir, resolve_export
+
+__all__ = [
+    "GraphQL",
+    "MeasurementType",
+    "MeasurementScalar",
+    "graphQlProperty",
+    "graphQlMutation",
+]
+
+_MODULE_MAP = {
+    "GraphQL": ("general_manager.api.graphql", "GraphQL"),
+    "MeasurementType": ("general_manager.api.graphql", "MeasurementType"),
+    "MeasurementScalar": ("general_manager.api.graphql", "MeasurementScalar"),
+    "graphQlProperty": ("general_manager.api.property", "graphQlProperty"),
+    "graphQlMutation": ("general_manager.api.mutation", "graphQlMutation"),
+}
+
+
+def __getattr__(name: str) -> Any:
+    return resolve_export(
+        name,
+        module_all=__all__,
+        module_map=_MODULE_MAP,
+        module_globals=globals(),
+    )
+
+
+def __dir__() -> list[str]:
+    return build_module_dir(module_all=__all__, module_globals=globals())

{generalmanager-0.14.0 → generalmanager-0.15.0}/src/general_manager/api/graphql.py

@@ -1,5 +1,7 @@
+"""GraphQL schema utilities for exposing GeneralManager models via Graphene."""
+
 from __future__ import annotations
-import graphene
+import graphene  # type: ignore[import]
 from typing import (
     Any,
     Callable,
@@ -73,9 +75,14 @@ def getReadPermissionFilter(
     info: GraphQLResolveInfo,
 ) -> list[tuple[dict[str, Any], dict[str, Any]]]:
     """
-    Returns permission-based filter and exclude constraints for querying instances of a manager class.
+    Return permission-derived filter and exclude pairs for the given manager class.
+
+    Parameters:
+        generalManagerClass (GeneralManagerMeta): Manager class being queried.
+        info (GraphQLResolveInfo): GraphQL resolver info containing the request user.
 
-    For the given manager class and user context, retrieves a list of (filter, exclude) dictionary pairs that represent the read access restrictions to be applied to queries. Returns an empty list if no permission class is defined.
+    Returns:
+        list[tuple[dict[str, Any], dict[str, Any]]]: List of ``(filter, exclude)`` mappings.
     """
     filters = []
     PermissionClass: type[BasePermission] | None = getattr(
@@ -93,10 +100,7 @@ def getReadPermissionFilter(
 
 
 class GraphQL:
-    """
-    Baut die GraphQL-Oberfläche auf und erstellt Resolver-Funktionen
-    dynamisch für die angegebene GeneralManager-Klasse.
-    """
+    """Static helper that builds GraphQL types, queries, and mutations for managers."""
 
     _query_class: type[graphene.ObjectType] | None = None
     _mutation_class: type[graphene.ObjectType] | None = None
@@ -109,16 +113,17 @@ class GraphQL:
     @classmethod
     def createGraphqlMutation(cls, generalManagerClass: type[GeneralManager]) -> None:
         """
-        Generates and registers GraphQL mutation classes for create, update, and delete operations on the specified manager class if its interface provides custom implementations.
+        Register create, update, and delete mutations for ``generalManagerClass``.
 
-        For each supported mutation, a corresponding GraphQL mutation class is created and added to the mutation registry, enabling dynamic mutation support in the schema.
+        Parameters:
+            generalManagerClass (type[GeneralManager]): Manager class whose interface drives mutation generation.
         """
 
         interface_cls: InterfaceBase | None = getattr(
             generalManagerClass, "Interface", None
         )
         if not interface_cls:
-            return
+            return None
 
         default_return_values = {
             "success": graphene.Boolean(),
@@ -147,15 +152,16 @@ class GraphQL:
     @classmethod
     def createGraphqlInterface(cls, generalManagerClass: GeneralManagerMeta) -> None:
         """
-        Creates and registers a GraphQL ObjectType for a GeneralManager subclass.
+        Build and register a Graphene ``ObjectType`` for the supplied manager class.
 
-        Introspects the manager's interface and GraphQLProperty fields, maps them to Graphene fields with appropriate resolvers, registers the resulting type in the internal registry, and adds corresponding query fields to the schema.
+        Parameters:
+            generalManagerClass (GeneralManagerMeta): Manager class whose attributes drive field generation.
         """
         interface_cls: InterfaceBase | None = getattr(
             generalManagerClass, "Interface", None
         )
         if not interface_cls:
-            return
+            return None
 
         graphene_type_name = f"{generalManagerClass.__name__}Type"
         fields: dict[str, Any] = {}
@@ -217,10 +223,13 @@ class GraphQL:
         generalManagerClass: GeneralManagerMeta,
     ) -> type[graphene.Enum] | None:
         """
-        Creates a Graphene Enum type representing sortable fields for a given GeneralManager class.
+        Build an enum of sortable fields for the provided manager class.
+
+        Parameters:
+            generalManagerClass (GeneralManagerMeta): Manager class being inspected.
 
         Returns:
-            A Graphene Enum type with options for each sortable attribute, including separate entries for the value and unit of Measurement fields. Returns None if there are no sortable fields.
+            type[graphene.Enum] | None: Enum of sortable fields, or ``None`` when no options exist.
         """
         sort_options = []
         for (
@@ -264,6 +273,16 @@ class GraphQL:
         None,
         None,
     ]:
+        """
+        Yield filter field names and Graphene types for a given attribute.
+
+        Parameters:
+            attribute_type (type): Python type declared for the attribute.
+            attribute_name (str): Name of the attribute.
+
+        Yields:
+            tuple[str, Graphene type | None]: Filter name and corresponding Graphene type.
+        """
         number_options = ["exact", "gt", "gte", "lt", "lte"]
         string_options = [
             "exact",
@@ -306,22 +325,20 @@ class GraphQL:
         field_type: GeneralManagerMeta,
     ) -> type[graphene.InputObjectType] | None:
         """
-        Dynamically generates a Graphene InputObjectType for filtering fields of a GeneralManager subclass.
-
-        Creates filter fields for each attribute based on its type, supporting numeric and string filter operations, and specialized handling for Measurement attributes. Returns the generated InputObjectType, or None if no applicable filter fields exist.
+        Create a Graphene ``InputObjectType`` for filters on ``field_type``.
 
         Parameters:
-            field_type (GeneralManagerMeta): The manager class whose attributes are used to build filter fields.
+            field_type (GeneralManagerMeta): Manager class whose attributes drive filter generation.
 
         Returns:
-            type[graphene.InputObjectType] | None: The generated filter input type, or None if no filter fields are applicable.
+            type[graphene.InputObjectType] | None: Input type containing filter fields, or ``None`` if not applicable.
         """
 
         graphene_filter_type_name = f"{field_type.__name__}FilterType"
         if graphene_filter_type_name in GraphQL.graphql_filter_type_registry:
             return GraphQL.graphql_filter_type_registry[graphene_filter_type_name]
 
-        filter_fields = {}
+        filter_fields: dict[str, Any] = {}
         for attr_name, attr_info in field_type.Interface.getAttributeTypes().items():
             attr_type = attr_info["type"]
             filter_fields = {
@@ -360,9 +377,14 @@ class GraphQL:
     @staticmethod
     def _mapFieldToGrapheneRead(field_type: type, field_name: str) -> Any:
         """
-        Maps a Python field type and name to the appropriate Graphene field for GraphQL schema generation.
+        Map a field type and name to the appropriate Graphene field for reads.
 
-        For `Measurement` fields, returns a Graphene field with an optional `target_unit` argument. For `GeneralManager` subclasses, returns a paginated field with filtering, exclusion, sorting, pagination, and grouping arguments if the field name ends with `_list`; otherwise, returns a single object field. For all other types, returns the corresponding Graphene scalar field.
+        Parameters:
+            field_type (type): Python type declared on the interface.
+            field_name (str): Attribute name being exposed.
+
+        Returns:
+            Any: Graphene field or type configured for the attribute.
         """
         if issubclass(field_type, Measurement):
             return graphene.Field(MeasurementType, target_unit=graphene.String())
@@ -398,7 +420,13 @@ class GraphQL:
     @staticmethod
     def _mapFieldToGrapheneBaseType(field_type: type) -> Type[Any]:
         """
-        Ordnet einen Python-Typ einem entsprechenden Graphene-Feld zu.
+        Map a Python type to the corresponding Graphene scalar/class.
+
+        Parameters:
+            field_type (type): Python type declared on the interface.
+
+        Returns:
+            Type[Any]: Graphene scalar or type implementing the field.
         """
         if issubclass(field_type, dict):
             raise TypeError("GraphQL does not support dict fields")
@@ -422,7 +450,13 @@ class GraphQL:
     @staticmethod
     def _parseInput(input_val: dict[str, Any] | str | None) -> dict[str, Any]:
         """
-        Wandelt einen als JSON-String oder Dict gelieferten Filter/Exclude-Parameter in ein Dict um.
+        Normalise filter/exclude input into a dictionary.
+
+        Parameters:
+            input_val (dict[str, Any] | str | None): Raw filter/exclude value.
+
+        Returns:
+            dict[str, Any]: Parsed dictionary suitable for queryset filtering.
         """
         if input_val is None:
             return {}
@@ -474,10 +508,15 @@ class GraphQL:
         info: GraphQLResolveInfo,
     ) -> Bucket:
         """
-        Applies permission-based filters to a queryset according to the permission interface of the given manager class.
+        Apply permission-based filters to ``queryset`` for the current user.
+
+        Parameters:
+            queryset (Bucket): Queryset being filtered.
+            general_manager_class (type[GeneralManager]): Manager class providing permissions.
+            info (GraphQLResolveInfo): Resolver info containing the request user.
 
         Returns:
-            A queryset containing only the items allowed by the user's read permissions. If no permission filters are defined, returns the original queryset unchanged.
+            Bucket: Queryset constrained by read permissions.
         """
         permission_filters = getReadPermissionFilter(general_manager_class, info)
         if not permission_filters:
@@ -494,9 +533,7 @@ class GraphQL:
     def _checkReadPermission(
         instance: GeneralManager, info: GraphQLResolveInfo, field_name: str
     ) -> bool:
-        """
-        Überprüft, ob der Benutzer Lesezugriff auf das jeweilige Feld hat.
-        """
+        """Return True if the user may read ``field_name`` on ``instance``."""
         PermissionClass: type[BasePermission] | None = getattr(
             instance, "Permission", None
         )
@@ -511,9 +548,14 @@ class GraphQL:
         base_getter: Callable[[Any], Any], fallback_manager_class: type[GeneralManager]
     ) -> Callable[..., Any]:
         """
-        Creates a resolver for GraphQL list fields that returns paginated, filtered, sorted, and optionally grouped results with permission checks.
+        Build a resolver for list fields applying filters, permissions, and paging.
 
-        The generated resolver applies permission-based filtering, user-specified filters and exclusions, sorting, grouping, and pagination to the list field. It returns a dictionary containing the resulting items and pagination metadata.
+        Parameters:
+            base_getter (Callable[[Any], Any]): Callable returning the base queryset.
+            fallback_manager_class (type[GeneralManager]): Manager used when ``base_getter`` returns ``None``.
+
+        Returns:
+            Callable[..., Any]: Resolver function compatible with Graphene.
         """
 
         def resolver(
@@ -691,9 +733,11 @@ class GraphQL:
         cls, graphene_type: type, generalManagerClass: GeneralManagerMeta
     ) -> None:
         """
-        Adds paginated list and single-item query fields for a GeneralManager subclass to the GraphQL schema.
+        Register list and detail query fields for ``generalManagerClass``.
 
-        The list query field enables filtering, exclusion, sorting, pagination, and grouping, returning a paginated result with metadata. The single-item query field retrieves an instance by its identification fields. Both queries are registered with their respective resolvers.
+        Parameters:
+            graphene_type (type): Graphene ``ObjectType`` representing the manager.
+            generalManagerClass (GeneralManagerMeta): Manager class being exposed.
         """
         if not issubclass(generalManagerClass, GeneralManager):
             raise TypeError(
@@ -701,7 +745,7 @@ class GraphQL:
             )
 
         if not hasattr(cls, "_query_fields"):
-            cls._query_fields: dict[str, Any] = {}
+            cls._query_fields = cast(dict[str, Any], {})
 
         # resolver and field for the list query
         list_field_name = f"{generalManagerClass.__name__.lower()}_list"
@@ -761,12 +805,13 @@ class GraphQL:
     @classmethod
     def createWriteFields(cls, interface_cls: InterfaceBase) -> dict[str, Any]:
         """
-        Generates a dictionary of Graphene input fields for mutations based on the attributes of the provided interface class.
+        Generate Graphene input fields for writable interface attributes.
 
-        Skips system-managed and derived attributes. For attributes referencing `GeneralManager` subclasses, uses an ID or list of IDs as appropriate. Other types are mapped to their corresponding Graphene scalar types. Each field is annotated with an `editable` attribute. Always includes an optional `history_comment` field marked as editable.
+        Parameters:
+            interface_cls (InterfaceBase): Interface whose attributes drive the input field map.
 
         Returns:
-            dict[str, Any]: Mapping of attribute names to Graphene input fields for mutation arguments.
+            dict[str, Any]: Mapping of attribute names to Graphene field definitions.
         """
         fields: dict[str, Any] = {}
 
@@ -827,7 +872,7 @@ class GraphQL:
             generalManagerClass, "Interface", None
         )
         if not interface_cls:
-            return
+            return None
 
         def create_mutation(
             self,
@@ -898,7 +943,7 @@ class GraphQL:
             generalManagerClass, "Interface", None
         )
         if not interface_cls:
-            return
+            return None
 
         def update_mutation(
             self,
@@ -975,7 +1020,7 @@ class GraphQL:
             generalManagerClass, "Interface", None
         )
         if not interface_cls:
-            return
+            return None
 
         def delete_mutation(
             self,
@@ -1030,9 +1075,13 @@ class GraphQL:
     @staticmethod
     def _handleGraphQLError(error: Exception) -> None:
         """
-        Raises a GraphQLError with a specific error code based on the exception type.
+        Raise a ``GraphQLError`` with a code based on the exception type.
+
+        Parameters:
+            error (Exception): Exception raised during mutation execution.
 
-        PermissionError results in "PERMISSION_DENIED", ValueError or ValidationError in "BAD_USER_INPUT", and all other exceptions in "INTERNAL_SERVER_ERROR".
+        Raises:
+            GraphQLError: Error with an appropriate ``extensions['code']`` value.
         """
         if isinstance(error, PermissionError):
             raise GraphQLError(