glow 0.15.7__tar.gz → 0.15.8__tar.gz

{glow-0.15.7 → glow-0.15.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: glow
-Version: 0.15.7
+Version: 0.15.8
 Summary: Functional Python tools
 Project-URL: homepage, https://github.com/arquolo/glow
 Author-email: Paul Maevskikh <arquolo@gmail.com>
@@ -33,7 +33,8 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.12
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: <3.15,>=3.12
 Requires-Dist: loguru
 Requires-Dist: loky~=3.1
 Requires-Dist: lxml
@@ -52,7 +53,7 @@ Requires-Dist: pygments; extra == 'all'
 Requires-Dist: sounddevice; extra == 'all'
 Requires-Dist: soundfile; extra == 'all'
 Provides-Extra: dev
-Requires-Dist: black~=25.1; extra == 'dev'
+Requires-Dist: black~=26.1; extra == 'dev'
 Requires-Dist: flake8-alphabetize; extra == 'dev'
 Requires-Dist: flake8-pie; extra == 'dev'
 Requires-Dist: flake8-pyi; extra == 'dev'
@@ -60,34 +61,34 @@ Requires-Dist: flake8-pyproject; extra == 'dev'
 Requires-Dist: flake8-simplify; extra == 'dev'
 Requires-Dist: flake8~=7.0; extra == 'dev'
 Requires-Dist: isort; extra == 'dev'
-Requires-Dist: mypy~=1.16; extra == 'dev'
+Requires-Dist: mypy~=1.19; extra == 'dev'
 Requires-Dist: pytest-asyncio; extra == 'dev'
-Requires-Dist: pytest~=8.0; extra == 'dev'
-Requires-Dist: ruff~=0.12.2; extra == 'dev'
+Requires-Dist: pytest~=9.0; extra == 'dev'
+Requires-Dist: ruff~=0.15.0; extra == 'dev'
 Provides-Extra: dev-core
-Requires-Dist: black~=25.1; extra == 'dev-core'
+Requires-Dist: black~=26.1; extra == 'dev-core'
 Requires-Dist: flake8-pie; extra == 'dev-core'
 Requires-Dist: flake8-pyi; extra == 'dev-core'
 Requires-Dist: flake8-pyproject; extra == 'dev-core'
 Requires-Dist: flake8-simplify; extra == 'dev-core'
 Requires-Dist: flake8~=7.0; extra == 'dev-core'
 Requires-Dist: isort; extra == 'dev-core'
-Requires-Dist: mypy~=1.16; extra == 'dev-core'
+Requires-Dist: mypy~=1.19; extra == 'dev-core'
 Requires-Dist: pytest-asyncio; extra == 'dev-core'
-Requires-Dist: pytest~=8.0; extra == 'dev-core'
-Requires-Dist: ruff~=0.12.2; extra == 'dev-core'
+Requires-Dist: pytest~=9.0; extra == 'dev-core'
+Requires-Dist: ruff~=0.15.0; extra == 'dev-core'
 Provides-Extra: dev-wemake
-Requires-Dist: black~=25.1; extra == 'dev-wemake'
+Requires-Dist: black~=26.1; extra == 'dev-wemake'
 Requires-Dist: flake8-pie; extra == 'dev-wemake'
 Requires-Dist: flake8-pyi; extra == 'dev-wemake'
 Requires-Dist: flake8-pyproject; extra == 'dev-wemake'
 Requires-Dist: flake8-simplify; extra == 'dev-wemake'
 Requires-Dist: flake8~=7.0; extra == 'dev-wemake'
 Requires-Dist: isort; extra == 'dev-wemake'
-Requires-Dist: mypy~=1.16; extra == 'dev-wemake'
+Requires-Dist: mypy~=1.19; extra == 'dev-wemake'
 Requires-Dist: pytest-asyncio; extra == 'dev-wemake'
-Requires-Dist: pytest~=8.0; extra == 'dev-wemake'
-Requires-Dist: ruff~=0.12.2; extra == 'dev-wemake'
+Requires-Dist: pytest~=9.0; extra == 'dev-wemake'
+Requires-Dist: ruff~=0.15.0; extra == 'dev-wemake'
 Requires-Dist: wemake-python-styleguide~=1.3.0; extra == 'dev-wemake'
 Provides-Extra: ic
 Requires-Dist: asttokens; extra == 'ic'

{glow-0.15.7 → glow-0.15.8}/pyproject.toml

@@ -7,10 +7,10 @@ only-packages = true
 
 [project]
 name = "glow"
-version = "0.15.7"
+version = "0.15.8"
 description = "Functional Python tools"
 readme = "README.md"
-requires-python = ">=3.12"
+requires-python = ">=3.12, <3.15"
 license = {file = "LICENSE"}
 keywords = []
 authors = [
@@ -26,6 +26,7 @@ classifiers = [
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
 ]
 dependencies = [
     "loguru",
@@ -62,17 +63,17 @@ all = [
     "matplotlib",
 ]
 dev-core = [
-    "black~=25.1",
+    "black~=26.1",
     "flake8~=7.0",
     "flake8-pie",
     "flake8-pyi",
     "flake8-pyproject",
     "flake8-simplify",
     "isort",
-    "mypy~=1.16",
-    "pytest~=8.0",
+    "mypy~=1.19",
+    "pytest~=9.0",
     "pytest-asyncio",
-    "ruff~=0.12.2",
+    "ruff~=0.15.0",
 ]
 dev = [
     "glow[dev-core]",

{glow-0.15.7 → glow-0.15.8}/src/glow/_parallel.py

@@ -441,10 +441,10 @@ def _enqueue[T](
     return sched_iter, q_get
 
 
-def _prefetch(s: ExitStack, sched_iter: Iterator, prefetch: int | None) -> int:
+def _prefetch(s: ExitStack, sched_iter: Iterator, count: int | None) -> int:
     try:
-        # Fetch up to `prefetch` tasks to pre-fill `q`
-        qsize = ilen(islice(sched_iter, prefetch))
+        # Fetch up to `count` tasks to pre-fill `q`
+        qsize = ilen(islice(sched_iter, count))
     except BaseException:
         # Unwind stack here on an error
         s.close()
@@ -469,7 +469,7 @@ def starmap_n[T](
     prefetch: int | None = 2,
     mp: bool = False,
     chunksize: int | None = None,
-    order: bool = True,
+    unordered: bool = False,
 ) -> Iterator[T]:
     """Equivalent to itertools.starmap(fn, iterable).
 
@@ -478,29 +478,27 @@ def starmap_n[T](
 
     Options:
     - workers - Count of workers, by default all hardware threads are occupied.
-    - prefetch - Extra count of scheduled jobs, if not set equals to infinity.
+    - prefetch - Count of extra jobs to schedule over N workers.
+      Helps with CPU stalls in ordered mode.
+      Increase if job execution time is highly variable.
     - mp - Whether use processes or threads.
     - chunksize - The size of the chunks the iterable will be broken into
-      before being passed to a processes. Estimated automatically.
+      before being passed to a processes.
+      Estimated automatically.
       Ignored when threads are used.
-    - order - Whether keep results order, or ignore it to increase performance.
+    - unordered - Retrieve results in order of completion or in original order.
+      In this mode `prefetch` is meaningless, because when some job became done
+      it yielded immediately releasing buffer for new job to schedule.
+      So no CPU stalls.
 
     Unlike multiprocessing.Pool or concurrent.futures.Executor this one:
     - never deadlocks on any exception or Ctrl-C interruption.
-    - accepts infinite iterables due to lazy task creation (option prefetch).
+    - accepts infinite iterables due to lazy task creation.
     - has single interface for both threads and processes.
     - TODO: serializes array-like data using out-of-band Pickle 5 buffers.
-    - before first `__next__` call it submits at most `prefetch` jobs
-      to warmup pool of workers.
-
-    Notes:
-    - To reduce latency set order to False, order of results will be arbitrary.
-    - To increase CPU usage increase prefetch or set it to None.
-    - In terms of CPU usage there's no difference between
-      prefetch=None and order=False, so choose wisely.
-    - Setting order to False makes no use of prefetch more than 0.
-
-    TODO: replace `order=True` with `unordered=False`
+    - call immediately creates pool ready to yield results
+      (which could take some time cause of serialization for multiprocessing),
+      so first `__next__` runs on warmed up pool.
     """
     if max_workers is None:
         max_workers = max_cpu_count(_NUM_CPUS, mp=mp)
@@ -512,11 +510,11 @@ def starmap_n[T](
         msg = 'With multiprocessing either chunksize or prefetch should be set'
         raise ValueError(msg)
 
-    if prefetch is not None:
+    if unordered:
+        prefetch = max(max_workers, 1)
+    elif prefetch is not None:
         prefetch = max(prefetch + max_workers, 1)
 
-    unordered = not order
-
     it = iter(iterable)
     s = ExitStack()
     submit = s.enter_context(get_executor(max_workers, mp=mp)).submit
@@ -560,7 +558,7 @@ def map_n[T](
     prefetch: int | None = 2,
     mp: bool = False,
     chunksize: int | None = None,
-    order: bool = True,
+    unordered: bool = False,
 ) -> Iterator[T]:
     """Return iterator equivalent to map(func, *iterables).
 
@@ -576,7 +574,7 @@ def map_n[T](
         prefetch=prefetch,
         mp=mp,
         chunksize=chunksize,
-        order=order,
+        unordered=unordered,
     )
 
 

{glow-0.15.7 → glow-0.15.8}/src/glow/_parallel.pyi

@@ -10,7 +10,7 @@ class _MapKwargs(TypedDict, total=False):
     chunksize: int | None
 
 class _MapIterKwargs(_MapKwargs, total=False):
-    order: bool
+    unordered: bool
 
 def max_cpu_count(upper_bound: int = ..., *, mp: bool = ...) -> int: ...
 def get_executor(

{glow-0.15.7 → glow-0.15.8}/src/glow/_thread_quota.py

@@ -8,6 +8,7 @@
 __all__ = ['ThreadQuota']
 
 import os
+import sys
 from collections import deque
 from collections.abc import Callable
 from concurrent.futures import Executor, Future
@@ -18,6 +19,13 @@ from threading import _register_atexit  # type: ignore[attr-defined]
 from threading import Lock, Thread
 from weakref import WeakSet
 
+if sys.version_info >= (3, 14):
+    from concurrent.futures.thread import WorkerContext
+
+    _worker_ctx = WorkerContext(lambda: None, ())
+else:
+    _worker_ctx = None
+
 # TODO: investigate hangups when _TIMEOUT <= .01
 _TIMEOUT = 1
 _MIN_IDLE = os.cpu_count() or 1
@@ -64,7 +72,10 @@ def _worker(q: _Pipe) -> None:
     try:
         while executor := _safe_call(q.get, timeout=_TIMEOUT):
             while work_item := _safe_call(executor._work_queue.popleft):
-                work_item.run()  # Process task
+                if sys.version_info >= (3, 14):
+                    work_item.run(_worker_ctx)  # Process task
+                else:
+                    work_item.run()
                 if _shutdown:
                     executor._shutdown = True
                     return
@@ -114,7 +125,10 @@ class ThreadQuota(Executor):
                 msg = 'cannot schedule futures after shutdown'
                 raise RuntimeError(msg)
 
-            self._work_queue.append(_WorkItem(f, fn, args, kwargs))
+            if sys.version_info >= (3, 14):
+                self._work_queue.append(_WorkItem(f, (fn, args, kwargs)))
+            else:
+                self._work_queue.append(_WorkItem(f, fn, args, kwargs))
 
             if _safe_call(self._idle.pop):  # Pool is not maximized yet
                 if q := _safe_call(_idle.pop):  # Use idle worker