pythonwrench 0.4.3__tar.gz → 0.4.4__tar.gz

{pythonwrench-0.4.3 → pythonwrench-0.4.4}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Labbeti
+Copyright (c) 2026 Labbeti
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{pythonwrench-0.4.3/src/pythonwrench.egg-info → pythonwrench-0.4.4}/PKG-INFO

@@ -1,12 +1,12 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: pythonwrench
-Version: 0.4.3
+Version: 0.4.4
 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>
 License: MIT License
         
-        Copyright (c) 2025 Labbeti
+        Copyright (c) 2026 Labbeti
         
         Permission is hereby granted, free of charge, to any person obtaining a copy
         of this software and associated documentation files (the "Software"), to deal
@@ -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
 
@@ -91,7 +90,7 @@ This library has been tested on all Python versions **3.8 - 3.14**, requires onl
 
 ### Typing
 
-Check generic types with ìsinstance_generic` :
+Check generic types with `isinstance_generic` :
 
 ```python
 >>> import pythonwrench as pw

{pythonwrench-0.4.3 → pythonwrench-0.4.4}/README.md

@@ -35,7 +35,7 @@ This library has been tested on all Python versions **3.8 - 3.14**, requires onl
 
 ### Typing
 
-Check generic types with ìsinstance_generic` :
+Check generic types with `isinstance_generic` :
 
 ```python
 >>> import pythonwrench as pw

pythonwrench-0.4.4/docs/requirements.txt

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

{pythonwrench-0.4.3 → pythonwrench-0.4.4}/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.3"
+__version__ = "0.4.4"
 
 
 # Re-import for language servers
@@ -18,6 +18,7 @@ from . import argparse as argparse
 from . import cast as cast
 from . import checksum as checksum
 from . import collections as collections
+from . import concurrent as concurrent
 from . import csv as csv
 from . import dataclasses as dataclasses
 from . import datetime as datetime

{pythonwrench-0.4.3 → pythonwrench-0.4.4}/src/pythonwrench/collections/__init__.py

