ddutils 0.2.1__tar.gz → 0.2.2__tar.gz

{ddutils-0.2.1 → ddutils-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ddutils
-Version: 0.2.1
+Version: 0.2.2
 Summary: Domain Driven Utils Library
 Keywords: python,ddutils
 Author: davyddd
@@ -191,6 +191,31 @@ get_origin_class_of_method(C, 'method')  # <class 'C'>
 get_origin_class_of_method(B, 'method')  # <class 'A'>
 ```
 
+### get_generic_base_argument
+
+Returns the type argument a class bound to a generic base when subclassing it. `None` when the base was not
+subscripted, the `TypeVar` itself when the subclass is still generic.
+
+```python
+from typing import Generic, TypeVar
+
+from ddutils.class_helpers import get_generic_base_argument
+
+T = TypeVar('T')
+
+
+class Repository(Generic[T]):
+    pass
+
+
+class UserRepository(Repository[User]):
+    pass
+
+
+get_generic_base_argument(UserRepository, Repository)  # <class 'User'>
+get_generic_base_argument(Repository, Repository)      # None
+```
+
 ## Function Helpers
 
 Tools for creating and modifying Python functions at runtime.

{ddutils-0.2.1 → ddutils-0.2.2}/README.md

@@ -173,6 +173,31 @@ get_origin_class_of_method(C, 'method')  # <class 'C'>
 get_origin_class_of_method(B, 'method')  # <class 'A'>
 ```
 
+### get_generic_base_argument
+
+Returns the type argument a class bound to a generic base when subclassing it. `None` when the base was not
+subscripted, the `TypeVar` itself when the subclass is still generic.
+
+```python
+from typing import Generic, TypeVar
+
+from ddutils.class_helpers import get_generic_base_argument
+
+T = TypeVar('T')
+
+
+class Repository(Generic[T]):
+    pass
+
+
+class UserRepository(Repository[User]):
+    pass
+
+
+get_generic_base_argument(UserRepository, Repository)  # <class 'User'>
+get_generic_base_argument(Repository, Repository)      # None
+```
+
 ## Function Helpers
 
 Tools for creating and modifying Python functions at runtime.

{ddutils-0.2.1 → ddutils-0.2.2}/ddutils/class_helpers.py

@@ -1,6 +1,6 @@
 import inspect
 from collections.abc import Callable
-from typing import Any, TypeVar
+from typing import Any, TypeVar, get_args, get_origin
 
 _T = TypeVar('_T', bound=Any)
 
@@ -25,6 +25,26 @@ def get_origin_class_of_method(cls: Any, method_name: str) -> type | None:
     return None
 
 
+def get_generic_base_argument(cls: type, generic_base: type, position: int = 0) -> Any | None:
+    """
+    Return the type argument that `cls` bound to `generic_base` when subclassing it.
+
+    For `class ProfileCache(GenericCache[Profile])` this is `Profile`. Returns `None` when `cls` does not
+    subscript `generic_base` (`class Cache(GenericCache)`), and a `TypeVar` when the subclass is still
+    generic (`class Base[T](GenericCache[T])`), so callers can reject both cases in `__init_subclass__`.
+
+    Args:
+        cls: The class to inspect.
+        generic_base: The generic base class whose argument to look up.
+        position: Index of the argument for bases with several type parameters.
+    """
+    for base in getattr(cls, '__orig_bases__', ()):
+        if get_origin(base) is generic_base:
+            arguments = get_args(base)
+            return arguments[position] if position < len(arguments) else None
+    return None
+
+
 class classproperty:  # noqa: N801
     """
     A descriptor that defines a read-only property at the class level.

{ddutils-0.2.1 → ddutils-0.2.2}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "ddutils"
 description = "Domain Driven Utils Library"
-version = "0.2.1"
+version = "0.2.2"
 license = "MIT"
 license-files = ["LICENSE"]
 readme = "README.md"

{ddutils-0.2.1 → ddutils-0.2.2}/pyproject.toml.orig

@@ -1,7 +1,7 @@
 [project]
 name = "ddutils"
 description = "Domain Driven Utils Library"
-version = "0.2.1"
+version = "0.2.2"
 authors = [{ name = "davyddd" }]
 license = "MIT"
 license-files = ["LICENSE"]