jetpytools 1.7.1__py3-none-any.whl → 1.7.3__py3-none-any.whl

jetpytools/_metadata.py

@@ -1,6 +1,6 @@
 """Collection of stuff that's useful in general python programming"""
 
-__version__ = "1.7.1"
+__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/enums/base.py

@@ -6,7 +6,7 @@ from typing import Any
 from typing_extensions import Self
 
 from ..exceptions import CustomValueError, NotFoundEnumValue
-from ..types import FuncExceptT
+from ..types import FuncExcept
 
 __all__ = ["CustomEnum", "CustomIntEnum", "CustomStrEnum"]
 
@@ -19,7 +19,7 @@ class CustomEnum(Enum):
         return cls.from_param(value)
 
     @classmethod
-    def from_param(cls, value: Any, func_except: FuncExceptT | None = None) -> Self | None:
+    def from_param(cls, value: Any, func_except: FuncExcept | None = None) -> Self | None:
         """
         Return the enum value from a parameter.
 

jetpytools/exceptions/base.py

@@ -8,7 +8,7 @@ from typing import TYPE_CHECKING, Any, Generic, TypeVar
 
 from typing_extensions import Self
 
-from ..types import MISSING, FuncExceptT, MissingT, SupportsString
+from ..types import MISSING, FuncExcept, MissingT, SupportsString
 
 __all__ = [
     "CustomError",
@@ -80,7 +80,7 @@ class CustomError(ExceptionError, metaclass=CustomErrorMeta):
     """Custom base exception class."""
 
     def __init__(
-        self, message: SupportsString | None = None, func: FuncExceptT | None = None, reason: Any = None, **kwargs: Any
+        self, message: SupportsString | None = None, func: FuncExcept | None = None, reason: Any = None, **kwargs: Any
     ) -> None:
         """
         Instantiate a new exception with pretty printing and more.
