Dropped support for Python 3.9, upgrade default dev version to 3.10, and add support for Python 3.14

tpvasconcelos · tpvasconcelos · commit abea96e209d1 · 2025-10-11T23:10:58.000+11:00
Signed-off-by: Tomas Pereira de Vasconcelos &lt;tomasvasconcelos1@gmail.com&gt;
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -16,7 +16,7 @@ concurrency:
   cancel-in-progress: ${{ github.event_name == 'pull_request' }}
 
 jobs:
-  # Run static checks only for Ubuntu and Python 3.9
+  # Run static checks only for Ubuntu and the lowest support version of Python
   static-checks:
     name: Static checks
     runs-on: ubuntu-latest
@@ -25,7 +25,7 @@ jobs:
       - uses: actions/checkout@v5
       - uses: ./.github/actions/setup-python
         with:
-          python-version: "3.9"
+          python-version: "3.10"
           requirements: tox
       # Instead of running all checks in one task (i.e., `tox -m static`),
       # we'll instead run them one-by-one, so that it's easier to
@@ -47,11 +47,11 @@ jobs:
     strategy:
       matrix:
         python-version:
-          - "3.9"
           - "3.10"
           - "3.11"
           - "3.12"
           - "3.13"
+          - "3.14"
         os:
           - ubuntu-latest
           # There shouldn't be any behavior differences between OSes,
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -39,7 +39,7 @@ jobs:
           fetch-depth: 0
       - uses: ./.github/actions/setup-python
         with:
-          python-version: "3.9"
+          python-version: "3.10"
           requirements: tox
       - name: Build source (sdist) and binary (wheel) distributions
         run: tox -e build-dists
@@ -112,7 +112,7 @@ jobs:
           fetch-depth: 0
       - uses: ./.github/actions/setup-python
         with:
-          python-version: "3.9"
+          python-version: "3.10"
           requirements: tox
       - name: Generate release notes
         run: tox -e release-notes
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -1,5 +1,5 @@
 default_language_version:
-  python: python3.9
+  python: python3.10
 
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
@@ -5,7 +5,7 @@ version: 2
 build:
   os: ubuntu-lts-latest
   tools:
-    python: "3.9"
+    python: "3.10"
   apt_packages:
     # chromium-browser is required by Kaleido to generate Plotly figures via fig.write_image()
     - chromium-browser
diff --git a/Makefile b/Makefile
@@ -2,7 +2,7 @@
 # >>>  Variables
 # ==============================================================
 
-BASE_PYTHON ?= python3.9
+BASE_PYTHON ?= python3.10
 
 VENV_PATH := .venv
 VENV_BIN  := $(VENV_PATH)/bin
diff --git a/docs/development/contributing.md b/docs/development/contributing.md
@@ -26,7 +26,7 @@ Here are our guidelines for setting a **working** development environment. Most
 :::{admonition} Prerequisites
 :class: important
 
