Labbeti · Labbeti · Dec 13, 2025 · Jun 20, 2025 · Jun 20, 2025 · Jun 20, 2025
diff --git a/.github/workflows/test.yaml b/.github/workflows/test.yaml
@@ -23,16 +23,16 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-24.04]
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
         include:
           - os: windows-2022
             python-version: "3.8"
           - os: windows-latest
-            python-version: "3.13"
-          - os: macos-13
+            python-version: "3.14"
+          - os: macos-15
             python-version: "3.8"
           - os: macos-latest
-            python-version: "3.13"
+            python-version: "3.14"
 
     steps:
     # --- INSTALLATIONS ---

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,18 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.4.3] 2025-12-13
+### Added
+- `as_builtin` now supports `datetime.date` instances.
+- `check_only_first` argument in `isinstance_generic` function.
+- `filter_with_patterns` function.
+- `skipfiles`, `include` and `sort` to `tree_iter` function.
+- `SupportsGetitem` protocols now has `T_Index` typevar set to `Any` instead of `int` by default.
+- `SupportsGetitem2`, `SupportsGetitemLen2` and `SupportsGetitemIterLen2` protocols with generic parameters in reversed order to match `Mapping[key, value]` order.
+- `ThreadPoolExecutorHelper` class.
+- `SupportsMatmul` typing class.
+- `reduce_matmul` function.
+
 ## [0.4.2] 2025-10-16
 ### Fixed
 - `get_argnames` and `filter_and_call` functions when argument `fn` contains arguments with default values.

diff --git a/CITATION.cff b/CITATION.cff
@@ -11,11 +11,11 @@ authors:
     affiliation: IRIT
     orcid: 'https://orcid.org/0000-0002-7219-5463'
 repository-code: 'https://github.com/Labbeti/pythonwrench/'
-abstract: Set of tools for Python that could be in the standard library.
+abstract: Python library with tools for typing, manipulating collections, and more!
 keywords:
   - python
   - tools
   - utilities
 license: MIT
-version: 0.4.2
-date-released: '2025-10-16'
+version: 0.4.3
+date-released: '2025-12-13'
diff --git a/README.md b/README.md
@@ -12,27 +12,67 @@
     <img src='https://readthedocs.org/projects/pythonwrench/badge/?version=stable&style=for-the-badge' alt='Documentation Status' />
 </a>
 
-Set of tools for Python that could be in the standard library.
+Python library with tools for typing, manipulating collections, and more!
 
 </center>
 
 
 ## Installation
 
-With pip:
+With uv:
 ```bash
-pip install pythonwrench
+uv add pythonwrench
 ```
 
-With uv:
+With pip:
 ```bash
-uv add pythonwrench
+pip install pythonwrench
 ```
 
-This library has been tested on all Python versions **3.8 - 3.13**, requires only `typing_extensions>=4.10.0`, and runs on **Linux, Mac and Windows** systems.
+This library has been tested on all Python versions **3.8 - 3.14**, requires only `typing_extensions>=4.10.0`, and runs on **Linux, Mac and Windows** systems.
 
 ## Examples
 
+### Typing
+
+Check generic types with ìsinstance_generic` :
+
+```python
+>>> import pythonwrench as pw
+>>>
+>>> # Behaves like builtin isinstance() :
+>>> pw.isinstance_generic({"a": 1, "b": 2}, dict)
+... True
+>>> # But works with generic types !
+>>> pw.isinstance_generic({"a": 1, "b": 2}, dict[str, int])
+... True
+>>> pw.isinstance_generic({"a": 1, "b": 2}, dict[str, str])
+... False
+```
+
+... or check specific methods with protocols classes beginning with `Supports`
+```python
+>>> import pythonwrench as pw
+>>>
+>>> isinstance({"a": 1, "b": 2}, pw.SupportsIterLen)
+... True
+>>> isinstance({"a": 1, "b": 2}, pw.SupportsGetitemLen)
+... True
+```
+
+Finally, you can also force argument type checking with `check_args_types` function :
+
+```python
+>>> import pythonwrench as pw
+
+>>> @pw.check_args_types
+>>> def f(a: int, b: str) -> str:
+>>>     return a * b
+
+>>> f(1, "a")  # pass check
+>>> f(1, 2)  # raises TypeError from decorator
+```
+
 ### Collections
 
 Provides functions to facilitate iterables processing, like `unzip` :
@@ -80,47 +120,6 @@ Easely converts common python structures like list of dicts to dict of lists :
 ... {"a.x": 1, "a.y": 2, "b.x": 3, "b.y": 4}
 ```
 
