Enable py3.14 and deprecate some alias functionality

.github/workflows/ci.yml

@@ -25,15 +25,18 @@ jobs:
           - name: "3.12"
             python-version: "3.12"
             extra-install: ""
-          - name: "3.12-pre-beartype"
-            python-version: "3.12"
-            extra-install: "uv pip install --upgrade --pre beartype"
           - name: "3.13"
             python-version: "3.13"
             extra-install: ""
           - name: "3.13-pre-beartype"
             python-version: "3.13"
             extra-install: "uv pip install --upgrade --pre beartype"
+          - name: "3.14"
+            python-version: "3.14"
+            extra-install: ""
+          - name: "3.14-pre-beartype"
+            python-version: "3.14"
+            extra-install: "uv pip install --upgrade --pre beartype"
 
     name: Test ${{ matrix.value.name }}
     steps:

.pre-commit-config.yaml

@@ -2,9 +2,6 @@ ci:
   autoupdate_commit_msg: "chore: update pre-commit hooks"
   autofix_commit_msg: "style: pre-commit fixes"
 
-default_language_version:
-  python: "3.10"
-
 repos:
   - repo: meta
     hooks:

docs/comparison.md

@@ -85,6 +85,27 @@ def f(x: int, y: Number):
     return "second"
 ```
 
+% invisible-code-block: python
+%
+% import sys
+
+% skip: start if(sys.version_info < (3, 14), reason="Union repr changed in Python 3.14+")
+
+```python
+>>> try: f(1, 1)
+... except Exception as e: print(f"{type(e).__name__}: {e}")
+AmbiguousLookupError: `f(1, 1)` is ambiguous.
+Candidates:
+    f(x: int | numbers.Number, y: int)
+        <function f at ...> @ ...
+    f(x: int, y: numbers.Number)
+        <function f at ...> @ ...
+```
+
+% skip: end
+
+% skip: start if(sys.version_info >= (3, 14), reason="Union repr changed in Python 3.14+")
+
 ```python
 >>> try: f(1, 1)
 ... except Exception as e: print(f"{type(e).__name__}: {e}")
@@ -96,6 +117,8 @@ Candidates:
         <function f at ...> @ ...
 ```
 
+% skip: end
+
 Just to sanity check that things are indeed working correctly:
 
 ```python

docs/union_aliases.md

@@ -41,6 +41,22 @@ by aliasing a union, you change the way it is displayed.
 Union aliases must be activated explicitly, because the feature
 monkeypatches `Union.__str__` and `Union.__repr__`.
 
+% invisible-code-block: python
+%
+% import sys
+
+% skip: start if(sys.version_info < (3, 14), reason="Union repr changed in Python 3.14+")
+
+```python
+>>> from plum import set_union_alias
+>>> set_union_alias(Scalar, alias="Scalar")
+numpy.bool | numpy.float16 | ...
+```
+
+% skip: end
+
+% skip: start if(sys.version_info >= (3, 14), reason="Union repr changed in Python 3.14+")
+
 ```python
 >>> from plum import activate_union_aliases, set_union_alias
 
@@ -50,6 +66,8 @@ monkeypatches `Union.__str__` and `Union.__repr__`.
 typing.Union[Scalar]
 ```
 
+% skip: end
+
 After this, `help(add)` now prints the following:
 
 % skip: next "Example"
@@ -68,6 +86,30 @@ For example, printing just `Scalar` would omit the type parameter(s).
 
 Let's see with a few more examples how this works:
 
+% invisible-code-block: python
+%
+% import sys
+
+% skip: start if(sys.version_info < (3, 14), reason="Union repr changed in Python 3.14+")
+
+```python
+>>> Scalar
+numpy.bool | numpy.float16 | ...
+
+>>> Union[tuple(scalar_types)]
+numpy.bool | numpy.float16 | ...
+
+>>> Union[tuple(scalar_types) + (tuple,)]       # Scalar or tuple
+numpy.bool | numpy.float16 | ... | tuple
+
+>>> Union[tuple(scalar_types) + (tuple, list)]  # Scalar or tuple or list
+numpy.bool | numpy.float16 | ... | tuple | list
+```
+
+% skip: end
+
+% skip: start if(sys.version_info >= (3, 14), reason="Union repr changed in Python 3.14+")
+
 ```python
 >>> Scalar
 typing.Union[Scalar]
@@ -82,6 +124,8 @@ typing.Union[Scalar, tuple]
 typing.Union[Scalar, tuple, list]
 ```
 
+% skip: end
+
 If we don't include all of `scalar_types`, we won't see `Scalar`, as desired:
 
 % invisible-code-block: python
@@ -98,9 +142,12 @@ typing.Union[numpy.int8, numpy.int16, numpy.int32, numpy.longlong, numpy.int64,
 You can deactivate union aliases with `deactivate_union_aliases`:
 
 ```python
+>>> import warnings
 >>> from plum import deactivate_union_aliases
 
->>> deactivate_union_aliases()
+>>> with warnings.catch_warnings():
+...     warnings.simplefilter("ignore")
+...     deactivate_union_aliases()
 
 % skip: next "Result depends on NumPy version."
 >>> Scalar

pyproject.toml

@@ -18,7 +18,8 @@ dynamic = ["version"]
 
 requires-python = ">=3.10"
 dependencies = [
-    "beartype>=0.16.2",
+    "beartype>=0.22.2; python_version>='3.14'",
+    "beartype>=0.16.2; python_version<'3.14'",
     "typing-extensions>=4.9.0",
     "rich>=10.0"
 ]