jetpytools 1.2.6__tar.gz → 1.2.8__tar.gz

{jetpytools-1.2.6 → jetpytools-1.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: jetpytools
-Version: 1.2.6
+Version: 1.2.8
 Summary: Collection of stuff that's useful in general python programming
 Author: Jaded Encoding Thaumaturgy
 Author-email: jaded.encoding.thaumaturgy@gmail.com
@@ -23,6 +23,7 @@ Dynamic: author-email
 Dynamic: classifier
 Dynamic: description
 Dynamic: description-content-type
+Dynamic: license-file
 Dynamic: maintainer
 Dynamic: maintainer-email
 Dynamic: project-url

{jetpytools-1.2.6 → jetpytools-1.2.8}/jetpytools/_metadata.py

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

{jetpytools-1.2.6 → jetpytools-1.2.8}/jetpytools/enums/base.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from enum import Enum
-from typing import Any
+from typing import Any, TypeVar
 
 from typing_extensions import Self
 
@@ -9,6 +9,7 @@ from ..exceptions import CustomValueError, NotFoundEnumValue
 from ..types import FuncExceptT
 
 __all__ = [
+    'SelfEnum',
     'CustomEnum', 'CustomIntEnum', 'CustomStrEnum'
 ]
 
@@ -74,3 +75,6 @@ class CustomStrEnum(str, CustomEnum):
     """Base class for custom str enums."""
 
     value: str
+
+
+SelfEnum = TypeVar('SelfEnum', bound=CustomEnum)

{jetpytools-1.2.6 → jetpytools-1.2.8}/jetpytools/exceptions/generic.py

@@ -28,7 +28,7 @@ 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: FuncExceptT, /, *items: Any, **kwargs: Any) -> None:
         if len(cls._reduce(items)) != 1:
             raise cls(func, items, **kwargs)
 
@@ -40,6 +40,6 @@ class MismatchRefError(MismatchError):
         super().__init__(func, [base, ref], message, **kwargs)
 
     @classmethod
-    def check(cls, func: FuncExceptT, *items: Any, **kwargs: Any) -> None:
+    def check(cls, func: FuncExceptT, /, *items: Any, **kwargs: Any) -> None:
         if len(cls._reduce(items)) != 1:
             raise cls(func, *items, **kwargs)

{jetpytools-1.2.6 → jetpytools-1.2.8}/jetpytools/types/builtins.py

@@ -8,7 +8,7 @@ __all__ = [
     'F', 'F0', 'F1', 'F2',
 
     'P', 'P0', 'P1', 'P2',
-    'R', 'R0', 'R1', 'R2', 'R_contra',
+    'R', 'R0', 'R1', 'R2', 'R_co', 'R0_co', 'R_contra',
 
     'Nb',
 
@@ -20,9 +20,13 @@ __all__ = [
     'SimpleByteData', 'SimpleByteDataArray',
     'ByteData',
 
-    'KwargsT'
+    'KwargsT',
+
+    'Self'
 ]
 
+Self = TypeVar('Self')
+
 Nb = TypeVar('Nb', float, int)
 
 T = TypeVar('T')
@@ -45,6 +49,9 @@ R0 = TypeVar('R0')
 R1 = TypeVar('R1')
 R2 = TypeVar('R2')
 
+R_co = TypeVar('R_co', covariant=True)
+R0_co = TypeVar('R0_co', covariant=True)
+
 T_contra = TypeVar('T_contra', contravariant=True)
 R_contra = TypeVar('R_contra', contravariant=True)
 

{jetpytools-1.2.6 → jetpytools-1.2.8}/jetpytools/types/utils.py

@@ -8,8 +8,9 @@ from typing import (
     TYPE_CHECKING, Any, Callable, Concatenate, Generator, Generic, Iterable, Iterator, Mapping,
     NoReturn, Protocol, Sequence, TypeVar, cast, overload
 )
+from typing_extensions import Self
 
-from .builtins import F0, F1, P0, P1, R0, R1, T0, T1, T2, KwargsT, P, R, T
+from .builtins import F0, F1, P0, P1, R0, R1, T0, T1, T2, KwargsT, P, R, R_co, R0_co, T
 
 __all__ = [
     'copy_signature',
@@ -508,7 +509,7 @@ class classproperty(Generic[P, R, T, T0, P0]):
         return self.fget.__name__
 
 
-class cachedproperty(property, Generic[P, R, T, T0, P0]):
+class cachedproperty(property, Generic[P, R_co, T, T0, P0]):
     """
     Wrapper for a one-time get property, that will be cached.
 
@@ -537,21 +538,29 @@ class cachedproperty(property, Generic[P, R, T, T0, P0]):
 
     if TYPE_CHECKING:
         def __init__(
-            self, fget: Callable[P, R], fset: Callable[[T, T0], None] | None = None,
+            self, fget: Callable[P, R_co], fset: Callable[[T, T0], None] | None = None,
             fdel: Callable[P0, None] | None = None, doc: str | None = None,
         ) -> None:
             ...
 
-        def getter(self, __fget: Callable[P1, R1]) -> cachedproperty[P1, R1, T, T0, P0]:
+        def getter(self, __fget: Callable[P1, R0_co]) -> cachedproperty[P1, R0_co, T, T0, P0]:
             ...
 
-        def setter(self, __fset: Callable[[T1, T2], None]) -> cachedproperty[P, R, T1, T2, P0]:
+        def setter(self, __fset: Callable[[T1, T2], None]) -> cachedproperty[P, R_co, T1, T2, P0]:
             ...
 
-        def deleter(self, __fdel: Callable[P1, None]) -> cachedproperty[P, R, T, T0, P1]:
+        def deleter(self, __fdel: Callable[P1, None]) -> cachedproperty[P, R_co, T, T0, P1]:
             ...
 
-    def __get__(self, __obj: Any, __type: type | None = None) -> R:
+    @overload
+    def __get__(self, __obj: None, __type: type | None = None) -> Self:
+        ...
+
+    @overload
+    def __get__(self, __obj: object, __type: 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
@@ -562,14 +571,19 @@ class cachedproperty(property, Generic[P, R, T, T0, P0]):
             cache = getattr(__obj, cachedproperty.cache_key)
             name = self.fget.__name__
         else:
-            function = self.fget.__get__(__obj, __type)  # type: ignore
+            assert self.fget
+            function = self.fget.__get__(__obj, __type)
             cache = __obj.__dict__.get(cachedproperty.cache_key)
             name = function.__name__
 
         if name not in cache:
             cache[name] = function()
 
-        return cache[name]  # type: ignore
+        return cache[name]
+
+    if TYPE_CHECKING:
+        def __set__(self, obj: Any, value: R_co, /) -> None:  # type: ignore[misc]
+            ...
 
 
 class KwargsNotNone(KwargsT):

{jetpytools-1.2.6 → jetpytools-1.2.8}/jetpytools.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: jetpytools
-Version: 1.2.6
+Version: 1.2.8
 Summary: Collection of stuff that's useful in general python programming
 Author: Jaded Encoding Thaumaturgy
 Author-email: jaded.encoding.thaumaturgy@gmail.com
@@ -23,6 +23,7 @@ Dynamic: author-email
 Dynamic: classifier
 Dynamic: description
 Dynamic: description-content-type
+Dynamic: license-file
 Dynamic: maintainer
 Dynamic: maintainer-email
 Dynamic: project-url