pythonwrench 0.4.7__tar.gz → 0.4.9__tar.gz

{pythonwrench-0.4.7/src/pythonwrench.egg-info → pythonwrench-0.4.9}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: pythonwrench
-Version: 0.4.7
+Version: 0.4.9
 Summary: Python library with tools for typing, manipulating collections, and more!
 Author-email: "Étienne Labbé (Labbeti)" <labbeti.pub@gmail.com>
 Maintainer-email: "Étienne Labbé (Labbeti)" <labbeti.pub@gmail.com>
@@ -52,7 +52,6 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: typing-extensions>=4.10.0
 Provides-Extra: dev
-Dynamic: license-file
 
 # pythonwrench
 

pythonwrench-0.4.9/docs/requirements.txt

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+
+sphinx-immaterial>=0.11.14
+sphinx<9.0.0

{pythonwrench-0.4.7 → pythonwrench-0.4.9}/src/pythonwrench/__init__.py

@@ -9,7 +9,7 @@ __author_email__ = "labbeti.pub@gmail.com"
 __license__ = "MIT"
 __maintainer__ = "Étienne Labbé (Labbeti)"
 __status__ = "Development"
-__version__ = "0.4.7"
+__version__ = "0.4.9"
 
 
 # Re-import for language servers
@@ -165,6 +165,7 @@ from .typing import (
     BuiltinScalar,
     DataclassInstance,
     EllipsisType,
+    ListOrTuple,
     NamedTupleInstance,
     NoneType,
     SupportsAdd,
@@ -172,10 +173,14 @@ from .typing import (
     SupportsBool,
     SupportsDiv,
     SupportsGetitem,
+    SupportsGetitem2,
     SupportsGetitemIterLen,
+    SupportsGetitemIterLen2,
     SupportsGetitemLen,
+    SupportsGetitemLen2,
     SupportsIterLen,
     SupportsLen,
+    SupportsMatmul,
     SupportsMul,
     SupportsOr,
     T_BuiltinNumber,

{pythonwrench-0.4.7 → pythonwrench-0.4.9}/src/pythonwrench/cast.py

@@ -182,7 +182,7 @@ def as_builtin(x: Any, **kwargs) -> Any: ...
 
 
 def as_builtin(x: Any, **kwargs) -> Any:
-    """Convert an object to a sanitized python builtin equivalent.
+    """Convert an object to a sanitized python builtin equivalent recursively.
 
     This function can be used to sanitize data before saving to a JSON, YAML or CSV file.
 

{pythonwrench-0.4.7 → pythonwrench-0.4.9}/src/pythonwrench/checksum.py

@@ -6,6 +6,7 @@ import re
 import struct
 import zlib
 from dataclasses import asdict
+from enum import Enum
 from functools import lru_cache
 from pathlib import Path
 from types import FunctionType, MethodType
@@ -191,6 +192,11 @@ def checksum_dict(x: dict, **kwargs) -> int:
     return _checksum_mapping(x, **kwargs)
 
 
+@register_checksum_fn(Enum)
+def checksum_enum(x: Enum, **kwargs) -> int:
+    return _checksum_iterable((x.__class__, x.name, x.value), **kwargs)
+
+
 @register_checksum_fn((list, tuple))
 def checksum_list_tuple(x: Union[list, tuple], **kwargs) -> int:
     return _checksum_iterable(x, **kwargs)

{pythonwrench-0.4.7 → pythonwrench-0.4.9}/src/pythonwrench/disk_cache.py

@@ -12,6 +12,7 @@ from typing import (
     Any,
     Callable,
     Dict,
+    Iterable,
     Literal,
     Optional,
     Tuple,
@@ -37,6 +38,8 @@ ChecksumFn = Callable[[Tuple[Callable[P, T], Tuple, Dict[str, Any]]], int]
 SavingBackend = Literal["csv", "json", "pickle"]
 StoreMode = Literal["outputs_only", "outputs_metadata", "outputs_metadata_inputs"]
 
+_DEFAULT_CACHE_STORE_MODE: StoreMode = "outputs_metadata"
+
 
 class _CacheMeta(TypedDict):
     datetime: str
@@ -63,10 +66,29 @@ def disk_cache_decorator(
     cache_checksum_fn: ChecksumFn = checksum_any,
     cache_saving_backend: Literal["custom"],
     cache_fname_fmt: Union[str, Callable[..., str]] = "{fn_name}_{csum}{suffix}",
+    cache_fname_fmt_args: Optional[Iterable[str]] = None,
     cache_dump_fn: Callable[[Any, Path], Any],
     cache_load_fn: Callable[[Path], Any],
     cache_enable: bool = True,
-    cache_store_mode: StoreMode = "outputs_metadata",
+    cache_store_mode: StoreMode,
+) -> Callable[[Callable[P, T]], Callable[P, T]]: ...
+
+
+@overload
+def disk_cache_decorator(
+    fn: None = None,
+    *,
+    cache_dpath: Union[str, Path, None] = None,
+    cache_force: bool = False,
+    cache_verbose: int = 0,
+    cache_checksum_fn: ChecksumFn = checksum_any,
+    cache_saving_backend: SavingBackend,
+    cache_fname_fmt: Union[str, Callable[..., str]] = "{fn_name}_{csum}{suffix}",
+    cache_fname_fmt_args: Optional[Iterable[str]] = None,
+    cache_dump_fn: None = None,
+    cache_load_fn: None = None,
+    cache_enable: bool = True,
+    cache_store_mode: StoreMode = _DEFAULT_CACHE_STORE_MODE,
 ) -> Callable[[Callable[P, T]], Callable[P, T]]: ...
 
 
@@ -80,10 +102,11 @@ def disk_cache_decorator(
     cache_checksum_fn: ChecksumFn = checksum_any,
     cache_saving_backend: Union[SavingBackend, Literal["custom", "auto"]] = "auto",
     cache_fname_fmt: Union[str, Callable[..., str]] = "{fn_name}_{csum}{suffix}",
+    cache_fname_fmt_args: Optional[Iterable[str]] = None,
     cache_dump_fn: Optional[Callable[[Any, Path], Any]] = None,
     cache_load_fn: Optional[Callable[[Path], Any]] = None,
     cache_enable: bool = True,
-    cache_store_mode: StoreMode = "outputs_metadata",
+    cache_store_mode: StoreMode = _DEFAULT_CACHE_STORE_MODE,
 ) -> Callable[[Callable[P, T]], Callable[P, T]]: ...
 
 
@@ -97,10 +120,11 @@ def disk_cache_decorator(
     cache_checksum_fn: ChecksumFn = checksum_any,
     cache_saving_backend: Literal["custom"],
     cache_fname_fmt: Union[str, Callable[..., str]] = "{fn_name}_{csum}{suffix}",
+    cache_fname_fmt_args: Optional[Iterable[str]] = None,
     cache_dump_fn: Callable[[Any, Path], Any],
     cache_load_fn: Callable[[Path], Any],
     cache_enable: bool = True,
-    cache_store_mode: StoreMode = "outputs_metadata",
+    cache_store_mode: StoreMode = _DEFAULT_CACHE_STORE_MODE,
 ) -> Callable[P, T]: ...
 
 
@@ -114,10 +138,11 @@ def disk_cache_decorator(
     cache_checksum_fn: ChecksumFn = checksum_any,
     cache_saving_backend: Union[SavingBackend, Literal["custom", "auto"]] = "auto",
     cache_fname_fmt: Union[str, Callable[..., str]] = "{fn_name}_{csum}{suffix}",
+    cache_fname_fmt_args: Optional[Iterable[str]] = None,
     cache_dump_fn: Optional[Callable[[Any, Path], Any]] = None,
     cache_load_fn: Optional[Callable[[Path], Any]] = None,
     cache_enable: bool = True,
-    cache_store_mode: StoreMode = "outputs_metadata",
+    cache_store_mode: StoreMode = _DEFAULT_CACHE_STORE_MODE,
 ) -> Callable[P, T]: ...
 
 
@@ -130,10 +155,11 @@ def disk_cache_decorator(
     cache_checksum_fn: ChecksumFn = checksum_any,
     cache_saving_backend: Union[SavingBackend, Literal["custom", "auto"]] = "auto",
     cache_fname_fmt: Union[str, Callable[..., str]] = "{fn_name}_{csum}{suffix}",
+    cache_fname_fmt_args: Optional[Iterable[str]] = None,
     cache_dump_fn: Optional[Callable[[Any, Path], Any]] = None,
     cache_load_fn: Optional[Callable[[Path], Any]] = None,
     cache_enable: bool = True,
-    cache_store_mode: StoreMode = "outputs_metadata",
+    cache_store_mode: StoreMode = _DEFAULT_CACHE_STORE_MODE,
 ) -> Callable:
     """Decorator to store function output in a cache file.
 
@@ -169,6 +195,7 @@ def disk_cache_decorator(
         cache_checksum_fn=cache_checksum_fn,
         cache_saving_backend=cache_saving_backend,
         cache_fname_fmt=cache_fname_fmt,
+        cache_fname_fmt_args=cache_fname_fmt_args,
         cache_dump_fn=cache_dump_fn,
         cache_load_fn=cache_load_fn,
         cache_enable=cache_enable,
@@ -190,10 +217,30 @@ def disk_cache_call(
     cache_checksum_fn: ChecksumFn = checksum_any,
     cache_saving_backend: Literal["custom"],
     cache_fname_fmt: Union[str, Callable[..., str]] = "{fn_name}_{csum}{suffix}",
-    cache_dump_fn: Optional[Callable[[Any, Path], Any]] = None,
-    cache_load_fn: Optional[Callable[[Path], Any]] = None,
+    cache_fname_fmt_args: Optional[Iterable[str]] = None,
+    cache_dump_fn: Callable[[Any, Path], Any],
+    cache_load_fn: Callable[[Path], Any],
+    cache_enable: bool = True,
+    cache_store_mode: StoreMode,
+    **kwargs,
+) -> T: ...
+
+
+@overload
+def disk_cache_call(
+    fn: Callable[..., T],
+    *args,
+    cache_dpath: Union[str, Path, None] = None,
+    cache_force: bool = False,
+    cache_verbose: int = 0,
+    cache_checksum_fn: ChecksumFn = checksum_any,
+    cache_saving_backend: SavingBackend,
+    cache_fname_fmt: Union[str, Callable[..., str]] = "{fn_name}_{csum}{suffix}",
+    cache_fname_fmt_args: Optional[Iterable[str]] = None,
+    cache_dump_fn: None = None,
+    cache_load_fn: None = None,
     cache_enable: bool = True,
-    cache_store_mode: StoreMode = "outputs_metadata",
+    cache_store_mode: StoreMode = _DEFAULT_CACHE_STORE_MODE,
     **kwargs,
 ) -> T: ...
 
@@ -208,10 +255,11 @@ def disk_cache_call(
     cache_checksum_fn: ChecksumFn = checksum_any,
     cache_saving_backend: Union[SavingBackend, Literal["custom", "auto"]] = "auto",
     cache_fname_fmt: Union[str, Callable[..., str]] = "{fn_name}_{csum}{suffix}",
+    cache_fname_fmt_args: Optional[Iterable[str]] = None,
     cache_dump_fn: Optional[Callable[[Any, Path], Any]] = None,
     cache_load_fn: Optional[Callable[[Path], Any]] = None,
     cache_enable: bool = True,
-    cache_store_mode: StoreMode = "outputs_metadata",
+    cache_store_mode: StoreMode = _DEFAULT_CACHE_STORE_MODE,
     **kwargs,
 ) -> T: ...
 
@@ -225,10 +273,11 @@ def disk_cache_call(
     cache_checksum_fn: ChecksumFn = checksum_any,
     cache_saving_backend: Union[SavingBackend, Literal["custom", "auto"]] = "auto",
     cache_fname_fmt: Union[str, Callable[..., str]] = "{fn_name}_{csum}{suffix}",
+    cache_fname_fmt_args: Optional[Iterable[str]] = None,
     cache_dump_fn: Optional[Callable[[Any, Path], Any]] = None,
     cache_load_fn: Optional[Callable[[Path], Any]] = None,
     cache_enable: bool = True,
-    cache_store_mode: StoreMode = "outputs_metadata",
+    cache_store_mode: StoreMode = _DEFAULT_CACHE_STORE_MODE,
     **kwargs,
 ) -> T:
     r"""Call function and store output in a cache file.
@@ -266,6 +315,7 @@ def disk_cache_call(
         cache_checksum_fn=cache_checksum_fn,
         cache_saving_backend=cache_saving_backend,
         cache_fname_fmt=cache_fname_fmt,
+        cache_fname_fmt_args=cache_fname_fmt_args,
         cache_dump_fn=cache_dump_fn,
         cache_load_fn=cache_load_fn,
         cache_enable=cache_enable,
@@ -282,10 +332,11 @@ def _disk_cache_impl(
     cache_checksum_fn: ChecksumFn = checksum_any,
     cache_saving_backend: Union[SavingBackend, Literal["custom", "auto"]] = "auto",
     cache_fname_fmt: Union[str, Callable[..., str]] = "{fn_name}_{csum}{suffix}",
+    cache_fname_fmt_args: Optional[Iterable[str]] = None,
     cache_dump_fn: Optional[Callable[[Any, Path], Any]] = None,
     cache_load_fn: Optional[Callable[[Path], Any]] = None,
     cache_enable: bool = True,
-    cache_store_mode: StoreMode = "outputs_metadata",
+    cache_store_mode: StoreMode = _DEFAULT_CACHE_STORE_MODE,
 ) -> Callable[[Callable[P, T]], Callable[P, T]]:
     # for backward compatibility
     if cache_fname_fmt is None:
@@ -368,15 +419,30 @@ def _disk_cache_impl(
         @wraps(fn)
         def _disk_cache_wrapper(*args: P.args, **kwargs: P.kwargs) -> T:
             checksum_args = fn, args, kwargs
-            csum = cache_checksum_fn(checksum_args)
-            inputs = dict(zip(argnames, args))
-            inputs.update(kwargs)
-            cache_fname = cache_fname_fmt(
-                fn_name=fn_name,
-                csum=csum,
-                suffix=suffix,
-                **inputs,
-            )
+
+            kwds = {}
+
+            if cache_fname_fmt_args is None or "fn_name" in cache_fname_fmt_args:
+                kwds["fn_name"] = fn_name
+
+            if cache_fname_fmt_args is None or "suffix" in cache_fname_fmt_args:
+                kwds["suffix"] = suffix
+
+            if cache_fname_fmt_args is None or "csum" in cache_fname_fmt_args:
+                csum = cache_checksum_fn(checksum_args)
+                kwds["checksum"] = csum
+                kwds["csum"] = csum
+            else:
+                csum = None
+
+            inputs_kwds = {
+                argname: argval
+                for argname, argval in zip(argnames, args)
+                if cache_fname_fmt_args is None or argname in cache_fname_fmt_args
+            }
+            kwds.update(inputs_kwds)
+
+            cache_fname = cache_fname_fmt(**kwds)
             cache_fpath = cache_fn_dpath.joinpath(cache_fname)
 
             if not cache_enable:

{pythonwrench-0.4.7 → pythonwrench-0.4.9}/src/pythonwrench/semver.py

@@ -5,7 +5,7 @@ import logging
 import re
 import sys
 from dataclasses import asdict, dataclass
-from typing import Any, Iterable, List, Mapping, Tuple, TypedDict, Union, overload
+from typing import Any, List, Mapping, Tuple, TypedDict, Union, overload
 
 from typing_extensions import NotRequired, Self, TypeAlias
 
@@ -40,7 +40,7 @@ VersionTuple: TypeAlias = Union[
 ]
 
 VersionDictLike: TypeAlias = Mapping[str, Union[int, PreRelease, BuildMetadata]]
-VersionTupleLike: TypeAlias = Iterable[Union[int, PreRelease, BuildMetadata]]
+VersionTupleLike: TypeAlias = Tuple[Union[int, PreRelease, BuildMetadata], ...]
 VersionLike: TypeAlias = Union["Version", str, VersionDictLike, VersionTupleLike]
 
 
@@ -50,7 +50,7 @@ class Version:
 
     Version format is: MAJOR.MINOR.PATCH[-PRERELEASE][+BUILDMETADATA]
 
-    Based on https://semver.org/.
+    Based on https://semver.org/ version 2.0.0.
     """
 
     major: int
@@ -266,11 +266,8 @@ class Version:
         version_tuple = tuple(self.to_dict(exclude_none).values())
         return version_tuple  # type: ignore
 
-    def __str__(self) -> str:
-        return self.to_str()
-
-    def __eq__(self, other: Any) -> bool:
-        if isinstance(other, (dict, tuple, str)):
+    def equals(self, other: VersionLike, *, ignore_buildmetadata: bool = False) -> bool:
+        if isinstance(other, (Mapping, tuple, str)):
             other = Version(other)
         # note: use self.__class__ to avoid error cause by 'pytest -v test' collect
         elif not isinstance(other, (Version, self.__class__)):
@@ -281,67 +278,80 @@ class Version:
             and self.minor == other.minor
             and self.patch == other.patch
             and self.prerelease == other.prerelease
-            and self.buildmetadata == other.buildmetadata
+            and (ignore_buildmetadata or self.buildmetadata == other.buildmetadata)
         )
 
-    def __lt__(self, other: VersionLike) -> bool:
-        if isinstance(other, (dict, tuple, str)):
-            other = Version(other)
-        # note: use self.__class__ to avoid error cause by 'pytest -v test' collect
-        elif not isinstance(other, (Version, self.__class__)):
-            msg = f"Invalid argument type {type(other)}. (expected an instance of one of {(dict, tuple, str, Version)})"
-            raise TypeError(msg)
-
-        self_tuple = self.to_tuple(exclude_none=False)
-        other_tuple = other.to_tuple(exclude_none=False)
-
-        for self_v, other_v in zip(self_tuple, other_tuple):
-            if self_v == other_v:
-                continue
-            if self_v is None and other_v is not None:
-                return False
-            if self_v is not None and other_v is None:
-                return True
+    def __str__(self) -> str:
+        return self.to_str()
 
-            if isinstance(self_v, (int, str, NoneType)):
-                self_v = [self_v]
-            elif not isinstance(self_v, list):
-                raise TypeError(f"Invalid argument type {type(self_v)}.")
-
-            if isinstance(other_v, (int, str, NoneType)):
-                other_v = [other_v]
-            elif not isinstance(other_v, list):
-                raise TypeError(f"Invalid argument type {type(other_v)}.")
-
-            minlen = min(len(self_v), len(other_v))
-            if len(self_v) != len(other_v) and self_v[:minlen] == other_v[:minlen]:
-                return len(self_v) < len(other_v)
-
-            for self_vi, other_vi in zip(self_v, other_v):
-                if self_vi == other_vi:
-                    continue
-                if isinstance(self_vi, int) and isinstance(other_vi, int):
-                    return self_vi < other_vi
-                if isinstance(self_vi, int) and isinstance(other_vi, str):
-                    return True
-                if isinstance(self_vi, str) and isinstance(other_vi, int):
-                    return False
-                if isinstance(self_vi, str) and isinstance(other_vi, str):
-                    return self_vi < other_vi
-
-                msg = f"Invalid attribute type {self_vi=} and {other_vi=}."
-                raise TypeError(msg)
+    def __eq__(self, other: Any) -> bool:
+        return self.equals(other)
 
-        return False
+    def __lt__(self, other: VersionLike) -> bool:
+        return _compare_lt(self, other)
 
     def __le__(self, other: VersionLike) -> bool:
         return (self == other) or (self < other)
 
     def __gt__(self, other: VersionLike) -> bool:
-        return (self != other) and not (self < other)
+        return _compare_lt(other, self)
 
     def __ge__(self, other: VersionLike) -> bool:
-        return not (self < other)
+        return (self == other) or (self > other)
+
+
+def _compare_lt(
+    x: Union[Version, Mapping, tuple, str], y: Union[Version, Mapping, tuple, str]
+) -> bool:
+    if isinstance(x, (Mapping, tuple, str)):
+        x = Version(x)
+    if isinstance(y, (Mapping, tuple, str)):
+        y = Version(y)
+
+    self_tuple = x.to_tuple(exclude_none=False)
+    other_tuple = y.to_tuple(exclude_none=False)
+
+    self_tuple = self_tuple[:4]
+    other_tuple = other_tuple[:4]
+
+    for self_v, other_v in zip(self_tuple, other_tuple):
+        if self_v == other_v:
+            continue
+        if self_v is None and other_v is not None:
+            return False
+        if self_v is not None and other_v is None:
+            return True
+
+        if isinstance(self_v, (int, str, NoneType)):
+            self_v = [self_v]
+        elif not isinstance(self_v, list):
+            raise TypeError(f"Invalid argument type {type(self_v)}.")
+
+        if isinstance(other_v, (int, str, NoneType)):
+            other_v = [other_v]
+        elif not isinstance(other_v, list):
+            raise TypeError(f"Invalid argument type {type(other_v)}.")
+
+        minlen = min(len(self_v), len(other_v))
+        if len(self_v) != len(other_v) and self_v[:minlen] == other_v[:minlen]:
+            return len(self_v) < len(other_v)
+
+        for self_vi, other_vi in zip(self_v, other_v):
+            if self_vi == other_vi:
+                continue
+            if isinstance(self_vi, int) and isinstance(other_vi, int):
+                return self_vi < other_vi
+            if isinstance(self_vi, int) and isinstance(other_vi, str):
+                return True
+            if isinstance(self_vi, str) and isinstance(other_vi, int):
+                return False
+            if isinstance(self_vi, str) and isinstance(other_vi, str):
+                return self_vi < other_vi
+
+            msg = f"Invalid attribute type {self_vi=} and {other_vi=}."
+            raise TypeError(msg)
+
+    return False
 
 
 def _parse_version_str(version_str: str) -> VersionDict:

{pythonwrench-0.4.7 → pythonwrench-0.4.9/src/pythonwrench.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: pythonwrench
-Version: 0.4.7
+Version: 0.4.9
 Summary: Python library with tools for typing, manipulating collections, and more!
 Author-email: "Étienne Labbé (Labbeti)" <labbeti.pub@gmail.com>
 Maintainer-email: "Étienne Labbé (Labbeti)" <labbeti.pub@gmail.com>
@@ -52,7 +52,6 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: typing-extensions>=4.10.0
 Provides-Extra: dev
-Dynamic: license-file
 
 # pythonwrench
 

{pythonwrench-0.4.7 → pythonwrench-0.4.9}/src/pythonwrench.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@ LICENSE
 README.md
 pyproject.toml
 setup.py
+docs/requirements.txt
 src/pythonwrench/__init__.py
 src/pythonwrench/__main__.py
 src/pythonwrench/_core.py

{pythonwrench-0.4.7 → pythonwrench-0.4.9}/tests/test_checksum.py

@@ -57,6 +57,23 @@ class TestChecksum(TestCase):
         assert s1 == s2
         assert checksum_any(s1) == checksum_any(s2)
 
+    def test_enums(self) -> None:
+        from enum import Enum
+
+        class Color(Enum):
+            RED = 1
+            GREEN = 2
+            BLUE = 3
+            ROUGE = RED
+
+        c1 = Color.RED
+        c2 = Color.GREEN
+        assert c1 != c2
+        assert checksum_any(c1) != checksum_any(c2)
+
+        assert Color.RED == Color.ROUGE
+        assert checksum_any(Color.RED) == checksum_any(Color.ROUGE)
+
 
 if __name__ == "__main__":
     unittest.main()

{pythonwrench-0.4.7 → pythonwrench-0.4.9}/tests/test_semver.py

@@ -63,6 +63,15 @@ class TestVersion(TestCase):
         # Check if versions can be parsed
         Version(pw.__version__)
 
+        # buildmetadata can contains "-" symbol
+        v14 = Version("1.0.0+build-info")
+        assert v14.to_dict() == {
+            "major": 1,
+            "minor": 0,
+            "patch": 0,
+            "buildmetadata": "build-info",
+        }
+
     def test_parse_invalid(self) -> None:
         with self.assertRaises(ValueError):
             Version()  # type: ignore
@@ -133,6 +142,27 @@ class TestVersion(TestCase):
         for version_str in tests:
             _ = Version(version_str)
 
+    def test_priority(self) -> None:
+        v1 = Version("1.0.0")
+        v2 = Version("1.0.0-alpha")
+        v3 = Version("1.0.0+build")
+        v4 = Version("1.0.0-alpha+build")
+
+        # IMPORTANT: prerelease should have lower precedence than the associated normal version
+        assert v1 > v2
+        assert not (v1 < v2)
+        assert v1 != v2
+
+        # IMPORTANT: build metadata should not affect version precedence
+        assert not (v1 > v3)
+        assert not (v1 < v3)
+        assert v1 != v3
+
+        # check both
+        assert v1 > v4
+        assert not (v1 < v4)
+        assert v1 != v4
+
 
 if __name__ == "__main__":
     unittest.main()