@@ -107,8 +107,8 @@ class CustomError(ExceptionError, metaclass=CustomErrorMeta):
     def __call__(
         self,
         message: SupportsString | None | MissingT = MISSING,
-        func: FuncExceptT | None | MissingT = MISSING,
-        reason: SupportsString | FuncExceptT | None | MissingT = MISSING,
+        func: FuncExcept | None | MissingT = MISSING,
+        reason: SupportsString | FuncExcept | None | MissingT = MISSING,
         **kwargs: Any,
     ) -> Self:
         """

jetpytools/exceptions/generic.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from typing import Any, Iterable
 
-from ..types import FuncExceptT, SupportsString, T
+from ..types import FuncExcept, SupportsString, T
 from .base import CustomValueError
 
 __all__ = ["MismatchError", "MismatchRefError"]
@@ -21,7 +21,7 @@ class MismatchError(CustomValueError):
 
     def __init__(
         self,
-        func: FuncExceptT,
+        func: FuncExcept,
         items: Iterable[Any],
         message: SupportsString = "All items must be equal!",
         reason: Any = "{reduced_items}",
@@ -30,18 +30,18 @@ class MismatchError(CustomValueError):
         super().__init__(message, func, reason, **kwargs, reduced_items=iter(self._reduce(items)))
 
     @classmethod
-    def check(cls, func: FuncExceptT, /, *items: Any, **kwargs: Any) -> None:
+    def check(cls, func: FuncExcept, /, *items: Any, **kwargs: Any) -> None:
         if len(cls._reduce(items)) != 1:
             raise cls(func, items, **kwargs)
 
 
 class MismatchRefError(MismatchError):
     def __init__(
-        self, func: FuncExceptT, base: T, ref: T, message: SupportsString = "All items must be equal!", **kwargs: Any
+        self, func: FuncExcept, base: T, ref: T, message: SupportsString = "All items must be equal!", **kwargs: Any
     ) -> None:
         super().__init__(func, [base, ref], message, **kwargs)
 
     @classmethod
-    def check(cls, func: FuncExceptT, /, *items: Any, **kwargs: Any) -> None:
+    def check(cls, func: FuncExcept, /, *items: Any, **kwargs: Any) -> None:
         if len(cls._reduce(items)) != 1:
             raise cls(func, *items, **kwargs)

jetpytools/exceptions/module.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from typing import Any
 
-from ..types import FuncExceptT, SupportsString
+from ..types import FuncExcept, SupportsString
 from .base import CustomError
 
 __all__ = ["CustomImportError", "DependencyNotFoundError"]
@@ -13,7 +13,7 @@ class CustomImportError(CustomError, ImportError):
 
     def __init__(
         self,
-        func: FuncExceptT,
+        func: FuncExcept,
         package: str | ImportError,
         message: SupportsString = "Import failed for package '{package}'!",
         **kwargs: Any,
@@ -32,7 +32,7 @@ class DependencyNotFoundError(CustomImportError):
 
     def __init__(
         self,
-        func: FuncExceptT,
+        func: FuncExcept,
         package: str | ImportError,
         message: SupportsString = "Missing dependency '{package}'!",
         **kwargs: Any,

jetpytools/types/generic.py

@@ -6,23 +6,23 @@ from typing import Any, Callable, Literal, TypeAlias, Union
 from .builtins import F, SingleOrArr, SingleOrArrOpt
 from .supports import SupportsString
 
-__all__ = ["MISSING", "DataType", "FuncExceptT", "MissingT", "PassthroughC", "StrArr", "StrArrOpt"]
+__all__ = ["MISSING", "DataType", "FuncExcept", "FuncExceptT", "MissingT", "PassthroughC", "StrArr", "StrArrOpt"]
 
 
-class MissingTBase(Enum):
-    MissingT = auto()
+class _MissingType(Enum):
+    MISSING = auto()
 
 
-MissingT: TypeAlias = Literal[MissingTBase.MissingT]
-MISSING = MissingTBase.MissingT
+MissingT: TypeAlias = Literal[_MissingType.MISSING]
+MISSING = _MissingType.MISSING
 
 DataType = Union[str, bytes, bytearray, SupportsString]
 
-FuncExceptT = str | Callable[..., Any] | tuple[Callable[..., Any] | str, str]
+FuncExcept = str | Callable[..., Any] | tuple[Callable[..., Any] | str, str]
 """
 This type is used in specific functions that can throw an exception.
 ```
-def can_throw(..., *, func: FuncExceptT) -> None:
+def can_throw(..., *, func: FuncExcept) -> None:
     ...
     if some_error:
         raise CustomValueError('Some error occurred!!', func)
@@ -35,6 +35,7 @@ If an error occurs, this will print a clear error ->\n
 ``ValueError: (some_func) Some error occurred!!``
 """
 
+FuncExceptT = FuncExcept
 
 StrArr = SingleOrArr[SupportsString]
 StrArrOpt = SingleOrArrOpt[SupportsString]

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/utils/file.py

@@ -11,7 +11,7 @@ from ..exceptions import FileIsADirectoryError, FileNotExistsError, FilePermissi
 from ..types import (
     FileOpener,
     FilePathType,
-    FuncExceptT,
+    FuncExcept,
     OpenBinaryMode,
     OpenBinaryModeReading,
     OpenBinaryModeUpdating,
@@ -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()
 
@@ -73,7 +74,7 @@ def get_user_data_dir() -> Path:
 
 
 def check_perms(
-    file: FilePathType, mode: OpenTextMode | OpenBinaryMode, strict: bool = False, *, func: FuncExceptT | None = None
+    file: FilePathType, mode: OpenTextMode | OpenBinaryMode, strict: bool = False, *, func: FuncExcept | None = None
 ) -> bool:
     """
     Confirm whether the user has write/read access to a file.
@@ -140,7 +141,7 @@ def open_file(
     errors: str | None = ...,
     newline: str | None = ...,
     *,
-    func: FuncExceptT | None = None,
+    func: FuncExcept | None = None,
 ) -> TextIOWrapper: ...
 
 
@@ -151,7 +152,7 @@ def open_file(
     buffering: Literal[0],
     encoding: None = None,
     *,
-    func: FuncExceptT | None = None,
+    func: FuncExcept | None = None,
 ) -> FileIO: ...
 
 
@@ -162,7 +163,7 @@ def open_file(
     buffering: Literal[-1, 1] = ...,
     encoding: None = None,
     *,
-    func: FuncExceptT | None = None,
+    func: FuncExcept | None = None,
 ) -> BufferedRandom: ...
 
 
@@ -173,7 +174,7 @@ def open_file(
     buffering: Literal[-1, 1] = ...,
     encoding: None = None,
     *,
-    func: FuncExceptT | None = None,
+    func: FuncExcept | None = None,
 ) -> BufferedWriter: ...
 
 
@@ -184,7 +185,7 @@ def open_file(
     buffering: Literal[-1, 1] = ...,
     encoding: None = None,
     *,
-    func: FuncExceptT | None = None,
+    func: FuncExcept | None = None,
 ) -> BufferedReader: ...
 
 
@@ -195,7 +196,7 @@ def open_file(
     buffering: int = ...,
     encoding: None = None,
     *,
-    func: FuncExceptT | None = None,
+    func: FuncExcept | None = None,
 ) -> BinaryIO: ...
 
 
@@ -210,11 +211,11 @@ def open_file(
     closefd: bool = ...,
     opener: FileOpener | None = ...,
     *,
-    func: FuncExceptT | None = None,
+    func: FuncExcept | None = None,
 ) -> IO[Any]: ...
 
 
-def open_file(file: FilePathType, mode: Any = "r+", *args: Any, func: FuncExceptT | None = None, **kwargs: Any) -> Any:
+def open_file(file: FilePathType, mode: Any = "r+", *args: Any, func: FuncExcept | None = None, **kwargs: Any) -> Any:
     """
     Open file and return a stream. Raise OSError upon failure.
 

{jetpytools-1.7.1.dist-info → jetpytools-1.7.3.dist-info}/METADATA

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

@@ -1,15 +1,15 @@
 jetpytools/__init__.py,sha256=ha_pCOMqfeIbipDRrtqKOqH3NQEpX4KwN2SskpsCGb4,114
-jetpytools/_metadata.py,sha256=lqi2SmD1Kr0aXukbAQaNUyoWqdq00iRpW-gpGQ3gJjw,414
+jetpytools/_metadata.py,sha256=Kl3NQU3X_aFmV1c2YV8ZagO9qzZGKt0xmw4wUK8bc5Q,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/base.py,sha256=s5A9iQS22JdaZMM6jEXI31m0ZjtBx7GLQ-E0xBr90Zc,2032
 jetpytools/enums/other.py,sha256=9GGRS4P-P589C1HqNpDDBhLdphID1trwCJi7pbXT0iM,1317
 jetpytools/exceptions/__init__.py,sha256=0rNEfnOuoSRUyKsutGzHFWQkgiFaK7diOT4VbRVKt9c,105
-jetpytools/exceptions/base.py,sha256=cCVT-v-mJoWzLvOxB5SG5dkeGAM_allXAuRgjfI9H6E,7649
+jetpytools/exceptions/base.py,sha256=4DNDYlH_196sZH9_B-mvs4pRxr2kcO3JSwDBmAaRT8o,7645
 jetpytools/exceptions/enum.py,sha256=euR6cyMetVWSfTgO5rkblhQyEgusdwhx6Rd9I5ZoFbA,293
 jetpytools/exceptions/file.py,sha256=7Eh4aPo4r1W-ppnf6XLwWaStOSjIxw9JfzOCa4W7m8E,1105
-jetpytools/exceptions/generic.py,sha256=5LYQHdSLM2wu5fv40PTrjkW9v0iq8R-QlQzhVsiLLpE,1509
-jetpytools/exceptions/module.py,sha256=hjkpvTPZALRvo1Q5y7D1wEAsssjyRZSZSf98gks3lKw,1231
+jetpytools/exceptions/generic.py,sha256=91U6RoiAoejFOU2qjaJsmej8FhC0XXQuZ535XTi1qGA,1504
+jetpytools/exceptions/module.py,sha256=iRKvbxa59MYDavIQIzPR-NjqjhZbBTLRvzAONMXs3Aw,1228
 jetpytools/functions/__init__.py,sha256=jCw3-aaOGxIzi6iyFInWPOxOFbzZg8IZhoSuGYaNgLA,67
 jetpytools/functions/funcs.py,sha256=lcdWaJtslhXZNfNu_y-Badgz2uy0bVaoA3D_lLo_GNI,5286
 jetpytools/functions/normalize.py,sha256=czliT8iyYPdiJG3C7wHppFrOxeVP5OOWZGdRPHFvEi8,8594
@@ -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=SFnUqDAVehKZ36HmLrs9PN4Ze0BLcabPjwC7hJsGp4w,1102
+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=7r-nlUsNLZJuIYpZrHtIRO7gLuWYf_BtiR3WR9Eoxr8,23311
 jetpytools/utils/__init__.py,sha256=_rJ-mY5PsGjBfy8Fihx_FYJfAIGSrYAYzI6Td9oFh9A,83
-jetpytools/utils/file.py,sha256=um4ow7_UEH1UxOV74w6F1u4s0wC4zh98LrcwBYjed50,10578
+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.1.dist-info/METADATA,sha256=HmlHVWQzTOvcGcFVN1BM-ljNSMWe8sXJnIzRRzOA8vg,1198
-jetpytools-1.7.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-jetpytools-1.7.1.dist-info/licenses/LICENSE,sha256=l0PN-qDtXcgOB5aXP_nSUsvCK5V3o9pQCGsTzyZhKL0,1071
-jetpytools-1.7.1.dist-info/RECORD,,
+jetpytools-1.7.3.dist-info/METADATA,sha256=7ALXyfpJwy9dumdXw0wkSpxGKDRZ6ccNwABSPmW3g1w,1198
+jetpytools-1.7.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+jetpytools-1.7.3.dist-info/licenses/LICENSE,sha256=l0PN-qDtXcgOB5aXP_nSUsvCK5V3o9pQCGsTzyZhKL0,1071
+jetpytools-1.7.3.dist-info/RECORD,,