jetpytools 1.7.2__tar.gz → 1.7.3__tar.gz

{jetpytools-1.7.2 → jetpytools-1.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetpytools
-Version: 1.7.2
+Version: 1.7.3
 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 → jetpytools-1.7.3}/jetpytools/_metadata.py

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

{jetpytools-1.7.2 → jetpytools-1.7.3}/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-1.7.2 → jetpytools-1.7.3}/jetpytools/types/utils.py

@@ -23,7 +23,7 @@ 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
 
@@ -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
@@ -517,7 +516,10 @@ class classproperty(classproperty_base[T, R_co]):
                     del cache[name]
 
 
-class cachedproperty(property, Generic[R_co]):
+_T_cc = TypeVar("_T_cc", default=Any)
+
+
+class cachedproperty(property, Generic[R_co, _T_cc]):
     """
     Wrapper for a one-time get property, that will be cached.
 
@@ -539,16 +541,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_cc], 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_cc]: ...
 
-        def setter(self, fset: Callable[[Any, Any], None]) -> cachedproperty[R_co]: ...
+        def setter(self, fset: Callable[[Any, _T_cc], None]) -> cachedproperty[R_co, _T_cc]: ...
 
-        def deleter(self, fdel: Callable[..., None]) -> cachedproperty[R_co]: ...
+        def deleter(self, fdel: Callable[..., None]) -> cachedproperty[R_co, _T_cc]: ...
 
     if sys.version_info < (3, 13):
 
@@ -573,7 +575,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_cc) -> None:
         if self.__name__ in (cache := instance.__dict__.setdefault(self.cache_key, {})):
             del cache[self.__name__]
 
@@ -605,6 +607,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-1.7.2 → jetpytools-1.7.3}/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()