-To follow along with this guide, you will need to have [git](https://git-scm.com/), [make](https://www.gnu.org/software/make/), and [uv](https://docs.astral.sh/uv/) installed on your system. We recommend using [uv](https://docs.astral.sh/uv/guides/install-python/) to also manage your Python installations. For this project you will need Python 3.9 or higher.
+To follow along with this guide, you will need to have [git](https://git-scm.com/), [make](https://www.gnu.org/software/make/), and [uv](https://docs.astral.sh/uv/) installed on your system. We recommend using [uv](https://docs.astral.sh/uv/guides/install-python/) to also manage your Python installations. For this project you will need Python 3.10 or higher.
 :::
 
 First, you will need to [clone](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo#step-2-create-a-local-clone-of-your-fork) this repository. For this, make sure you have a [GitHub account](https://github.com/join), fork ridgeplot by clicking the [Fork](https://github.com/tpvasconcelos/ridgeplot/fork) button, and clone the main repository locally (_e.g.,_ using SSH)
@@ -55,10 +55,10 @@ The following command will:
 make init
 ```
 
-The default and **recommended** base Python is `python3.9`. However, if you encounter any issues or don't have this specific version installed on your system, you can change by it exporting the `BASE_PYTHON` environment variable to a valid executable you do have installed. Please note that we no longer support any Python versions lower than 3.9. For example, to use `python3.13`, you should run:
+The default and **recommended** base Python is `python3.10`. However, if you encounter any issues or don't have this specific version installed on your system, you can change by it exporting the `BASE_PYTHON` environment variable to a valid executable you do have installed. Please note that we no longer support any Python versions lower than 3.10. For example, to use `python3.14`, you should run:
 
 ```shell
-BASE_PYTHON=python3.13 make init
+BASE_PYTHON=python3.14 make init
 ```
 
 If for whatever reason you don't have a working internet connection (✈️, ⛵, 🏕️, 🚀, etc.), you can try exposing the `OFFLINE=1` environment variable. This will only work if compatible packages have already been cached by `uv` on your system.
diff --git a/docs/reference/changelog.md b/docs/reference/changelog.md
@@ -5,11 +5,13 @@ This document outlines the list of changes to ridgeplot between each release. Fo
 Unreleased changes
 ------------------
 
+- Add support for Python 3.14, in accordance with the official Python support policy[^1] ({gh-pr}`???`)
+- Dropped support for Python 3.9, in accordance with the official Python support policy[^1] ({gh-pr}`???`)
 - Bump project classification from Pre-Alpha to Alpha ({gh-pr}`336`)
-- Bump actions/github-script from 7 to 8 ({gh-pr}`338`)
 
 ### CI/CD
 
+- Bump actions/github-script from 7 to 8 ({gh-pr}`338`)
 - pre-commit autoupdate ({gh-pr}`340`)
 
 ---
diff --git a/misc/brand/logo.ipynb b/misc/brand/logo.ipynb
@@ -46,7 +46,7 @@
    },
    "outputs": [],
    "source": [
-    "from typing import TYPE_CHECKING, Union\n",
+    "from typing import TYPE_CHECKING\n",
     "\n",
     "import matplotlib.pyplot as plt\n",
     "import numpy as np\n",
@@ -70,7 +70,7 @@
    },
    "outputs": [],
    "source": [
-    "ColorsRow = Union[str, list[str]]\n",
+    "ColorsRow = str | list[str]\n",
     "Colors = tuple[ColorsRow, ColorsRow, ColorsRow, ColorsRow]\n",
     "\n",
     "\n",
diff --git a/mypy.ini b/mypy.ini
@@ -1,5 +1,5 @@
 [mypy]
-python_version = 3.9
+python_version = 3.10
 
 # Import discovery  ---
 files = src/ridgeplot, tests, docs, cicd_utils
diff --git a/pyproject.toml b/pyproject.toml
@@ -22,11 +22,11 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Natural Language :: English",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Programming Language :: Python :: Implementation :: CPython",
     "Topic :: Software Development",
     "Topic :: Scientific/Engineering",
@@ -37,13 +37,12 @@ classifiers = [
 keywords = [
     "ridgeline", "ridgeplot", "joyplot", "ggridges", "ridges", "ridge", "plot", "plotting", "distplot", "plotly", "data-visualization", "visualization", "data-science", "statistics", "ggplot"
 ]
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 dependencies = [
     "numpy>=1",
     "plotly>=5.20",  # The `fillgradient` option was added in 5.20
     "statsmodels>=0.12,!=0.14.2",  # See GH197 for details
     "typing-extensions",
-    'importlib-resources; python_version<"3.10"',
 ]
 
 [project.urls]
diff --git a/pyrightconfig.json b/pyrightconfig.json
@@ -15,7 +15,7 @@
   "extraPaths": [
     "cicd_utils"
   ],
-  "pythonVersion": "3.9",
+  "pythonVersion": "3.10",
   "pythonPlatform": "All",
   "typeCheckingMode": "strict",
   // stricter settings
diff --git a/requirements/typing.txt b/requirements/typing.txt
@@ -7,8 +7,9 @@ types-pytz
 types-PyYAML
 types-requests
 types-tqdm
-plotly-stubs; python_version >= "3.10"
 pandas-stubs
+# These seem to bring more problems than they solve for now... 👇
+# plotly-stubs
 
 # pyright also needs to inherit other environment dependencies in
 # order to correctly infer types for code in tests, docs, etc.
diff --git a/ruff.toml b/ruff.toml
@@ -60,7 +60,6 @@ ignore = [
 
     # pandas-vet (PD)
     "PD015", # Use `.merge` method instead of `pd.merge` function. They have equivalent functionality.
-    "PD901", # `df` is a bad variable name. Be kinder to your future self.
 
     # Convention (PLC)
     "PLC0415", # `import` should be at the top-level of a file
diff --git a/src/ridgeplot/_color/interpolation.py b/src/ridgeplot/_color/interpolation.py
@@ -10,7 +10,6 @@
 from ridgeplot._color.utils import apply_alpha, round_color, to_rgb, unpack_rgb
 from ridgeplot._types import CollectionL2, ColorScale
 from ridgeplot._utils import get_xy_extrema, normalise_min_max
-from ridgeplot._vendor.more_itertools import zip_strict
 
 if TYPE_CHECKING:
     from collections.abc import Generator
@@ -151,7 +150,7 @@ def __call__(self, ctx: InterpolationContext) -> ColorscaleInterpolants: ...
 
 def _mul(a: tuple[Numeric, ...], b: tuple[Numeric, ...]) -> tuple[Numeric, ...]:
     """Multiply two tuples element-wise."""
-    return tuple(a_i * b_i for a_i, b_i in zip_strict(a, b))
+    return tuple(a_i * b_i for a_i, b_i in zip(a, b, strict=True))
 
 
 def _interpolate_row_index(ctx: InterpolationContext) -> ColorscaleInterpolants:
diff --git a/src/ridgeplot/_color/utils.py b/src/ridgeplot/_color/utils.py
@@ -12,7 +12,6 @@
 
 if TYPE_CHECKING:
     from collections.abc import Collection
-    from typing import Union
 
     from ridgeplot._types import Color
 
@@ -54,7 +53,7 @@ def unpack_rgb(rgb: str) -> tuple[float, float, float, float] | tuple[float, flo
     prefix = rgb.split("(")[0] + "("
     values_str = map(str.strip, rgb.removeprefix(prefix).removesuffix(")").split(","))
     values_num = tuple(int(v) if v.isdecimal() else float(v) for v in values_str)
-    return cast("Union[tuple[float, float, float, float], tuple[float, float, float]]", values_num)
+    return cast("tuple[float, float, float, float] | tuple[float, float, float]", values_num)
 
 
 def apply_alpha(color: Color, alpha: float) -> str:
diff --git a/src/ridgeplot/_figure_factory.py b/src/ridgeplot/_figure_factory.py
@@ -35,7 +35,6 @@
     normalise_row_attrs,
     ordered_dedup,
 )
-from ridgeplot._vendor.more_itertools import zip_strict
 
 if TYPE_CHECKING:
     from collections.abc import Collection
@@ -188,12 +187,12 @@ def create_ridgeplot(
     fig = go.Figure()
     ith_trace = 0
     for ith_row, (row_traces, row_trace_types, row_trace_labels, row_colors) in enumerate(
-        zip_strict(densities, trace_types, trace_labels, solid_colors)
+        zip(densities, trace_types, trace_labels, solid_colors, strict=True)
     ):
         y_base = float(-ith_row * y_max * spacing)
         tickvals.append(y_base)
-        for trace, trace_type, label, color in zip_strict(
-            row_traces, row_trace_types, row_trace_labels, row_colors
+        for trace, trace_type, label, color in zip(
+            row_traces, row_trace_types, row_trace_labels, row_colors, strict=True
         ):
             trace_drawer = get_trace_cls(trace_type)(
                 trace=trace,
diff --git a/src/ridgeplot/_hist.py b/src/ridgeplot/_hist.py
@@ -7,7 +7,6 @@
 import numpy as np
 
 from ridgeplot._kde import normalize_sample_weights
-from ridgeplot._vendor.more_itertools import zip_strict
 
 if TYPE_CHECKING:
     from ridgeplot._types import (
@@ -48,7 +47,7 @@ def bin_samples(
     return [
         [
             bin_trace_samples(trace_samples, nbins=nbins, weights=weights)
-            for trace_samples, weights in zip_strict(samples_row, weights_row)
+            for trace_samples, weights in zip(samples_row, weights_row, strict=True)
         ]
-        for samples_row, weights_row in zip_strict(samples, normalised_weights)
+        for samples_row, weights_row in zip(samples, normalised_weights, strict=True)
     ]
diff --git a/src/ridgeplot/_kde.py b/src/ridgeplot/_kde.py
@@ -4,7 +4,7 @@
 
 from collections.abc import Callable, Collection
 from functools import partial
-from typing import TYPE_CHECKING, Union, cast
+from typing import TYPE_CHECKING, cast
 
 import numpy as np
 import numpy.typing as npt
@@ -23,16 +23,15 @@
     nest_shallow_collection,
 )
 from ridgeplot._utils import normalise_row_attrs
-from ridgeplot._vendor.more_itertools import zip_strict
 
 if TYPE_CHECKING:
     from ridgeplot._types import Densities, Samples, SamplesTrace
 
 
-KDEPoints = Union[int, CollectionL1[Numeric]]
+KDEPoints = int | CollectionL1[Numeric]
 """The :paramref:`ridgeplot.ridgeplot.kde_points` parameter."""
 
-KDEBandwidth = Union[str, float, Callable[[CollectionL1[Numeric], StatsmodelsKernel], float]]
+KDEBandwidth = str | float | Callable[[CollectionL1[Numeric], StatsmodelsKernel], float]
 """The :paramref:`ridgeplot.ridgeplot.bandwidth` parameter."""
 
 
@@ -204,7 +203,7 @@ def estimate_densities(
     return [
         [
             kde(samples_trace, weights=weights)
-            for samples_trace, weights in zip_strict(samples_row, weights_row)
+            for samples_trace, weights in zip(samples_row, weights_row, strict=True)
         ]
-        for samples_row, weights_row in zip_strict(samples, normalised_weights)
+        for samples_row, weights_row in zip(samples, normalised_weights, strict=True)
     ]
diff --git a/src/ridgeplot/_obj/traces/base.py b/src/ridgeplot/_obj/traces/base.py
@@ -8,8 +8,6 @@
 
 from typing_extensions import Literal
 
-from ridgeplot._vendor.more_itertools import zip_strict
-
 if TYPE_CHECKING:
     from plotly import graph_objects as go
 
@@ -68,7 +66,7 @@ def __init__(
         line_width: float | None,
     ):
         super().__init__()
-        self.x, self.y = zip_strict(*trace)
+        self.x, self.y = zip(*trace, strict=True)
         self.label = label
         self.solid_color = solid_color
         self.zorder = zorder
diff --git a/src/ridgeplot/_types.py b/src/ridgeplot/_types.py
@@ -4,7 +4,6 @@
 from __future__ import annotations
 
 from collections.abc import Collection
-from typing import Optional, Union
 
 import numpy as np
 from typing_extensions import Any, Literal, TypeIs, TypeVar
@@ -37,7 +36,7 @@
 # ---  Miscellaneous types
 # ========================================================
 
-Color = Union[str, tuple[float, float, float]]
+Color = str | tuple[float, float, float]
 """A color can be represented by a tuple of ``(r, g, b)`` values or any valid
 CSS color string - including hex, rgb/a, hsl/a, hsv/a, and named CSS colors."""
 
@@ -108,13 +107,13 @@
 # ---  Numeric types
 # ========================================================
 
-Float = Union[float, np.floating[Any]]
+Float = float | np.floating[Any]
 """A :data:`~typing.TypeAlias` for float types."""
 
-Int = Union[int, np.integer[Any]]
+Int = int | np.integer[Any]
 """A :data:`~typing.TypeAlias` for a int types."""
 
-Numeric = Union[Int, Float]
+Numeric = Int | Float
 """A :data:`~typing.TypeAlias` for *numeric* types."""
 
 NumericT = TypeVar("NumericT", bound=Numeric)
@@ -605,7 +604,7 @@ def is_trace_types_array(obj: Any) -> TypeIs[TraceTypesArray]:
 
 # Sample weights ---
 
-SampleWeights = Optional[CollectionL1[Numeric]]
+SampleWeights = CollectionL1[Numeric] | None
 """An array of KDE weights corresponding to each sample."""
 
 SampleWeightsArray = CollectionL2[SampleWeights]
diff --git a/src/ridgeplot/_vendor/more_itertools.py b/src/ridgeplot/_vendor/more_itertools.py
diff --git a/tests/unit/color/test_interpolation.py b/tests/unit/color/test_interpolation.py
diff --git a/tests/unit/conftest.py b/tests/unit/conftest.py
diff --git a/tests/unit/test_figure_factory.py b/tests/unit/test_figure_factory.py
