v440 2.0.0.dev43__tar.gz → 2.0.0.dev44__tar.gz

{v440-2.0.0.dev43/src/v440.egg-info → v440-2.0.0.dev44}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: v440
-Version: 2.0.0.dev43
+Version: 2.0.0.dev44
 Summary: This project provides mutable version objects in accordance with PEP440.
 Author-email: Johannes <johannes.programming@gmail.com>
 License: The MIT License (MIT)
@@ -47,6 +47,7 @@ Requires-Dist: keyalias<2.0,>=1.0.3
 Requires-Dist: overloadable<2.0,>=1.0.5
 Requires-Dist: packaging>=23.2
 Requires-Dist: scaevola<2.0,>=1.1
+Requires-Dist: setdoc<2,>=1.2
 Requires-Dist: tofunc<2,>=1.0.0
 Dynamic: license-file
 

{v440-2.0.0.dev43 → v440-2.0.0.dev44}/pyproject.toml

@@ -27,6 +27,7 @@ dependencies = [
     "overloadable>=1.0.5,<2.0",
     "packaging>=23.2",
     "scaevola>=1.1,<2.0",
+    "setdoc>=1.2,<2",
     "tofunc>=1.0.0,<2",
 ]
 description = "This project provides mutable version objects in accordance with PEP440."
@@ -34,7 +35,7 @@ keywords = []
 name = "v440"
 readme = "README.rst"
 requires-python = ">=3.11"
-version = "2.0.0.dev43"
+version = "2.0.0.dev44"
 
 [project.license]
 file = "LICENSE.txt"

{v440-2.0.0.dev43 → v440-2.0.0.dev44}/src/v440/_utils/SlotList.py

@@ -4,6 +4,7 @@ from abc import abstractmethod
 from typing import *
 
 import scaevola
+import setdoc
 from datarepr import datarepr
 from unhash import unhash
 
@@ -19,11 +20,12 @@ class SlotList(collections.abc.Collection, BaseList):
 
     data: list
 
+    @setdoc.basic
     def __contains__(self: Self, other: Any) -> bool:
         return other in self.data
 
+    @setdoc.basic
     def __eq__(self: Self, other: Any) -> bool:
-        "This magic method implements self==other."
         try:
             alt: Self = type(self)(other)
         except VersionError:
@@ -31,15 +33,16 @@ class SlotList(collections.abc.Collection, BaseList):
         else:
             return self.data == alt.data
 
+    @setdoc.basic
     def __format__(self: Self, format_spec: Any = "", /) -> str:
-        "This magic method implements format(self, format_spec)."
         return format(str(self), str(format_spec))
 
+    @setdoc.basic
     def __getitem__(self: Self, key: Any) -> Any:
         return self.data[key]
 
+    @setdoc.basic
     def __ge__(self: Self, other: Any, /) -> bool:
-        "This magic method implements self<=other."
         alt: Self
         try:
             alt = type(self)(other)
@@ -48,8 +51,8 @@ class SlotList(collections.abc.Collection, BaseList):
         else:
             return self._cmp() >= alt._cmp()
 
+    @setdoc.basic
     def __gt__(self: Self, other: Any, /) -> bool:
-        "This magic method implements self<=other."
         alt: Self
         try:
             alt = type(self)(other)
@@ -60,14 +63,16 @@ class SlotList(collections.abc.Collection, BaseList):
 
     __hash__ = unhash
 
+    @setdoc.basic
     def __init__(self: Self, data: Any = None) -> None:
         self.data = data
 
+    @setdoc.basic
     def __iter__(self: Self) -> Any:
         return iter(self.data)
 
+    @setdoc.basic
     def __le__(self: Self, other: Any, /) -> bool:
-        "This magic method implements self<=other."
         alt: Self
         try:
             alt = type(self)(other)
@@ -76,11 +81,12 @@ class SlotList(collections.abc.Collection, BaseList):
         else:
             return self._cmp() <= alt._cmp()
 