-### Typing
-
-Check generic types with ìsinstance_generic` :
-
-```python
->>> import pythonwrench as pw
->>>
->>> # Behaves like builtin isinstance() :
->>> pw.isinstance_generic({"a": 1, "b": 2}, dict)
-... True
->>> # But works with generic types !
->>> pw.isinstance_generic({"a": 1, "b": 2}, dict[str, int])
-... True
->>> pw.isinstance_generic({"a": 1, "b": 2}, dict[str, str])
-... False
-```
-
-... or check specific methods with protocols classes beginning with `Supports`
-```python
->>> import pythonwrench as pw
->>>
->>> # Combines Iterable and Sized !
->>> isinstance({"a": 1, "b": 2}, pw.SupportsGetitemLen)
-... True
->>> isinstance({"a": 1, "b": 2}, pw.SupportsIterLen)
-... True
-```
-
-Finally, you can also force argument type checking with `check_args_types` function :
-
-```python
->>> import pythonwrench as pw
-
->>> @pw.check_args_types
->>> def f(a: int, b: str) -> str:
->>>     return a * b
-
->>> f(1, "a")  # pass check
->>> f(1, 2)  # raises TypeError from decorator
-```
-
 ### Disk caching (memoize)
 
 ```python

diff --git a/docs/conf.py b/docs/conf.py
@@ -91,7 +91,10 @@
 #         ("PyPI", "https://pypi.org/project/pythonwrench/"),
 #     ],
 # }
-html_theme_options = {}
+html_theme_options = {
+    "repo_url": "https://github.com/Labbeti/pythonwrench",
+    "site_url": "https://pypi.org/project/pythonwrench",
+}
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,

diff --git a/docs/index.rst b/docs/index.rst
@@ -2,7 +2,7 @@
 pythonwrench's documentation
 ========================================
 
-Set of tools for Python that could be in the standard library.
+Python library with tools for typing, manipulating collections, and more!
 
 See the API doc here:
 
@@ -98,9 +98,8 @@ Check generic types with ìsinstance_generic` :
 
     import pythonwrench as pw
 
-    # Combines Iterable and Sized !
-    isinstance({"a": 1, "b": 2}, pw.SupportsGetitemLen)  # True
     isinstance({"a": 1, "b": 2}, pw.SupportsIterLen)  # True
+    isinstance({"a": 1, "b": 2}, pw.SupportsGetitemLen)  # True
 
 Finally, you can also force argument type checking with `check_args_types` function :
 
@@ -171,4 +170,5 @@ Contact
 ============================
 
 Maintainer:
-- [Étienne Labbé](https://labbeti.github.io/) "Labbeti": labbeti.pub@gmail.com
+
+- `Étienne Labbé<https://labbeti.github.io/>`_ "Labbeti": labbeti.pub@gmail.com
diff --git a/docs/pythonwrench.concurrent.rst b/docs/pythonwrench.concurrent.rst
@@ -0,0 +1,7 @@
+pythonwrench.concurrent module
+==============================
+
+.. automodule:: pythonwrench.concurrent
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/pythonwrench.rst b/docs/pythonwrench.rst
@@ -25,6 +25,7 @@ Submodules
    pythonwrench.argparse
    pythonwrench.cast
    pythonwrench.checksum
+   pythonwrench.concurrent
    pythonwrench.csv
    pythonwrench.dataclasses
    pythonwrench.datetime

diff --git a/pyproject.toml b/pyproject.toml
@@ -3,9 +3,9 @@ name = "pythonwrench"
 authors = [
     {name = "Étienne Labbé (Labbeti)", email = "labbeti.pub@gmail.com"},
 ]
-description = "Set of tools for Python that could be in the standard library."
+description = "Python library with tools for typing, manipulating collections, and more!"
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.8,<3.15"
 keywords = ["python", "tools", "utilities"]
 license = {file = "LICENSE"}
 # license-files = ["LICENSE"]  # unsupported by python 3.8, but will be required in 2026
@@ -19,8 +19,12 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Scientific/Engineering",
     "Operating System :: OS Independent",
+    "Operating System :: MacOS :: MacOS X",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX",
 ]
 maintainers = [
     {name = "Étienne Labbé (Labbeti)", email = "labbeti.pub@gmail.com"},

diff --git a/src/pythonwrench/__init__.py b/src/pythonwrench/__init__.py
@@ -1,15 +1,15 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
-"""Set of tools for Python that could be in the standard library."""
+"""Python library with tools for typing, manipulating collections, and more!"""
 
 __name__ = "pythonwrench"
 __author__ = "Étienne Labbé (Labbeti)"
 __author_email__ = "labbeti.pub@gmail.com"
 __license__ = "MIT"
 __maintainer__ = "Étienne Labbé (Labbeti)"
 __status__ = "Development"
-__version__ = "0.4.2"
+__version__ = "0.4.3"
 
 
 # Re-import for language servers
@@ -52,7 +52,7 @@
     str_to_optional_str,
     str_to_type,
 )
-from .cast import as_builtin
+from .cast import as_builtin, register_as_builtin_fn
 from .checksum import checksum_any, register_checksum_fn
 from .collections import (
     all_eq,
@@ -151,6 +151,7 @@
     PatternLike,
     PatternListLike,
     compile_patterns,
+    filter_with_patterns,
     find_patterns,
     get_key_fn,
     match_patterns,