datahold 4.0.0.dev23__tar.gz → 4.0.0.dev25__tar.gz

{datahold-4.0.0.dev23 → datahold-4.0.0.dev25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datahold
-Version: 4.0.0.dev23
+Version: 4.0.0.dev25
 Summary: This project wraps common mutable datastructures for inheritance with modification.
 Author-email: Johannes <johannes.programming@gmail.com>
 License-Expression: MIT

{datahold-4.0.0.dev23 → datahold-4.0.0.dev25}/pyproject.toml

@@ -31,7 +31,7 @@ license-files = [
 name = "datahold"
 readme = "README.rst"
 requires-python = ">=3.11"
-version = "4.0.0.dev23"
+version = "4.0.0.dev25"
 
 [project.urls]
 Download = "https://pypi.org/project/datahold/#files"

{datahold-4.0.0.dev23 → datahold-4.0.0.dev25}/src/datahold/__init__.py

@@ -47,7 +47,7 @@ from typing import (
 import setdoc
 from frozendict import frozendict
 
-### UTILS ###
+### PROTOCOLS ###
 
 
 class ContextManager[Enter](Protocol):
@@ -75,6 +75,99 @@ class SupportsKeysAndGetitem[Key, Value](Protocol):
     def keys(self: Self, /) -> abc.Iterable[Key]: ...
 
 
+class Collection_Frozen[Item](
+    abc.Sized,
+    abc.Iterable[Item],
+    Protocol,
+):
+    @setdoc.basic
+    def __contains__(self: Self, other: Never, /) -> bool: ...
+
+
+class MutableSet_Mutable[Item: abc.Hashable](Protocol):
+    @setdoc.basic
+    def add(self: Self, item: Item, /) -> object: ...
+    @setdoc.basic
+    def discard(self: Self, item: abc.Hashable, /) -> object: ...
+
+
+class Mapping_Frozen[Key, Value](Collection_Frozen[Key], Protocol):
+    @setdoc.basic
+    def __getitem__(self: Self, key: abc.Hashable, /) -> Value: ...
+class MutableMapping_Mutable[Key_, Value_](
+    Protocol,
+):
+    @setdoc.basic
+    def __delitem__(self: Self, key: Key_ | str, /) -> object: ...
+    @setdoc.basic
+    def __setitem__(
+        self: Self, key: Key_ | str, value: Optional[Value_], /
+    ) -> object: ...
+class Sequence_Frozen[Item](
+    Collection_Frozen[Item],
+    Protocol,
+):
+    @overload
+    @setdoc.basic
+    def __getitem__(self: Self, key: int, /) -> Item: ...
+    @overload
+    @setdoc.basic
+    def __getitem__(self: Self, key: Slice[int], /) -> abc.Sequence[Item]: ...
+    @setdoc.basic
+    def __getitem__(
+        self: Self,
+        key: int | Slice[int],
+        /,
+    ) -> Item | abc.Sequence[Item]: ...
+
+
+class MutableSequence_Mutable[Item](Protocol):
+    @overload
+    @setdoc.basic
+    def __delitem__(self: Self, key: SupportsIndex, /) -> None: ...
+    @overload
+    @setdoc.basic
+    def __delitem__(self: Self, key: Slice[SupportsIndex], /) -> None: ...
+    @setdoc.basic
+    def __delitem__(
+        self: Self, key: SupportsIndex | Slice[SupportsIndex], /
+    ) -> None: ...
+    @overload
+    @setdoc.basic
+    def __getitem__(self: Self, key: int, /) -> Item: ...
+    @overload
+    @setdoc.basic
+    def __getitem__(
+        self: Self, key: Slice[int], /
+    ) -> abc.MutableSequence[Item]: ...
+    @setdoc.basic
+    def __getitem__(
+        self: Self,
+        key: int | Slice[int],
+        /,
+    ) -> Item | abc.MutableSequence[Item]: ...
+    @overload
+    @setdoc.basic
+    def __setitem__(self: Self, key: int, value: Item, /) -> None: ...
+    @overload
+    @setdoc.basic
+    def __setitem__(
+        self: Self, key: Slice[int], value: abc.Iterable[Item], /
+    ) -> None: ...
+    @setdoc.basic
+    def __setitem__(
+        self: Self,
+        key: int | Slice[int],
+        value: Item | abc.Iterable[Item],
+        /,
+    ) -> None: ...
+    @setdoc.basic
+    def insert(self: Self, index: int, item: Item, /) -> None: ...
+
+
+### TYPE ALIASES ###
+
+
 type DictInit[Key, Value] = (
     SupportsKeysAndGetitem[Key | str, Optional[Value]]
     | abc.Iterable[tuple[Key | str, Optional[Value]]]
@@ -93,14 +186,7 @@ class Collection[Item](
 ):
     """Provide abc for custom collection."""
 
-    @setdoc.basic
-    class __Frozen__[Item_](
-        abc.Sized,
-        abc.Iterable[Item_],
-        Protocol,
-    ):
-        @setdoc.basic
-        def __contains__(self: Self, other: Never, /) -> bool: ...
+    type __Frozen__[Item_] = Collection_Frozen[Item_]
 
     @setdoc.basic
     def __contains__(self: Self, other: object, /) -> bool:
@@ -111,10 +197,10 @@ class Collection[Item](
 
     @abstractmethod
     @setdoc.basic
-    def __frozen__(self: Self, /) -> __Frozen__[Item]: ...
+    def __frozen__(self: Self, /) -> Collection_Frozen[Item]: ...
 
     @setdoc.basic
-    def __iter__(self: Self) -> abc.Iterator[Item]:
+    def __iter__(self: Self, /) -> abc.Iterator[Item]:
         return iter(self.__frozen__())
 
     @setdoc.basic
@@ -135,16 +221,11 @@ class MutableSet[Item: abc.Hashable](Set[Item], abc.MutableSet[Item]):
     """Provide abc for custom mutable set."""
 
     __slots__ = ()
+    type __Mutable__[Item_] = MutableSet_Mutable[Item_]
 
-    @setdoc.basic
-    class __Mutable__[Item_: abc.Hashable](Protocol):
-        @setdoc.basic
-        def add(self: Self, item: Item_, /) -> object: ...
-        @setdoc.basic
-        def discard(self: Self, item: abc.Hashable, /) -> object: ...
     @abstractmethod
     @setdoc.basic
-    def __mutate__(self: Self) -> ContextManager[__Mutable__[Item]]: ...
+    def __mutate__(self: Self) -> ContextManager[MutableSet_Mutable[Item]]: ...
     @setdoc.basic
     def add(self: Self, item: Item, /) -> None:
         with self.__mutate__() as mutable:
@@ -204,7 +285,7 @@ class FrozenSetLike[Item: abc.Hashable](SetLike[Item], abc.Hashable):
     __slots__ = ()
 
     @setdoc.basic
-    def __hash__(self: Self) -> int:
+    def __hash__(self: Self, /) -> int:
         return hash(self.__frozen__())
 
 
@@ -265,7 +346,7 @@ class SetSlot[Item: abc.Hashable](SetLike[Item]):
     _slot: SetSlot.__Frozen__[Item]
 
     @setdoc.basic
-    def __frozen__(self: Self) -> SetSlot.__Frozen__[Item]:
+    def __frozen__(self: Self, /) -> SetSlot.__Frozen__[Item]:
         return self._slot
 
 
@@ -307,12 +388,8 @@ class Mapping[Key: abc.Hashable, Value](
 
     __slots__ = ()
 
-    @setdoc.basic
-    class __Frozen__[FrozenKey, FrozenValue](
-        Collection.__Frozen__[FrozenKey], Protocol
-    ):
-        @setdoc.basic
-        def __getitem__(self: Self, key: abc.Hashable, /) -> FrozenValue: ...
+    type __Frozen__[Key_, Value_] = Mapping_Frozen[Key_, Value_]
+
     @abstractmethod
     @setdoc.basic
     def __frozen__(self: Self, /) -> __Frozen__[Key, Value]: ...
@@ -329,16 +406,7 @@ class MutableMapping[Key: abc.Hashable, Value](
 
     __slots__ = ()
 
-    @setdoc.basic
-    class __Mutable__[Key_, Value_](
-        Protocol,
-    ):
-        @setdoc.basic
-        def __delitem__(self: Self, key: Key_ | str, /) -> object: ...
-        @setdoc.basic
-        def __setitem__(
-            self: Self, key: Key_ | str, value: Optional[Value_], /
-        ) -> object: ...
+    type __Mutable__[Key_, Value_] = MutableMapping_Mutable[Key_, Value_]
 
     @setdoc.basic
     def __delitem__(self: Self, key: Key | str, /) -> None:
@@ -352,7 +420,8 @@ class MutableMapping[Key: abc.Hashable, Value](
     def __setitem__(
         self: Self, key: Key | str, value: Optional[Value], /
     ) -> None:
-        self[key] = value
+        with self.__mutate__() as mutable:
+            mutable[key] = value
 
 
 ### DICT-LIKE ###
@@ -399,7 +468,7 @@ class DictLike[Key: abc.Hashable, Value](
     def fromkeys(
         cls: type[Self],
         iterable: abc.Iterable[Key | str],
-        value: Optional[Value],
+        value: Optional[Value] = None,
         /,
     ) -> Self:
         return cls(dict.fromkeys(iterable, value))
@@ -527,26 +596,8 @@ class Sequence[Item](Collection[Item], abc.Sequence[Item]):
     """Provide abc for customized sequence."""
 
     __slots__ = ()
+    type __Frozen__[Item_] = Sequence_Frozen[Item_]
 
-    @setdoc.basic
-    class __Frozen__[Item_](
-        Collection.__Frozen__[Item_],
-        Protocol,
-    ):
-        @overload
-        @setdoc.basic
-        def __getitem__(self: Self, key: int, /) -> Item_: ...
-        @overload
-        @setdoc.basic
-        def __getitem__(
-            self: Self, key: Slice[int], /
-        ) -> abc.Sequence[Item_]: ...
-        @setdoc.basic
-        def __getitem__(
-            self: Self,
-            key: int | Slice[int],
-            /,
-        ) -> Item_ | abc.Sequence[Item_]: ...
     @abstractmethod
     @setdoc.basic
     def __frozen__(self: Self, /) -> __Frozen__[Item]: ...
@@ -567,50 +618,7 @@ class MutableSequence[Item](Sequence[Item], abc.MutableSequence[Item]):
     """Provide abc for custom mutable sequence."""
 
     __slots__ = ()
-
-    @setdoc.basic
-    class __Mutable__[Item_](Protocol):
-        @overload
-        @setdoc.basic
-        def __delitem__(self: Self, key: SupportsIndex, /) -> None: ...
-        @overload
-        @setdoc.basic
-        def __delitem__(self: Self, key: Slice[SupportsIndex], /) -> None: ...
-        @setdoc.basic
-        def __delitem__(
-            self: Self, key: SupportsIndex | Slice[SupportsIndex], /
-        ) -> None: ...
-        @overload
-        @setdoc.basic
-        def __getitem__(self: Self, key: int, /) -> Item_: ...
-        @overload
-        @setdoc.basic
-        def __getitem__(
-            self: Self, key: Slice[int], /
-        ) -> abc.MutableSequence[Item_]: ...
-        @setdoc.basic
-        def __getitem__(
-            self: Self,
-            key: int | Slice[int],
-            /,
-        ) -> Item_ | abc.MutableSequence[Item_]: ...
-        @overload
-        @setdoc.basic
-        def __setitem__(self: Self, key: int, value: Item_, /) -> None: ...
-        @overload
-        @setdoc.basic
-        def __setitem__(
-            self: Self, key: Slice[int], value: abc.Iterable[Item_], /
-        ) -> None: ...
-        @setdoc.basic
-        def __setitem__(
-            self: Self,
-            key: int | Slice[int],
-            value: Item_ | abc.Iterable[Item_],
-            /,
-        ) -> None: ...
-        @setdoc.basic
-        def insert(self: Self, index: int, item: Item_, /) -> None: ...
+    type __Mutable__[Item_] = MutableSequence_Mutable[Item_]
 
     @overload
     @setdoc.basic

{datahold-4.0.0.dev23 → datahold-4.0.0.dev25}/src/datahold.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datahold
-Version: 4.0.0.dev23
+Version: 4.0.0.dev25
 Summary: This project wraps common mutable datastructures for inheritance with modification.
 Author-email: Johannes <johannes.programming@gmail.com>
 License-Expression: MIT