+    @setdoc.basic
     def __len__(self: Self) -> int:
         return len(type(self).__slots__)
 
+    @setdoc.basic
     def __lt__(self: Self, other: Any, /) -> bool:
-        "This magic method implements self<=other."
         alt: Self
         try:
             alt = type(self)(other)
@@ -89,20 +95,25 @@ class SlotList(collections.abc.Collection, BaseList):
         else:
             return self._cmp() < alt._cmp()
 
+    @setdoc.basic
     def __ne__(self: Self, other: Any) -> bool:
         return not (self == other)
 
+    @setdoc.basic
     def __repr__(self: Self) -> str:
         return datarepr(type(self).__name__, self.data)
 
+    @setdoc.basic
     def __reversed__(self: Self) -> Iterable:
         return reversed(self.data)
 
+    @setdoc.basic
     def __setitem__(self: Self, key: Any, value: Any) -> None:
         data: list = self.data
         data[key] = value
         self.data = data
 
+    @setdoc.basic
     def __str__(self: Self) -> str:
         return NotImplemented
 

{v440-2.0.0.dev43 → v440-2.0.0.dev44}/src/v440/_utils/VList.py

@@ -1,5 +1,6 @@
 from typing import *
 
+import setdoc
 from datahold import OkayList
 
 from v440._utils.BaseList import BaseList
@@ -8,8 +9,8 @@ from v440.core.VersionError import VersionError
 
 class VList(OkayList, BaseList):
 
+    @setdoc.basic
     def __eq__(self: Self, other: Any) -> bool:
-        "This magic method implements self==other."
         ans: bool
         try:
             alt: Self = type(self)(other)
@@ -19,8 +20,8 @@ class VList(OkayList, BaseList):
             ans = self._data == alt._data
         return ans
 
+    @setdoc.basic
     def __ge__(self: Self, other: Any, /) -> bool:
-        "This magic method implements self>=other."
         ans: bool
         try:
             alt: Self = type(self)(other)
@@ -30,18 +31,18 @@ class VList(OkayList, BaseList):
             ans = alt <= self
         return ans
 
+    @setdoc.basic
     def __iadd__(self: Self, other: Any, /) -> Self:
-        "This magic method implements self+=other."
         self.data += type(self)(other).data
         return self
 
+    @setdoc.basic
     def __imul__(self: Self, other: Any, /) -> Self:
-        "This magic method implements self*=other."
         self.data = self.data * other
         return self
 
+    @setdoc.basic
     def __le__(self: Self, other: Any, /) -> bool:
-        "This magic method implements self<=other."
         ans: bool
         try:
             alt: Self = type(self)(other)

{v440-2.0.0.dev43 → v440-2.0.0.dev44}/src/v440/core/Base.py

@@ -2,6 +2,8 @@ from __future__ import annotations
 
 from typing import *
 
+import setdoc
+
 from v440._utils.Digest import Digest
 from v440._utils.SlotList import SlotList
 from v440._utils.utils import guard
@@ -72,15 +74,18 @@ class Base(SlotList):
     epoch: int
     release: Release
 
+    @setdoc.basic
     def __init__(self: Self, data: Any = None) -> None:
         self._epoch = 0
         self._release = Release()
         self.data = data
 
+    @setdoc.basic
     def __str__(self: Self) -> str:
         return self.format()
 
     @property
+    @setdoc.basic
     def data(self: Self) -> list:
         return [self.epoch, self.release]
 

{v440-2.0.0.dev43 → v440-2.0.0.dev44}/src/v440/core/Local.py

@@ -3,6 +3,8 @@ from __future__ import annotations
 import functools
 from typing import *
 
+import setdoc
+
 from v440._utils import utils
 from v440._utils.Digest import Digest
 from v440._utils.utils import guard
@@ -15,13 +17,13 @@ class Local(VList):
 
     data: list[int | str]
 
