jetpytools 1.7.2__py3-none-any.whl → 1.7.4__py3-none-any.whl

jetpytools/_metadata.py

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

jetpytools/types/generic.py

@@ -6,7 +6,7 @@ from typing import Any, Callable, Literal, TypeAlias, Union
 from .builtins import F, SingleOrArr, SingleOrArrOpt
 from .supports import SupportsString
 
-__all__ = ["MISSING", "DataType", "FuncExcept", "MissingT", "PassthroughC", "StrArr", "StrArrOpt"]
+__all__ = ["MISSING", "DataType", "FuncExcept", "FuncExceptT", "MissingT", "PassthroughC", "StrArr", "StrArrOpt"]
 
 
 class _MissingType(Enum):

jetpytools/types/utils.py

@@ -23,9 +23,9 @@ from typing import (
     overload,
 )
 
-from typing_extensions import Self, deprecated
+from typing_extensions import Self, TypeVar, deprecated
 
-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
+from .builtins import F0, F1, P0, P1, R0, T0, KwargsT, P, R, R0_co, R1_co, R_co, T, T0_co, T1_co, T_co
 
 __all__ = [
     "KwargsNotNone",
@@ -43,9 +43,9 @@ __all__ = [
 # ruff: noqa: N801
 
 
-class copy_signature(Generic[F0]):
+def copy_signature(target: F0, /) -> Callable[[Callable[..., Any]], F0]:
     """
-    Type util to copy the signature of one function to another function.
+    Utility function to copy the signature of one function to another one.
 
     Especially useful for passthrough functions.
 
@@ -71,12 +71,11 @@ class copy_signature(Generic[F0]):
                # another thing
     """
 
-    def __init__(self, target: F0) -> None:
-        """Copy the signature of ``target``."""
-
-    def __call__(self, wrapped: Callable[..., Any]) -> F0:
+    def decorator(wrapped: Callable[..., Any]) -> F0:
         return cast(F0, wrapped)
 
+    return decorator
+
 
 class injected_self_func(Protocol[T_co, P, R_co]):
     @overload
@@ -402,35 +401,37 @@ def get_subclasses(family: type[T], exclude: Sequence[type[T]] = []) -> list[typ
     return list(set(_subclasses(family)))
 
 
-class classproperty_base(Generic[T, R_co]):
+_T_Any = TypeVar("_T_Any", default=Any)
+_T0_Any = TypeVar("_T0_Any", default=Any)
+
+
+class classproperty_base(Generic[T, R_co, _T_Any]):
     __isabstractmethod__: bool = False
 
+    fget: Callable[[type[T]], R_co]
+    fset: Callable[Concatenate[type[T], _T_Any, ...], None] | None
+    fdel: Callable[[type[T]], None] | None
+
     def __init__(
         self,
         fget: Callable[[type[T]], R_co] | classmethod[T, ..., R_co],
-        fset: Callable[Concatenate[type[T], Any, ...], None]
-        | classmethod[T, Concatenate[Any, ...], None]
+        fset: Callable[Concatenate[type[T], _T_Any, ...], None]
+        | classmethod[T, Concatenate[_T_Any, ...], None]
         | None = None,
         fdel: Callable[[type[T]], None] | classmethod[T, ..., None] | None = None,
         doc: str | None = None,
     ) -> None:
-        self.fget = self._wrap(fget)
-        self.fset = self._wrap(fset) if fset is not None else fset
-        self.fdel = self._wrap(fdel) if fdel is not None else fdel
+        self.fget = fget.__func__ if isinstance(fget, classmethod) else fget
+        self.fset = fset.__func__ if isinstance(fset, classmethod) else fset
+        self.fdel = fdel.__func__ if isinstance(fdel, classmethod) 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):
-            func = classmethod(func)
-
-        return func
-
     def __set_name__(self, owner: object, name: str) -> None:
         self.__name__ = name
 
-    def _get_cache(self, type_: type) -> dict[str, Any]:
+    def _get_cache(self, type_: type[T]) -> dict[str, Any]:
         cache_key = getattr(self, "cache_key")
 
         if not hasattr(type_, cache_key):
@@ -438,21 +439,23 @@ class classproperty_base(Generic[T, R_co]):
 
         return getattr(type_, cache_key)
 
-    def __get__(self, obj: T | None, type_: type | None = None) -> R_co:
-        if type_ is None:
+    def __get__(self, obj: T | None, type_: type[T] | None = None) -> R_co:
+        if type_ is None and obj is not None:
             type_ = type(obj)
+        elif type_ is None:
+            raise NotImplementedError("Both obj and type_ are None")
 
         if not isinstance(self, classproperty.cached):
-            return self.fget.__get__(obj, type_)()
+            return self.fget(type_)
 
         if self.__name__ in (cache := self._get_cache(type_)):
             return cache[self.__name__]
 
-        value = self.fget.__get__(obj, type_)()
+        value = self.fget(type_)
         cache[self.__name__] = value
         return value
 
-    def __set__(self, obj: T, value: Any) -> None:
+    def __set__(self, obj: T, value: _T_Any) -> None:
         if not self.fset:
             raise AttributeError(
                 f'classproperty with getter "{self.__name__}" of "{obj.__class__.__name__}" object has no setter.'
@@ -460,10 +463,13 @@ class classproperty_base(Generic[T, R_co]):
 
         type_ = type(obj)
 
+        if not isinstance(self, classproperty.cached):
+            return self.fset(type_, value)
+
         if self.__name__ in (cache := self._get_cache(type_)):
             del cache[self.__name__]
 
-        self.fset.__get__(None, type_)(value)
+        self.fset(type_, value)
 
     def __delete__(self, obj: T) -> None:
         if not self.fdel:
@@ -473,18 +479,21 @@ class classproperty_base(Generic[T, R_co]):
 
         type_ = type(obj)
 
+        if not isinstance(self, classproperty.cached):
+            return self.fdel(type_)
+
         if self.__name__ in (cache := self._get_cache(type_)):
             del cache[self.__name__]
 
-        self.fdel.__get__(None, type_)()
+        self.fdel(type_)
 
 
-class classproperty(classproperty_base[T, R_co]):
+class classproperty(classproperty_base[T, R_co, _T_Any]):
     """
     A combination of `classmethod` and `property`.
     """
 
-    class cached(classproperty_base[T0, R0_co]):
+    class cached(classproperty_base[T0, R0_co, _T0_Any]):
         """
         A combination of `classmethod` and `property`.
 
@@ -517,7 +526,7 @@ class classproperty(classproperty_base[T, R_co]):
                     del cache[name]
 
 
-class cachedproperty(property, Generic[R_co]):
+class cachedproperty(property, Generic[R_co, _T_Any]):
     """
     Wrapper for a one-time get property, that will be cached.
 
@@ -539,16 +548,16 @@ class cachedproperty(property, Generic[R_co]):
         def __init__(
             self,
             fget: Callable[[Any], R_co],
-            fset: Callable[[Any, Any], None] | None = None,
+            fset: Callable[[Any, _T_Any], None] | None = None,
             fdel: Callable[[Any], None] | None = None,
             doc: str | None = None,
         ) -> None: ...
 
-        def getter(self, fget: Callable[..., R_co]) -> cachedproperty[R_co]: ...
+        def getter(self, fget: Callable[..., R_co]) -> cachedproperty[R_co, _T_Any]: ...
 
-        def setter(self, fset: Callable[[Any, Any], None]) -> cachedproperty[R_co]: ...
+        def setter(self, fset: Callable[[Any, _T_Any], None]) -> cachedproperty[R_co, _T_Any]: ...
 
-        def deleter(self, fdel: Callable[..., None]) -> cachedproperty[R_co]: ...
+        def deleter(self, fdel: Callable[..., None]) -> cachedproperty[R_co, _T_Any]: ...
 
     if sys.version_info < (3, 13):
 
@@ -573,7 +582,7 @@ class cachedproperty(property, Generic[R_co]):
         cache[self.__name__] = value
         return value
 
-    def __set__(self, instance: Any, value: Any) -> None:
+    def __set__(self, instance: Any, value: _T_Any) -> None:
         if self.__name__ in (cache := instance.__dict__.setdefault(self.cache_key, {})):
             del cache[self.__name__]
 
@@ -605,6 +614,17 @@ class cachedproperty(property, Generic[R_co]):
             with suppress(KeyError):
                 del cache[name]
 
+    @classmethod
+    def update_cache(cls, obj: object, name: str, value: Any) -> None:
+        """
+        Update cached property of an object instance.
+
+        :param obj:   The object whose cache should be updated.
+        :param names: Property name to update.
+        :param value: The value to assign.
+        """
+        obj.__dict__.setdefault(cls.cache_key, {})[name] = value
+
 
 class KwargsNotNone(KwargsT):
     """Remove all None objects from this kwargs dict."""

jetpytools/utils/file.py

@@ -48,7 +48,8 @@ def get_script_path() -> SPath:
     import __main__
 
     try:
-        return SPath(__main__.__file__)
+        path = SPath(__main__.__file__)
+        return path if path.exists() else SPath.cwd()
     except AttributeError:
         return SPath.cwd()
 

{jetpytools-1.7.2.dist-info → jetpytools-1.7.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetpytools
-Version: 1.7.2
+Version: 1.7.4
 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.7.2.dist-info → jetpytools-1.7.4.dist-info}/RECORD

@@ -1,5 +1,5 @@
 jetpytools/__init__.py,sha256=ha_pCOMqfeIbipDRrtqKOqH3NQEpX4KwN2SskpsCGb4,114
-jetpytools/_metadata.py,sha256=1gq8Xhbmpvzz3wxNKv9JFIJ9qn3tzlccU0sOEbmUkUU,414
+jetpytools/_metadata.py,sha256=Ctf45XxZkSp6UiAUvlc0xW27P8V4tEMiFFSZtpGLKxA,414
 jetpytools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 jetpytools/enums/__init__.py,sha256=TvEt3TWmnzf2TWS_Gd6llyyXAGDKxdhdJsDgSvT7xys,41
 jetpytools/enums/base.py,sha256=s5A9iQS22JdaZMM6jEXI31m0ZjtBx7GLQ-E0xBr90Zc,2032
@@ -19,15 +19,15 @@ jetpytools/types/builtins.py,sha256=4uAutpHlkcKM3K_6BbWomqR2QgWNt6294FHE3Ck_ZIA,
 jetpytools/types/check.py,sha256=ktQOykmryUkDa2j-zcL6uEWF8QlxJ4GW8YKdbqMHGcc,959
 jetpytools/types/file.py,sha256=LbOwMAwDALWxAZZ2i7ZNexoN3GHWD-uUoIhVvUy95Vo,6539
 jetpytools/types/funcs.py,sha256=U5tBmTtLS5CLp3ZtOiA5101PQiCWQOBsmf0bj1pRwgY,2778
-jetpytools/types/generic.py,sha256=yCavU0bBXGh15-PxIlQE78xj05kpxMVTAGI7xAoon2Y,1121
+jetpytools/types/generic.py,sha256=RRg2U7wxaM4Uzwc6QvsO99euCF3sqr8Kh34XKtVbgT8,1136
 jetpytools/types/supports.py,sha256=woMTv62HpcRiC5TG18U8NU5v2Q6iqcrHzQgXl7QYEws,3516
-jetpytools/types/utils.py,sha256=tIN6OdjrwHxb8XyQeptWh4YbOKdABPOZkKpONZ7eAv8,22877
+jetpytools/types/utils.py,sha256=2E7eNZjwlkQIL-9KC7xj7nMULTHoivrUI22rdzPRw88,23651
 jetpytools/utils/__init__.py,sha256=_rJ-mY5PsGjBfy8Fihx_FYJfAIGSrYAYzI6Td9oFh9A,83
-jetpytools/utils/file.py,sha256=uJV8_S-ctu9Ya9ZR8Kp4QFZ6R62_PnaxAzsiAj2xFIE,10568
+jetpytools/utils/file.py,sha256=3fJxAHjIN5zdyzO0guc3jDspcs5HPG4t4cwB_ZrAhh4,10622
 jetpytools/utils/funcs.py,sha256=2qhFyLD0OLvenjzOu2wu1ZWoZGzQ8aPmvbkAI1i9Gvk,914
 jetpytools/utils/math.py,sha256=I56OeHDDJl3X8EFXMWVEiXGAD16AKcn8KVnFuP5fFes,3445
 jetpytools/utils/ranges.py,sha256=glxypgmuzauV6KCSNujNHOdWkNEUNylOUAPS618jnIg,2559
-jetpytools-1.7.2.dist-info/METADATA,sha256=LN7XIprsH4za_VaporgeHwpwCPeBvmOOzjZeaHz9kl0,1198
-jetpytools-1.7.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-jetpytools-1.7.2.dist-info/licenses/LICENSE,sha256=l0PN-qDtXcgOB5aXP_nSUsvCK5V3o9pQCGsTzyZhKL0,1071
-jetpytools-1.7.2.dist-info/RECORD,,
+jetpytools-1.7.4.dist-info/METADATA,sha256=DP5E8ygPnwnPuriFpgxkrCLDQUqjzU93xiU-m1XnmD0,1198
+jetpytools-1.7.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+jetpytools-1.7.4.dist-info/licenses/LICENSE,sha256=l0PN-qDtXcgOB5aXP_nSUsvCK5V3o9pQCGsTzyZhKL0,1071
+jetpytools-1.7.4.dist-info/RECORD,,