Merge pull request #1067 from mdekstrand/tweak/data-modules

Data cleanup: private submodules, rename AttributeSet -> EntityAttribute, type cleanup

Author: mdekstrand

.github/workflows/check-sources.yml

@@ -57,7 +57,7 @@ jobs:
       - name: 🕶️ Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.12"
+          python-version: "3.14"
           activate-environment: true
 
       - name: Install packages

.github/workflows/docs.yml

@@ -31,7 +31,7 @@ jobs:
       - name: 🕶️ Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.12"
+          python-version: "3.14"
           activate-environment: true
 
       - name: 📦 Set up Python dependencies

.github/workflows/package.yml

@@ -31,7 +31,7 @@ jobs:
       - name: 🕶️ Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.12"
+          python-version: "3.12.5"
           activate-environment: true
 
       - name: Install dependencies
@@ -100,7 +100,7 @@ jobs:
 
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.12.5"
           architecture: ${{matrix.plat.pyarch}}
 
       - name: Build wheels
@@ -145,7 +145,7 @@ jobs:
       - name: 🕶️ Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.12"
+          python-version: "3.12.5"
           activate-environment: true
 
       - name: Set up Rclone configuration

.github/workflows/test.yml

@@ -21,7 +21,7 @@ jobs:
       fail-fast: false
       matrix:
         python:
-          - "3.12"
+          - "3.12.5"
           - "3.13"
           - "3.14"
           - "3.14t"
@@ -118,7 +118,7 @@ jobs:
 
       - name: 📦 Set up Python dependencies
         run: |
-          uv sync -p 3.12
+          uv sync -p 3.12.5
 
       - name: 🏃🏻‍➡️ Test LKPY
         run: |
@@ -157,7 +157,7 @@ jobs:
       - name: 🕶️ Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.12"
+          python-version: "3.12.5"
           activate-environment: true
 
       - name: 📦 Set up Python dependencies
@@ -209,7 +209,7 @@ jobs:
       - name: 🕶️ Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.12"
+          python-version: "3.12.5"
           activate-environment: true
 
       - name: 📦 Set up Python dependencies
@@ -263,7 +263,7 @@ jobs:
       - name: 🕶️ Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.12"
+          python-version: "3.12.5"
           activate-environment: true
 
       - name: 📦 Set up Python dependencies (Unix)
@@ -326,7 +326,7 @@ jobs:
       - name: 🕶️ Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.12"
+          python-version: "3.12.5"
           activate-environment: true
 
       - name: 📦 Set up Python dependencies (Unix)
@@ -399,7 +399,7 @@ jobs:
       - name: 🕶️ Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.12"
+          python-version: "3.12.5"
           activate-environment: true
 
       - name: 📦 Set up Python dependencies

docs/releases/2026.rst

@@ -35,8 +35,13 @@ Breaking Changes
 - Many submodules (such as most modules under :mod:`lenskit.pipeline`) have been
   renamed to be private modules.  Code importing from their original locations
   will need to be updated to import from the higher-level module (:issue:`947`).
-- LensKit now requires Python 3.12 or newer, along with NumPy 2.x, Pandas 2.3 or
-  newer, and SciPy 1.13 or newer (see :ref:`dep-policy`, :pr:`954`).
+- The ``AttributeSet`` class has been renamed to
+  :class:`~lenskit.data.EntityAttribute` (:issue:`946`), to better clarify its
+  design and role.
+- LensKit now requires Python 3.12.5 or newer, along with NumPy 2.x, Pandas 2.3
+  or newer, and SciPy 1.13 or newer (see :ref:`dep-policy`, :pr:`954`).  Earlier
+  versions of Python 3.12 have a bug in the standard library that affects
+  LensKit.
 - We no longer publish 32-bit binary wheels.
 - Removed ``DecomposedMetric``, as the :class:`~lenskit.metrics.Metric` interface
   is now decomposed. All metrics based on listwise measurements or intermediate

pyproject.toml

@@ -14,7 +14,7 @@ classifiers = [
   "Operating System :: OS Independent",
   "Intended Audience :: Science/Research",
 ]
-requires-python = ">= 3.12"
+requires-python = ">= 3.12.5"
 readme = "README.md"
 license = "MIT"
 license-files = ["LICENSE.md"]

src/lenskit/basic/composite.py

@@ -10,7 +10,7 @@
 
 import numpy as np
 
-from lenskit.data.items import ItemList
+from lenskit.data import ItemList
 from lenskit.pipeline import Component, Lazy
 
 _logger = logging.getLogger(__name__)

src/lenskit/basic/history.py

@@ -17,8 +17,7 @@
 import pandas as pd
 from typing_extensions import override
 
-from lenskit.data import Dataset, ItemList, QueryInput, RecQuery
-from lenskit.data.dataset import MatrixRelationshipSet
+from lenskit.data import Dataset, ItemList, MatrixRelationshipSet, QueryInput, RecQuery
 from lenskit.diagnostics import DataError
 from lenskit.logging import get_logger, trace
 from lenskit.pipeline import Component

src/lenskit/basic/random.py

@@ -7,8 +7,7 @@
 import numpy as np
 from pydantic import BaseModel
 
-from lenskit.data import ItemList
-from lenskit.data.query import QueryInput, RecQuery
+from lenskit.data import ItemList, QueryInput, RecQuery
 from lenskit.pipeline import Component
 from lenskit.random import DerivableSeed, RNGFactory, derivable_rng
 

src/lenskit/cli/data/describe.py

@@ -12,10 +12,10 @@
 from rich.console import Console
 from rich.markdown import Markdown
 
+from lenskit.data import Dataset
+from lenskit.data._summary import save_stats
 from lenskit.data.amazon import load_amazon_ratings
-from lenskit.data.dataset import Dataset
 from lenskit.data.movielens import load_movielens
-from lenskit.data.summary import save_stats
 from lenskit.logging import get_logger
 
 _log = get_logger(__name__)