+    @setdoc.basic
     def __init__(self: Any, data: Any = None) -> None:
-        "This magic method initializes self."
         self._data = list()
         self.data = data
 
+    @setdoc.basic
     def __le__(self: Self, other: Iterable) -> bool:
-        "This magic method implements self<=other."
         ans: bool
         try:
             alt: Self = type(self)(other)
@@ -31,8 +33,8 @@ class Local(VList):
             ans = self._cmp() <= alt._cmp()
         return ans
 
+    @setdoc.basic
     def __str__(self: Self) -> str:
-        "This magic method implements str(self)."
         return ".".join(map(str, self))
 
     def _cmp(self: Self) -> list:
@@ -73,6 +75,7 @@ class Local(VList):
         return type(value) is int, value
 
     @property
+    @setdoc.basic
     def data(self: Self) -> list[int | str]:
         return list(self._data)
 

{v440-2.0.0.dev43 → v440-2.0.0.dev44}/src/v440/core/Public.py

@@ -2,6 +2,8 @@ from __future__ import annotations
 
 from typing import *
 
+import setdoc
+
 from v440._utils.Digest import Digest
 from v440._utils.Pattern import Pattern
 from v440._utils.SlotList import SlotList
@@ -44,6 +46,7 @@ class Public(SlotList):
     base: Base
     qual: Qual
 
+    @setdoc.basic
     def __init__(self: Self, data: Any = None) -> None:
         self._base = Base()
         self._qual = Qual()
@@ -62,6 +65,7 @@ class Public(SlotList):
         self.base.data = value
 
     @property
+    @setdoc.basic
     def data(self: Self) -> list:
         return [self.base, self.qual]
 

{v440-2.0.0.dev43 → v440-2.0.0.dev44}/src/v440/core/Qual.py

@@ -2,6 +2,8 @@ from __future__ import annotations
 
 from typing import *
 
+import setdoc
+
 from v440._utils import qualparse
 from v440._utils.SlotList import SlotList
 from v440._utils.utils import guard
@@ -19,6 +21,7 @@ class Qual(SlotList):
     post: Optional[int]
     dev: Optional[int]
 
+    @setdoc.basic
     def __init__(self: Self, data: Any = None) -> None:
         self._prephase = None
         self._presubphase = None
@@ -26,6 +29,7 @@ class Qual(SlotList):
         self._dev = None
         self.data = data
 
+    @setdoc.basic
     def __str__(self: Self) -> str:
         ans: str = ""
         if self.prephase is not None:
@@ -53,6 +57,7 @@ class Qual(SlotList):
         return ans
 
     @property
+    @setdoc.basic
     def data(self: Self) -> list:
         return [self.prephase, self.presubphase, self.post, self.dev]
 

{v440-2.0.0.dev43 → v440-2.0.0.dev44}/src/v440/core/Release.py

@@ -4,6 +4,7 @@ import operator
 import string
 from typing import *
 
+import setdoc
 from keyalias import keyalias
 from overloadable import Overloadable
 
@@ -22,6 +23,7 @@ class Release(VList):
     micro: int
     patch: int
 
+    @setdoc.basic
     def __add__(self: Self, other: Any, /) -> Self:
         opp: Self = type(self)(other)
         ans: Self = self.copy()
@@ -29,16 +31,19 @@ class Release(VList):
         return ans
 
     @Overloadable
+    @setdoc.basic
     def __delitem__(self: Self, key: Any) -> bool:
         return type(key) is slice
 
     @__delitem__.overload(False)
+    @setdoc.basic
     def __delitem__(self: Self, key: SupportsIndex) -> None:
         i: int = operator.index(key)
         if i < len(self):
             del self._data[i]
 
     @__delitem__.overload(True)
+    @setdoc.basic
     def __delitem__(self: Self, key: Any) -> None:
         r: range = utils.torange(key, len(self))
         l: list = [k for k in r if k < len(self)]
