jetpytools 1.6.4__py3-none-any.whl → 1.7.0__py3-none-any.whl

jetpytools/_metadata.py

@@ -1,6 +1,6 @@
 """Collection of stuff that's useful in general python programming"""
 
-__version__ = "1.6.4"
+__version__ = "1.7.0"
 
 __author_name__, __author_email__ = "Jaded Encoding Thaumaturgy", "jaded.encoding.thaumaturgy@gmail.com"
 __maintainer_name__, __maintainer_email__ = __author_name__, __author_email__

jetpytools/exceptions/base.py

@@ -175,7 +175,7 @@ class CustomError(ExceptionError, metaclass=CustomErrorMeta):
 
         return out
 
-    if sys.version_info < (3, 13):
+    if sys.version_info < (3, 11):
         __notes__: list[str]
 
         def add_note(self, note: str, /) -> None:

jetpytools/types/utils.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
-from functools import partial, wraps
+from contextlib import suppress
+from functools import wraps
 from inspect import Signature
 from inspect import _empty as empty_param
 from typing import (
@@ -21,9 +22,9 @@ from typing import (
     overload,
 )
 
-from typing_extensions import Self
+from typing_extensions import Self, deprecated
 
-from .builtins import F0, F1, P0, P1, R0, R1, T0, T1, T2, KwargsT, P, R, R0_co, R1_co, R_co, T, T0_co, T1_co, T_co
+from .builtins import F0, F1, P0, P1, R0, R1, T0, KwargsT, P, R, R0_co, R1_co, R_co, T, T0_co, T1_co, T_co
 
 __all__ = [
     "KwargsNotNone",
@@ -400,17 +401,15 @@ def get_subclasses(family: type[T], exclude: Sequence[type[T]] = []) -> list[typ
     return list(set(_subclasses(family)))
 
 
-class classproperty(Generic[T, R]):
-    """
-    Make a class property. A combination between classmethod and property.
-    """
-
+class classproperty_base(Generic[T, R_co]):
     __isabstractmethod__: bool = False
 
     def __init__(
         self,
-        fget: Callable[[type[T]], R] | classmethod[T, ..., R],
-        fset: Callable[[type[T], R], None] | classmethod[T, Concatenate[R, ...], None] | None = None,
+        fget: Callable[[type[T]], R_co] | classmethod[T, ..., R_co],
+        fset: Callable[Concatenate[type[T], Any, ...], None]
+        | classmethod[T, Concatenate[Any, ...], None]
+        | None = None,
         fdel: Callable[[type[T]], None] | classmethod[T, ..., None] | None = None,
         doc: str | None = None,
     ) -> None:
@@ -419,6 +418,7 @@ class classproperty(Generic[T, R]):
         self.fdel = self._wrap(fdel) if fdel is not None else fdel
 
         self.__doc__ = doc
+        self.__name__ = self.fget.__name__
 
     def _wrap(self, func: Callable[..., R1] | classmethod[T, P1, R1]) -> classmethod[T, P1, R1]:
         if not isinstance(func, classmethod):
@@ -426,11 +426,30 @@ class classproperty(Generic[T, R]):
 
         return func
 
-    def __get__(self, obj: T | None, type_: type | None = None) -> R:
+    def __set_name__(self, owner: object, name: str) -> None:
+        self.__name__ = name
+
+    def _get_cache(self, type_: type) -> dict[str, Any]:
+        cache_key = getattr(self, "cache_key")
+
+        if not hasattr(type_, cache_key):
+            setattr(type_, cache_key, {})
+
+        return getattr(type_, cache_key)
+
+    def __get__(self, obj: T | None, type_: type | None = None) -> R_co:
         if type_ is None:
             type_ = type(obj)
 
-        return self.fget.__get__(obj, type_)()
+        if not isinstance(self, classproperty.cached):
+            return self.fget.__get__(obj, type_)()
+
+        if self.__name__ in (cache := self._get_cache(type_)):
+            return cache[self.__name__]
+
+        value = self.fget.__get__(obj, type_)()
+        cache[self.__name__] = value
+        return value
 
     def __set__(self, obj: T, value: Any) -> None:
         if not self.fset:
@@ -438,7 +457,12 @@ class classproperty(Generic[T, R]):
                 f'classproperty with getter "{self.__name__}" of "{obj.__class__.__name__}" object has no setter.'
             )
 
-        self.fset.__get__(None, type(obj))(value)
+        type_ = type(obj)
+
+        if self.__name__ in (cache := self._get_cache(type_)):
+            del cache[self.__name__]
+
+        self.fset.__get__(None, type_)(value)
 
     def __delete__(self, obj: T) -> None:
         if not self.fdel:
@@ -446,88 +470,133 @@ class classproperty(Generic[T, R]):
                 f'classproperty with getter "{self.__name__}" of "{obj.__class__.__name__}" object has no deleter.'
             )
 
-        self.fdel.__get__(None, type(obj))()
+        type_ = type(obj)
 
-    @property
-    def __name__(self) -> str:
-        return self.fget.__name__
+        if self.__name__ in (cache := self._get_cache(type_)):
+            del cache[self.__name__]
+
+        self.fdel.__get__(None, type_)()
 
 
-class cachedproperty(property, Generic[P, R_co, T, T0, P0]):
+class classproperty(classproperty_base[T, R_co]):
     """
-    Wrapper for a one-time get property, that will be cached.
+    A combination of `classmethod` and `property`.
+    """
+
+    class cached(classproperty_base[T0, R0_co]):
+        """
+        A combination of `classmethod` and `property`.
+
+        The value is computed once and then cached in a dictionary (under `cache_key`)
+        attached to the class type. If a setter or deleter is defined and invoked,
+        the cache is cleared.
+        """
 
-    Keep in mind two things:
+        cache_key = "_jetpt_classproperty_cached"
+
+        @classmethod
+        def clear_cache(cls, type_: type, names: str | Iterable[str] | None = None) -> None:
+            """
+            Clear cached properties of an type instance.
 
-     * The cache is per-object. Don't hold a reference to itself or it will never get garbage collected.
-     * Your class has to either manually set __dict__[cachedproperty.cache_key]
-       or inherit from cachedproperty.baseclass.
+            :param type_:   The type whose cache should be cleared.
+            :param names:   Specific property names to clear. If None, all cached properties are cleared.
+            """
+            if names is None:
+                with suppress(AttributeError):
+                    getattr(type_, cls.cache_key).clear()
+                return None
+
+            from ..functions import to_arr
+
+            cache = getattr(type_, cls.cache_key, {})
+
+            for name in to_arr(names):
+                with suppress(KeyError):
+                    del cache[name]
+
+
+class cachedproperty(property, Generic[R_co]):
+    """
+    Wrapper for a one-time get property, that will be cached.
+
+    You shouldn't hold a reference to itself or it will never get garbage collected.
     """
 
     __isabstractmethod__: bool = False
 
     cache_key = "_jetpt_cachedproperty_cache"
 
+    @deprecated(
+        "The cache dict is now set automatically. You no longer need to inherit from it", category=DeprecationWarning
+    )
     class baseclass:
         """Inherit from this class to automatically set the cache dict."""
 
-        if not TYPE_CHECKING:
-
-            def __new__(cls, *args: Any, **kwargs: Any) -> None:
-                try:
-                    self = super().__new__(cls, *args, **kwargs)
-                except TypeError:
-                    self = super().__new__(cls)
-                self.__dict__.__setitem__(cachedproperty.cache_key, dict[str, Any]())
-                return self
-
     if TYPE_CHECKING:
 
         def __init__(
             self,
-            fget: Callable[P, R_co],
-            fset: Callable[[T, T0], None] | None = None,
-            fdel: Callable[P0, None] | None = None,
+            fget: Callable[[Any], R_co],
+            fset: Callable[[Any, Any], None] | None = None,
+            fdel: Callable[[Any], None] | None = None,
             doc: str | None = None,
         ) -> None: ...
 
-        def getter(self, fget: Callable[P1, R0_co]) -> cachedproperty[P1, R0_co, T, T0, P0]: ...
+        def getter(self, fget: Callable[..., R_co]) -> cachedproperty[R_co]: ...
 
-        def setter(self, fset: Callable[[T1, T2], None]) -> cachedproperty[P, R_co, T1, T2, P0]: ...
+        def setter(self, fset: Callable[[Any, Any], None]) -> cachedproperty[R_co]: ...
 
-        def deleter(self, fdel: Callable[P1, None]) -> cachedproperty[P, R_co, T, T0, P1]: ...
+        def deleter(self, fdel: Callable[..., None]) -> cachedproperty[R_co]: ...
 
     @overload
-    def __get__(self, obj: None, type_: type | None = None) -> Self: ...
+    def __get__(self, instance: None, owner: type | None = None) -> Self: ...
 
     @overload
-    def __get__(self, obj: object, type_: type | None = None) -> R_co: ...
+    def __get__(self, instance: Any, owner: type | None = None) -> R_co: ...
 
-    def __get__(self, obj: Any, type_: type | None = None) -> Any:
-        if isinstance(self.fget, classproperty):
-            function = partial(self.fget.__get__, obj, type_)  # type: ignore
-            obj = type_
+    def __get__(self, instance: Any, owner: type | None = None) -> Any:
+        if instance is None:
+            return self
 
-            if not hasattr(obj, cachedproperty.cache_key):
-                setattr(obj, cachedproperty.cache_key, dict[str, Any]())
+        if self.__name__ in (cache := instance.__dict__.setdefault(self.cache_key, {})):
+            return cache[self.__name__]
 
-            cache = getattr(obj, cachedproperty.cache_key)
-            name = self.fget.__name__
-        else:
-            assert self.fget
-            function = self.fget.__get__(obj, type_)
-            cache = obj.__dict__.get(cachedproperty.cache_key)
-            name = function.__name__
+        value = super().__get__(instance, owner)
+        cache[self.__name__] = value
+        return value
 
-        if name not in cache:
-            cache[name] = function()
+    def __set__(self, instance: Any, value: Any) -> None:
+        if self.__name__ in (cache := instance.__dict__.setdefault(self.cache_key, {})):
+            del cache[self.__name__]
 
-        return cache[name]
+        return super().__set__(instance, value)
 
-    if TYPE_CHECKING:
+    def __delete__(self, instance: Any) -> None:
+        if self.__name__ in (cache := instance.__dict__.setdefault(self.cache_key, {})):
+            del cache[self.__name__]
+
+        return super().__delete__(instance)
+
+    @classmethod
+    def clear_cache(cls, obj: object, names: str | Iterable[str] | None = None) -> None:
+        """
+        Clear cached properties of an object instance.
+
+        :param obj:   The object whose cache should be cleared.
+        :param names: Specific property names to clear. If None, all cached properties are cleared.
+        """
+        if names is None:
+            obj.__dict__.get(cls.cache_key, {}).clear()
+            return None
+
+        from ..functions import to_arr
+
+        cache = obj.__dict__.get(cls.cache_key, {})
 
-        def __set__(self, obj: Any, value: R_co, /) -> None:  # type: ignore[misc]
-            ...
+        for name in to_arr(names):
+            with suppress(KeyError):
+                del cache[name]
 
 
 class KwargsNotNone(KwargsT):

{jetpytools-1.6.4.dist-info → jetpytools-1.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetpytools
-Version: 1.6.4
+Version: 1.7.0
 Summary: Collection of stuff that's useful in general python programming
 Project-URL: Source Code, https://github.com/Jaded-Encoding-Thaumaturgy/jetpytools
 Project-URL: Contact, https://discord.gg/XTpc6Fa9eB

{jetpytools-1.6.4.dist-info → jetpytools-1.7.0.dist-info}/RECORD

@@ -1,11 +1,11 @@
 jetpytools/__init__.py,sha256=ha_pCOMqfeIbipDRrtqKOqH3NQEpX4KwN2SskpsCGb4,114
-jetpytools/_metadata.py,sha256=Kz2pkpjUD7YTrr5arStAyNIRsjl0u-lpfclBzyrM6ss,414
+jetpytools/_metadata.py,sha256=3W5CtWRlEtbGoTDF01K0zcMyjXfrii4o8Rdz1tDvRKE,414
 jetpytools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 jetpytools/enums/__init__.py,sha256=TvEt3TWmnzf2TWS_Gd6llyyXAGDKxdhdJsDgSvT7xys,41
 jetpytools/enums/base.py,sha256=L5dk6UAsQ3V6GVj0vulKaiJsholnh0Ftyh1FZFM9zwI,2034
 jetpytools/enums/other.py,sha256=9GGRS4P-P589C1HqNpDDBhLdphID1trwCJi7pbXT0iM,1317
 jetpytools/exceptions/__init__.py,sha256=0rNEfnOuoSRUyKsutGzHFWQkgiFaK7diOT4VbRVKt9c,105
-jetpytools/exceptions/base.py,sha256=FHP1jNG6es0hFqHFGedJUdx8s5DAItdyHgczD8Bi0po,7649
+jetpytools/exceptions/base.py,sha256=cCVT-v-mJoWzLvOxB5SG5dkeGAM_allXAuRgjfI9H6E,7649
 jetpytools/exceptions/enum.py,sha256=euR6cyMetVWSfTgO5rkblhQyEgusdwhx6Rd9I5ZoFbA,293
 jetpytools/exceptions/file.py,sha256=7Eh4aPo4r1W-ppnf6XLwWaStOSjIxw9JfzOCa4W7m8E,1105
 jetpytools/exceptions/generic.py,sha256=5LYQHdSLM2wu5fv40PTrjkW9v0iq8R-QlQzhVsiLLpE,1509
@@ -21,13 +21,13 @@ jetpytools/types/file.py,sha256=LbOwMAwDALWxAZZ2i7ZNexoN3GHWD-uUoIhVvUy95Vo,6539
 jetpytools/types/funcs.py,sha256=U5tBmTtLS5CLp3ZtOiA5101PQiCWQOBsmf0bj1pRwgY,2778
 jetpytools/types/generic.py,sha256=SFnUqDAVehKZ36HmLrs9PN4Ze0BLcabPjwC7hJsGp4w,1102
 jetpytools/types/supports.py,sha256=woMTv62HpcRiC5TG18U8NU5v2Q6iqcrHzQgXl7QYEws,3516
-jetpytools/types/utils.py,sha256=eEypP1hh3bubw4J_Rr8InEQnr0XG1myLmXnmwYPLM-c,20410
+jetpytools/types/utils.py,sha256=oISv8o8xD1BS-MjsEDpDBitDQPfkGou1FoyN4EsHYa8,22614
 jetpytools/utils/__init__.py,sha256=_rJ-mY5PsGjBfy8Fihx_FYJfAIGSrYAYzI6Td9oFh9A,83
 jetpytools/utils/file.py,sha256=um4ow7_UEH1UxOV74w6F1u4s0wC4zh98LrcwBYjed50,10578
 jetpytools/utils/funcs.py,sha256=2qhFyLD0OLvenjzOu2wu1ZWoZGzQ8aPmvbkAI1i9Gvk,914
 jetpytools/utils/math.py,sha256=I56OeHDDJl3X8EFXMWVEiXGAD16AKcn8KVnFuP5fFes,3445
 jetpytools/utils/ranges.py,sha256=glxypgmuzauV6KCSNujNHOdWkNEUNylOUAPS618jnIg,2559
-jetpytools-1.6.4.dist-info/METADATA,sha256=iqiVQW2Y0BuI-LNOfzLNcFW9vtUix24loH4qbvz39Yw,1198
-jetpytools-1.6.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-jetpytools-1.6.4.dist-info/licenses/LICENSE,sha256=l0PN-qDtXcgOB5aXP_nSUsvCK5V3o9pQCGsTzyZhKL0,1071
-jetpytools-1.6.4.dist-info/RECORD,,
+jetpytools-1.7.0.dist-info/METADATA,sha256=iB6mPlOU_lgtyaIwSz1RM-NSe77g-P9r3FepRPCgrI8,1198
+jetpytools-1.7.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+jetpytools-1.7.0.dist-info/licenses/LICENSE,sha256=l0PN-qDtXcgOB5aXP_nSUsvCK5V3o9pQCGsTzyZhKL0,1071
+jetpytools-1.7.0.dist-info/RECORD,,