Merge pull request #345 from tpvasconcelos/upgrade-python-support

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

Author: tpvasconcelos

.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,

.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

.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

.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

Makefile

@@ -2,7 +2,7 @@
 # >>>  Variables
 # ==============================================================
 
-BASE_PYTHON ?= python3.9
+BASE_PYTHON ?= python3.10
 
 VENV_PATH := .venv
 VENV_BIN  := $(VENV_PATH)/bin

docs/conf.py

@@ -1,6 +1,9 @@
 from __future__ import annotations
 
+import ast
 import importlib.metadata
+import inspect
+import pkgutil
 import sys
 from contextlib import contextmanager
 from datetime import datetime
@@ -10,6 +13,8 @@
 
 from typing_extensions import Any
 
+import ridgeplot as ridgeplot_pkg
+
 try:
     from ridgeplot_examples import ALL_EXAMPLES
 except ImportError:
@@ -271,47 +276,49 @@
 
 
 # Type aliases
-_TYPE_ALIASES_FULLY_QUALIFIED = {
-    # ------- ._color.css_colors -------------------
-    "ridgeplot._color.css_colors.CssNamedColor",
-    # ------- ._color.interpolation ----------------
-    "ridgeplot._color.interpolation.ColorscaleInterpolants",
-    "ridgeplot._color.interpolation.SolidColormode",
-    # ------- ._kde --------------------------------
-    "ridgeplot._kde.KDEPoints",
-    "ridgeplot._kde.KDEBandwidth",
-    # ------- ._missing ----------------------------
-    "ridgeplot._missing.MISSING",
-    "ridgeplot._missing.MissingType",
-    # ------- ._types ------------------------------
-    "ridgeplot._types.Color",
-    "ridgeplot._types.ColorScale",
-    "ridgeplot._types.NormalisationOption",
-    "ridgeplot._types.CollectionL1",
-    "ridgeplot._types.CollectionL2",
-    "ridgeplot._types.CollectionL3",
-    "ridgeplot._types.Float",
-    "ridgeplot._types.Int",
-    "ridgeplot._types.Numeric",
-    "ridgeplot._types.NumericT",
-    "ridgeplot._types.XYCoordinate",
-    "ridgeplot._types.DensityTrace",
-    "ridgeplot._types.DensitiesRow",
-    "ridgeplot._types.Densities",
-    "ridgeplot._types.ShallowDensities",
-    "ridgeplot._types.SamplesTrace",
-    "ridgeplot._types.SamplesRow",
-    "ridgeplot._types.Samples",
-    "ridgeplot._types.ShallowSamples",
-    "ridgeplot._types.TraceType",
-    "ridgeplot._types.TraceTypesArray",
-    "ridgeplot._types.ShallowTraceTypesArray",
-    "ridgeplot._types.LabelsArray",
-    "ridgeplot._types.ShallowLabelsArray",
-    "ridgeplot._types.SampleWeights",
-    "ridgeplot._types.SampleWeightsArray",
-    "ridgeplot._types.ShallowSampleWeightsArray",
-}
+def _get_module_type_aliases(module_name: str) -> set[str]:
+    module = import_module(module_name)
+    source = inspect.getsource(module)
+    tree = ast.parse(source)
+    type_aliases = {
+        f"{module_name}.{node.target.id}"
+        for node in ast.walk(tree)
+        # Handle annotated assignments: x: TypeAlias = ...
+        if (
+            isinstance(node, ast.AnnAssign)
+            and isinstance(node.target, ast.Name)
+            and isinstance(node.annotation, ast.Name)
+            and node.annotation.id == "TypeAlias"
+        )
+    }
+    return type_aliases
+
+
+def _get_package_type_aliases(package_name: str) -> set[str]:
+    """Recursively extract TypeAlias definitions from a package."""
+    package = import_module(package_name)
+    prefix = f"{package.__name__}."
+    type_aliases = set()
+    for _, modname, is_pkg in pkgutil.walk_packages(package.__path__, prefix):
+        if is_pkg:
+            type_aliases.update(_get_package_type_aliases(modname))
+        else:
+            type_aliases.update(_get_module_type_aliases(modname))
+    return type_aliases
+
+
+_TYPE_ALIASES_FULLY_QUALIFIED = (
+    # Automatically extract all TypeAlias
+    # definitions from the `ridgeplot` package
+    _get_package_type_aliases(ridgeplot_pkg.__name__)
+    | {
+        # `MISSING` is a special case that is
+        # widely referenced in type annotations
+        "ridgeplot._missing.MISSING",
+        # Same thing with the `NumericT` TypeVar
+        "ridgeplot._types.NumericT",
+    }
+)
 for fq in _TYPE_ALIASES_FULLY_QUALIFIED:
     module_name, _, type_name = fq.rpartition(".")
     try:

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.

docs/reference/changelog.md

@@ -5,11 +5,12 @@ This document outlines the list of changes to ridgeplot between each release. Fo
 Unreleased changes
 ------------------
 
+- Dropped support for Python 3.9, in accordance with the official Python support policy[^1] ({gh-pr}`345`)
 - 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`)
 
 ---

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",

mypy.ini

@@ -1,5 +1,5 @@
 [mypy]
-python_version = 3.9
+python_version = 3.10
 
 # Import discovery  ---
 files = src/ridgeplot, tests, docs, cicd_utils