@@ -47,41 +52,48 @@ class Release(VList):
             del self._data[k]
 
     @Overloadable
+    @setdoc.basic
     def __getitem__(self: Self, key: Any) -> bool:
         return type(key) is slice
 
     @__getitem__.overload(False)
+    @setdoc.basic
     def __getitem__(self: Self, key: Any) -> int:
         i: int = operator.index(key)
         ans: int = self._getitem_int(i)
         return ans
 
     @__getitem__.overload(True)
+    @setdoc.basic
     def __getitem__(self: Self, key: Any) -> list:
         r: range = utils.torange(key, len(self))
         m: map = map(self._getitem_int, r)
         ans: list = list(m)
         return ans
 
+    @setdoc.basic
     def __init__(self: Any, data: Any = None) -> None:
-        "This magic method initializes self."
         self._data = list()
         self.data = data
 
     @Overloadable
+    @setdoc.basic
     def __setitem__(self: Self, key: Any, value: Any) -> bool:
         return type(key) is slice
 
     @__setitem__.overload(False)
+    @setdoc.basic
     def __setitem__(self: Self, key: SupportsIndex, value: Any) -> Any:
         i: int = operator.index(key)
         self._setitem_int(i, value)
 
     @__setitem__.overload(True)
+    @setdoc.basic
     def __setitem__(self: Self, key: SupportsIndex, value: Any) -> Any:
         k: range = utils.torange(key, len(self))
         self._setitem_range(k, value)
 
+    @setdoc.basic
     def __str__(self: Self) -> str:
         return self.format()
 
@@ -190,6 +202,7 @@ class Release(VList):
             self.data = self.data[: i + 1]
 
     @property
+    @setdoc.basic
     def data(self: Self) -> list:
         return list(self._data)
 

{v440-2.0.0.dev43 → v440-2.0.0.dev44}/src/v440/core/Version.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 from typing import *
 
 import packaging.version
+import setdoc
 
 from v440._utils.Digest import Digest
 from v440._utils.SlotList import SlotList
@@ -45,15 +46,18 @@ class Version(SlotList):
     local: Local
     public: Public
 
-    def __init__(self: Self, data: Any = "0") -> None:
+    @setdoc.basic
+    def __init__(self: Self, data: Any = None) -> None:
         self._public = Public()
         self._local = Local()
         self.data = data
 
+    @setdoc.basic
     def __str__(self: Self) -> str:
         return self.format()
 
     @property
+    @setdoc.basic
     def data(self: Self) -> list:
         return [self.public, self.local]
 
@@ -78,6 +82,7 @@ class Version(SlotList):
         self.local.data = value
 
     def packaging(self: Self) -> packaging.version.Version:
+        "This method returns an eqivalent packaging.version.Version object."
         return packaging.version.Version(str(self))
 
     @property

{v440-2.0.0.dev43 → v440-2.0.0.dev44/src/v440.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: v440
-Version: 2.0.0.dev43
+Version: 2.0.0.dev44
 Summary: This project provides mutable version objects in accordance with PEP440.
 Author-email: Johannes <johannes.programming@gmail.com>
 License: The MIT License (MIT)
@@ -47,6 +47,7 @@ Requires-Dist: keyalias<2.0,>=1.0.3
 Requires-Dist: overloadable<2.0,>=1.0.5
 Requires-Dist: packaging>=23.2
 Requires-Dist: scaevola<2.0,>=1.1
+Requires-Dist: setdoc<2,>=1.2
 Requires-Dist: tofunc<2,>=1.0.0
 Dynamic: license-file
 

{v440-2.0.0.dev43 → v440-2.0.0.dev44}/src/v440.egg-info/requires.txt

@@ -5,4 +5,5 @@ keyalias<2.0,>=1.0.3
 overloadable<2.0,>=1.0.5
 packaging>=23.2
 scaevola<2.0,>=1.1
+setdoc<2,>=1.2
 tofunc<2,>=1.0.0