pythonwrench 0.4.0__tar.gz → 0.4.1__tar.gz

{pythonwrench-0.4.0/src/pythonwrench.egg-info → pythonwrench-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: pythonwrench
-Version: 0.4.0
+Version: 0.4.1
 Summary: Set of tools for Python that could be in the standard library.
 Author-email: "Étienne Labbé (Labbeti)" <labbeti.pub@gmail.com>
 Maintainer-email: "Étienne Labbé (Labbeti)" <labbeti.pub@gmail.com>
@@ -47,7 +47,6 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: typing-extensions>=4.10.0
-Dynamic: license-file
 
 # pythonwrench
 

pythonwrench-0.4.1/docs/requirements.txt

@@ -0,0 +1,3 @@
+# -*- coding: utf-8 -*-
+
+sphinx-press-theme>=0.8.0

{pythonwrench-0.4.0 → pythonwrench-0.4.1}/src/pythonwrench/__init__.py

@@ -9,17 +9,20 @@ __author_email__ = "labbeti.pub@gmail.com"
 __license__ = "MIT"
 __maintainer__ = "Étienne Labbé (Labbeti)"
 __status__ = "Development"
-__version__ = "0.4.0"
+__version__ = "0.4.1"
 
 
 # Re-import for language servers
 from . import abc as abc
 from . import argparse as argparse
+from . import cast as cast
+from . import checksum as checksum
 from . import collections as collections
 from . import csv as csv
 from . import dataclasses as dataclasses
 from . import datetime as datetime
 from . import difflib as difflib
+from . import disk_cache as disk_cache
 from . import entries as entries
 from . import enum as enum
 from . import functools as functools
@@ -28,6 +31,7 @@ from . import importlib as importlib
 from . import inspect as inspect
 from . import io as io
 from . import json as json
+from . import jsonl as jsonl
 from . import logging as logging
 from . import math as math
 from . import os as os
@@ -166,6 +170,7 @@ from .typing import (
     SupportsAnd,
     SupportsBool,
     SupportsDiv,
+    SupportsGetitem,
     SupportsGetitemIterLen,
     SupportsGetitemLen,
     SupportsIterLen,

{pythonwrench-0.4.0 → pythonwrench-0.4.1}/src/pythonwrench/_core.py

@@ -9,22 +9,26 @@ from typing import (
     Generic,
     Literal,
     Optional,
+    Protocol,
     Tuple,
-    TypeVar,
     Union,
     get_args,
 )
 
-from typing_extensions import ParamSpec
+from typing_extensions import ParamSpec, TypeVar
 
 P = ParamSpec("P")
 T = TypeVar("T")
 U = TypeVar("U")
 T_Output = TypeVar("T_Output")
+T_Any = TypeVar("T_Any", contravariant=True, default=Any)
 
 UnkMode = Literal["identity", "error"]
 ClassOrTuple = Union[type, Tuple[type, ...]]
-Predicate = Callable[[Any], bool]
+
+
+class Predicate(Protocol[T_Any]):
+    def __call__(self, x: T_Any) -> bool: ...
 
 
 def return_none(*args, **kwargs) -> None:

{pythonwrench-0.4.0 → pythonwrench-0.4.1}/src/pythonwrench/argparse.py

@@ -35,7 +35,7 @@ def parse_to(
 ) -> Callable[[str], T]:
     """Returns a callable that convert string value to target type safely.
 
-    Intended for argparse boolean arguments.
+    Intended for argparse arguments.
     """
     return partial(
         str_to_type,
@@ -56,7 +56,7 @@ def str_to_type(
     false_values: Union[str, Iterable[str]] = DEFAULT_FALSE_VALUES,
     none_values: Union[str, Iterable[str]] = DEFAULT_NONE_VALUES,
 ) -> T:
-    """Convert string values to target type safely. Intended for argparse boolean arguments.
+    """Convert string values to target type safely. Intended for argparse arguments.
 
     - True values: 'True', 'T', 'yes', 'y', '1'.
     - False values: 'False', 'F', 'no', 'n', '0'.
@@ -84,7 +84,7 @@ def str_to_bool(
     true_values: Union[str, Iterable[str]] = DEFAULT_TRUE_VALUES,
     false_values: Union[str, Iterable[str]] = DEFAULT_FALSE_VALUES,
 ) -> bool:
-    """Convert string values to bool safely. Intended for argparse boolean arguments.
+    """Convert string values to bool safely. Intended for argparse arguments.
 
     - True values: 'True', 'T', 'yes', 'y', '1'.
     - False values: 'False', 'F', 'no', 'n', '0'.
@@ -105,7 +105,7 @@ def str_to_none(
     case_sensitive: bool = False,
     none_values: Union[str, Iterable[str]] = DEFAULT_NONE_VALUES,
 ) -> None:
-    """Convert string values to None safely. Intended for argparse boolean arguments.
+    """Convert string values to None safely. Intended for argparse arguments.
 
     - None values: 'None', 'null'
     - Other raises ValueError.
@@ -123,7 +123,7 @@ def str_to_optional_bool(
     false_values: Union[str, Iterable[str]] = DEFAULT_FALSE_VALUES,
     none_values: Union[str, Iterable[str]] = DEFAULT_NONE_VALUES,
 ) -> Optional[bool]:
-    """Convert string values to optional bool safely. Intended for argparse boolean arguments.
+    """Convert string values to optional bool safely. Intended for argparse arguments.
 
     - True values: 'True', 'T', 'yes', 'y', '1'.
     - False values: 'False', 'F', 'no', 'n', '0'.
@@ -141,7 +141,7 @@ def str_to_optional_float(
     case_sensitive: bool = False,
     none_values: Union[str, Iterable[str]] = DEFAULT_NONE_VALUES,
 ) -> Optional[float]:
-    """Convert string values to optional float safely. Intended for argparse boolean arguments."""
+    """Convert string values to optional float safely. Intended for argparse arguments."""
     return str_to_type(
         x, Optional[float], case_sensitive=case_sensitive, none_values=none_values
     )
@@ -153,7 +153,7 @@ def str_to_optional_int(
     case_sensitive: bool = False,
     none_values: Union[str, Iterable[str]] = DEFAULT_NONE_VALUES,
 ) -> Optional[int]:
-    """Convert string values to optional int safely. Intended for argparse boolean arguments."""
+    """Convert string values to optional int safely. Intended for argparse arguments."""
     return str_to_type(
         x, Optional[int], case_sensitive=case_sensitive, none_values=none_values
     )
@@ -165,7 +165,7 @@ def str_to_optional_str(
     case_sensitive: bool = False,
     none_values: Union[str, Iterable[str]] = DEFAULT_NONE_VALUES,
 ) -> Optional[str]:
-    """Convert string values to optional str safely. Intended for argparse boolean arguments."""
+    """Convert string values to optional str safely. Intended for argparse arguments."""
     return str_to_type(
         x, Optional[str], case_sensitive=case_sensitive, none_values=none_values
     )
@@ -284,7 +284,7 @@ def _str_to_none_impl(
     case_sensitive: bool = False,
     none_values: Union[str, Iterable[str]] = DEFAULT_NONE_VALUES,
 ) -> Union[None, Exception]:
-    """Convert string values to None safely. Intended for argparse boolean arguments.
+    """Convert string values to None safely. Intended for argparse arguments.
 
     - None values: 'None', 'null'
     - Other raises ValueError.

{pythonwrench-0.4.0 → pythonwrench-0.4.1}/src/pythonwrench/checksum.py

@@ -196,7 +196,9 @@ def checksum_set(x: Union[set, frozenset], **kwargs) -> int:
     kwargs["accumulator"] = kwargs.get("accumulator", 0) + _cached_checksum_str(
         get_fullname(x)
     )
-    return _checksum_iterable(sorted(x), **kwargs)
+    # Simply use sum here, order does not matter
+    csum = sum(checksum_any(xi, **kwargs) for xi in x)
+    return csum
 
 
 @register_checksum_fn(range)

{pythonwrench-0.4.0 → pythonwrench-0.4.1}/src/pythonwrench/importlib.py

@@ -107,14 +107,12 @@ def search_submodules(
 
 
 def reload_submodules(
-    module: ModuleType,
-    *others: ModuleType,
+    *modules: ModuleType,
     verbose: int = 0,
     only_editable: bool = True,
     only_loaded: bool = False,
 ) -> List[ModuleType]:
     """Reload all submodule recursively."""
-    modules = (module,) + others
     candidates: Dict[ModuleType, None] = {}
     for module in modules:
         submodules = search_submodules(
@@ -169,6 +167,12 @@ class Placeholder:
     def __getitem__(self, *args, **kwargs) -> Any:
         return self
 
+    def __eq__(self, other) -> Any:
+        return self == other
+
+    def __ne__(self, other) -> Any:
+        return self != other
+
 
 def requires_packages(
     arg0: Union[Iterable[str], str],

{pythonwrench-0.4.0 → pythonwrench-0.4.1}/src/pythonwrench/random.py

@@ -13,6 +13,7 @@ def randstr(
     /,
     *,
     letters: Iterable[str] = string.ascii_letters,
+    seed: Optional[int] = None,
 ) -> str: ...
 
 
@@ -23,6 +24,7 @@ def randstr(
     /,
     *,
     letters: Iterable[str] = string.ascii_letters,
+    seed: Optional[int] = None,
 ) -> str: ...
 
 
@@ -32,14 +34,23 @@ def randstr(
     /,
     *,
     letters: Iterable[str] = string.ascii_letters,
+    seed: Optional[int] = None,
 ) -> str:
     """Returns a randomly generated string of a random range length."""
     assert low_or_size >= 0
+
+    initial_state = random.getstate()
     if high is None:
         size = low_or_size
+        random.seed(seed)
     else:
         assert low_or_size < high
+        random.seed(seed)
         size = random.randint(low_or_size, high - 1)
 
     letters = list(letters)
-    return "".join(random.choice(letters) for _ in range(size))
+    result = "".join(random.choice(letters) for _ in range(size))
+
+    if seed is not None:
+        random.setstate(initial_state)
+    return result

{pythonwrench-0.4.0 → pythonwrench-0.4.1}/src/pythonwrench/typing/__init__.py

@@ -31,6 +31,7 @@ from .classes import (
     SupportsAnd,
     SupportsBool,
     SupportsDiv,
+    SupportsGetitem,
     SupportsGetitemIterLen,
     SupportsGetitemLen,
     SupportsIterLen,

{pythonwrench-0.4.0 → pythonwrench-0.4.1}/src/pythonwrench/typing/classes.py

@@ -21,7 +21,10 @@ BuiltinCollection: TypeAlias = Union[list, tuple, dict, set, frozenset]
 BuiltinNumber: TypeAlias = Union[bool, int, float, complex]
 BuiltinScalar: TypeAlias = Union[bool, int, float, complex, NoneType, str, bytes]
 
-T = TypeVar("T", covariant=True)
+_T_Item = TypeVar("_T_Item", covariant=True)
+_T_Index = TypeVar("_T_Index", contravariant=True, default=int)
+_T_Other = TypeVar("_T_Other", contravariant=True, default=Any)
+
 T_BuiltinNumber = TypeVar(
     "T_BuiltinNumber",
     bound=BuiltinNumber,
@@ -59,14 +62,14 @@ class NamedTupleInstance(Protocol):
 
 
 @runtime_checkable
-class SupportsAdd(Protocol):
-    def __add__(self, other, /):
+class SupportsAdd(Protocol[_T_Other]):
+    def __add__(self, other: _T_Other, /):
         raise NotImplementedError
 
 
 @runtime_checkable
-class SupportsAnd(Protocol):
-    def __and__(self, other, /):
+class SupportsAnd(Protocol[_T_Other]):
+    def __and__(self, other: _T_Other, /):
         raise NotImplementedError
 
 
@@ -77,14 +80,20 @@ class SupportsBool(Protocol):
 
 
 @runtime_checkable
-class SupportsDiv(Protocol):
-    def __div__(self, other, /):
+class SupportsDiv(Protocol[_T_Other]):
+    def __div__(self, other: _T_Other, /):
+        raise NotImplementedError
+
+
+@runtime_checkable
+class SupportsGetitem(Protocol[_T_Item, _T_Index]):
+    def __getitem__(self, idx: _T_Index, /) -> _T_Item:
         raise NotImplementedError
 
 
 @runtime_checkable
-class SupportsGetitemLen(Protocol[T]):
-    def __getitem__(self, idx, /) -> T:
+class SupportsGetitemLen(Protocol[_T_Item, _T_Index]):
+    def __getitem__(self, idx: _T_Index, /) -> _T_Item:
         raise NotImplementedError
 
     def __len__(self) -> int:
@@ -92,11 +101,11 @@ class SupportsGetitemLen(Protocol[T]):
 
 
 @runtime_checkable
-class SupportsGetitemIterLen(Protocol[T]):
-    def __getitem__(self, idx, /) -> T:
+class SupportsGetitemIterLen(Protocol[_T_Item, _T_Index]):
+    def __getitem__(self, idx: _T_Index, /) -> _T_Item:
         raise NotImplementedError
 
-    def __iter__(self) -> Iterator[T]:
+    def __iter__(self) -> Iterator[_T_Item]:
         raise NotImplementedError
 
     def __len__(self) -> int:
@@ -104,8 +113,8 @@ class SupportsGetitemIterLen(Protocol[T]):
 
 
 @runtime_checkable
-class SupportsIterLen(Protocol[T]):
-    def __iter__(self) -> Iterator[T]:
+class SupportsIterLen(Protocol[_T_Item]):
+    def __iter__(self) -> Iterator[_T_Item]:
         raise NotImplementedError
 
     def __len__(self) -> int:
@@ -119,12 +128,12 @@ class SupportsLen(Protocol):
 
 
 @runtime_checkable
-class SupportsMul(Protocol):
-    def __mul__(self, other, /):
+class SupportsMul(Protocol[_T_Other]):
+    def __mul__(self, other: _T_Other, /):
         raise NotImplementedError
 
 
 @runtime_checkable
-class SupportsOr(Protocol):
-    def __or__(self, other, /):
+class SupportsOr(Protocol[_T_Other]):
+    def __or__(self, other: _T_Other, /):
         raise NotImplementedError

{pythonwrench-0.4.0 → pythonwrench-0.4.1/src/pythonwrench.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: pythonwrench
-Version: 0.4.0
+Version: 0.4.1
 Summary: Set of tools for Python that could be in the standard library.
 Author-email: "Étienne Labbé (Labbeti)" <labbeti.pub@gmail.com>
 Maintainer-email: "Étienne Labbé (Labbeti)" <labbeti.pub@gmail.com>
@@ -47,7 +47,6 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: typing-extensions>=4.10.0
-Dynamic: license-file
 
 # pythonwrench
 

{pythonwrench-0.4.0 → pythonwrench-0.4.1}/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.0 → pythonwrench-0.4.1}/tests/test_checksum.py

@@ -51,6 +51,12 @@ class TestChecksum(TestCase):
         assert x0 != x1
         assert checksum_any(x0) != checksum_any(x1)
 
+    def test_sets(self) -> None:
+        s1 = {1, 2}
+        s2 = {2, 1}
+        assert s1 == s2
+        assert checksum_any(s1) == checksum_any(s2)
+
 
 if __name__ == "__main__":
     unittest.main()

{pythonwrench-0.4.0 → pythonwrench-0.4.1}/src/pythonwrench/collections/collections.py

@@ -74,17 +74,17 @@ def contained(
 @overload
 def dict_list_to_list_dict(
     dic: Mapping[T, Iterable[U]],
-    key_mode: Literal["same", "intersect"],
-    default_val: Any = None,
-) -> List[Dict[T, U]]: ...
+    key_mode: Literal["union"] = "union",
+    default_val: W = None,
+) -> List[Dict[T, Union[U, W]]]: ...
 
 
 @overload
 def dict_list_to_list_dict(
     dic: Mapping[T, Iterable[U]],
-    key_mode: Literal["union"] = "union",
-    default_val: W = None,
-) -> List[Dict[T, Union[U, W]]]: ...
+    key_mode: Literal["same", "intersect"],
+    default_val: Any = None,
+) -> List[Dict[T, U]]: ...
 
 
 def dict_list_to_list_dict(