@@ -2,6 +2,7 @@
 # -*- coding: utf-8 -*-
 
 from .collections import (
+    SizedGenerator,
     contained,
     dict_list_to_list_dict,
     dump_dict,

{pythonwrench-0.4.3 → pythonwrench-0.4.4}/src/pythonwrench/collections/collections.py

@@ -10,8 +10,10 @@ from typing import (
     Callable,
     Dict,
     Generator,
+    Generic,
     Hashable,
     Iterable,
+    Iterator,
     List,
     Literal,
     Mapping,
@@ -47,6 +49,21 @@ KeyMode = Literal["intersect", "same", "union"]
 Order = Literal["left", "right"]
 
 
+class SizedGenerator(Generic[T]):
+    """Wraps a generator and size to provide a sized iterable object."""
+
+    def __init__(self, generator: Generator[T, None, None], size: int) -> None:
+        super().__init__()
+        self._generator = generator
+        self._size = size
+
+    def __iter__(self) -> Iterator[T]:
+        yield from self._generator
+
+    def __len__(self) -> int:
+        return self._size
+
+
 def contained(
     x: T,
     include: Optional[Iterable[T]] = None,
@@ -497,7 +514,7 @@ def list_dict_to_dict_list(
     """Convert list of dicts to dict of lists.
 
     Args:
-        lst: The list of dict to merge.
+        lst: The list of dict to merge. Cannot be a Generator.
         key_mode: Can be "same" or "intersect". \
             - If "same", all the dictionaries must contains the same keys otherwise a ValueError will be raised. \
             - If "intersect", only the intersection of all keys will be used in output. \
@@ -507,6 +524,10 @@ def list_dict_to_dict_list(
         default_val_fn: Function to return the default value according to a specific key. defaults to None.
         list_fn: Optional function to build the values. defaults to identity.
     """
+    if isinstance(lst, Generator):
+        msg = f"Invalid argument type {type(lst)}. (expected any Iterable except Generator)"
+        raise TypeError(msg)
+
     try:
         item0 = next(iter(lst))
     except StopIteration:

{pythonwrench-0.4.3 → pythonwrench-0.4.4}/src/pythonwrench/concurrent.py

@@ -3,7 +3,7 @@
 
 import logging
 from concurrent.futures import Future, ThreadPoolExecutor
-from typing import Callable, Generic, List, Optional, TypeVar
+from typing import Any, Callable, Dict, Generic, Iterable, List, Optional, TypeVar
 
 from typing_extensions import ParamSpec
 
@@ -15,16 +15,32 @@ T = TypeVar("T")
 
 
 class ThreadPoolExecutorHelper(Generic[P, T]):
-    def __init__(self, fn: Callable[P, T], **default_kwargs) -> None:
+    # Note: use commas for typing because Future is not generic in older python versions
+
+    def __init__(
+        self,
+        fn: Callable[P, T],
+        *,
+        executor_kwds: Optional[Dict[str, Any]] = None,
+        executor: Optional[ThreadPoolExecutor] = None,
+        futures: "Iterable[Future[T]]" = (),
+        **default_fn_kwds,
+    ) -> None:
+        futures = list(futures)
+
         super().__init__()
         self.fn = fn
-        self.default_kwargs = default_kwargs
-        self.executor: Optional[ThreadPoolExecutor] = None
-        self.futures: list[Future[T]] = []
+        self.executor_kwds = executor_kwds
+        self.executor = executor
+        self.futures = futures
+        self.default_kwargs = default_fn_kwds
 
-    def submit(self, *args: P.args, **kwargs: P.kwargs) -> Future[T]:
+    def submit(self, *args: P.args, **kwargs: P.kwargs) -> "Future[T]":
         if self.executor is None:
-            self.executor = ThreadPoolExecutor()
+            executor_kwds = self.executor_kwds
+            if executor_kwds is None:
+                executor_kwds = {}
+            self.executor = ThreadPoolExecutor(**executor_kwds)
 
         kwargs = self.default_kwargs | kwargs  # type: ignore
         future = self.executor.submit(self.fn, *args, **kwargs)
@@ -39,9 +55,8 @@ class ThreadPoolExecutorHelper(Generic[P, T]):
 
                 futures = tqdm.tqdm(futures, disable=not verbose)
             except ImportError:
-                logger.warning(
-                    "Cannot display verbose bar because tqdm is not installed."
-                )
+                msg = "Cannot display verbose bar because tqdm is not installed."
+                logger.warning(msg)
 
         results = [future.result() for future in futures]
         self.futures.clear()

{pythonwrench-0.4.3 → pythonwrench-0.4.4}/src/pythonwrench/disk_cache.py

@@ -5,6 +5,7 @@ import logging
 import os
 import shutil
 import time
+import warnings
 from functools import wraps
 from pathlib import Path
 from typing import (
@@ -25,7 +26,7 @@ from typing_extensions import ParamSpec
 
 from pythonwrench.checksum import checksum_any
 from pythonwrench.datetime import get_now
-from pythonwrench.inspect import get_fullname
+from pythonwrench.inspect import get_argnames, get_fullname
 
 T = TypeVar("T")
 P = ParamSpec("P")
@@ -218,6 +219,10 @@ def _disk_cache_impl(
 ) -> Callable[[Callable[P, T]], Callable[P, T]]:
     # for backward compatibility
     if cache_fname_fmt is None:
+        warnings.warn(
+            f"Deprecated argument value {cache_fname_fmt=}. (use default instead)",
+            DeprecationWarning,
+        )
         cache_fname_fmt = "{fn_name}_{csum}{suffix}"
 
     if cache_saving_backend == "pickle":
@@ -270,13 +275,19 @@ def _disk_cache_impl(
         )
         load_start_msg = f"[{fn_name}] Loading cache..."
         load_end_msg = f"[{fn_name}] Cache loaded."
+        argnames = get_argnames(fn)
 
         @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.format(
-                fn_name=fn_name, csum=csum, suffix=suffix
+                fn_name=fn_name,
+                csum=csum,
+                suffix=suffix,
+                **inputs,
             )
             cache_fpath = cache_fn_dpath.joinpath(cache_fname)
 

{pythonwrench-0.4.3 → pythonwrench-0.4.4}/src/pythonwrench/jsonl.py

@@ -18,6 +18,15 @@ from pythonwrench.json import (
 from pythonwrench.semver import Version
 from pythonwrench.warnings import warn_once
 
+__all__ = [
+    "dump_jsonl",
+    "dumps_jsonl",
+    "save_jsonl",
+    "load_jsonl",
+    "loads_jsonl",
+    "read_jsonl",
+]
+
 # -- Dump / Save / Serialize content to JSONL --
 
 

{pythonwrench-0.4.3 → pythonwrench-0.4.4/src/pythonwrench.egg-info}/PKG-INFO

@@ -1,12 +1,12 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: pythonwrench
-Version: 0.4.3
+Version: 0.4.4
 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>
 License: MIT License
         
-        Copyright (c) 2025 Labbeti
+        Copyright (c) 2026 Labbeti
         
         Permission is hereby granted, free of charge, to any person obtaining a copy
         of this software and associated documentation files (the "Software"), to deal
@@ -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
 
@@ -91,7 +90,7 @@ This library has been tested on all Python versions **3.8 - 3.14**, requires onl
 
 ### Typing
 
-Check generic types with ìsinstance_generic` :
+Check generic types with `isinstance_generic` :
 
 ```python
 >>> import pythonwrench as pw

{pythonwrench-0.4.3 → pythonwrench-0.4.4}/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.3 → pythonwrench-0.4.4}/tests/test_disk_cache.py

@@ -23,7 +23,7 @@ class TestDiskCache(TestCase):
 
     def test_disk_cache_example_2(self) -> None:
         @pw.disk_cache_decorator(
-            cache_fname_fmt="{fn_name}_{csum}.json",
+            cache_fname_fmt="{fn_name}_{csum}_x={x}.json",
             cache_load_fn=pw.load_json,
             cache_dump_fn=pw.dump_json,
         )