Merge pull request #484 from blaylockbk/477-drop-support-for-python-310-and-ensure-compatibility-with-314

Drop support for Python 3.10 and support Python 3.14  (and Pandas 3.0)

Author: blaylockbk

.github/workflows/tests-python.yml

@@ -20,21 +20,27 @@ jobs:
       matrix:
         include:
           - os: ubuntu-latest
-            python-version: "3.10"
+            python-version: "3.11"
           - os: ubuntu-latest
             python-version: "3.11"
+            resolution: "lowest-direct"
           - os: ubuntu-latest
             python-version: "3.12"
           - os: ubuntu-latest
             python-version: "3.13"
+          - os: ubuntu-latest
+            python-version: "3.14"
+          - os: ubuntu-latest
+            python-version: "3.13"
+            resolution: "lowest-direct"
           - os: macos-latest
             python-version: "3.13"
             continue-on-error: true
           - os: windows-latest
             python-version: "3.13"
             continue-on-error: true
 
-    name: Python ${{ matrix.python-version }} • ${{ matrix.os }}
+    name: Python ${{ matrix.python-version }} • ${{ matrix.os }}${{ matrix.resolution && format(' • {0}', matrix.resolution) || '' }}
 
     steps:
       - name: Checkout repository
@@ -49,7 +55,7 @@ jobs:
 
       - name: Install the project
         shell: bash -el {0}
-        run: uv sync --extra extras
+        run: uv sync --extra extras ${{ matrix.resolution && format('--resolution {0}', matrix.resolution) || '' }}
 
       - name: Run tests
         shell: bash -el {0}

docs/index.rst

@@ -144,7 +144,7 @@ Installation
 
 **Requirements:**
 
-- Python 3.10 or higher
+- Python 3.11 or higher
 - xarray and cfgrib for reading GRIB2 data
 - wgrib2 (optional, for advanced subsetting)
 

pyproject.toml

@@ -2,17 +2,17 @@
 name = "herbie-data"
 description = "Download numerical weather prediction GRIB2 model data."
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 license = { file = "LICENSE" }
 authors = [{ name = "Brian K. Blaylock", email = "blaylockbk@gmail.com" }]
 maintainers = [{ name = "Brian K. Blaylock", email = "blaylockbk@gmail.com" }]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Programming Language :: Python :: 3",
-    "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",
     "Operating System :: MacOS",
     "Operating System :: Microsoft :: Windows",
     "Operating System :: POSIX :: Linux",
@@ -31,12 +31,12 @@ keywords = [
 ]
 dependencies = [
     "cfgrib>=0.9.15",
-    "eccodes>=2.37.0",
-    "numpy>=1.24",
-    "pandas>=2.1",
+    "eccodes>=2.45.0",
+    "eccodeslib>=2.44.1.8; sys_platform != 'win32'",
+    "numpy>=1.26.4",
+    "pandas>=2.2.3",
     "pyproj>=3.7.0",
     "requests>=2.23.3",
-    "toml>=0.10.2",     # TODO: Drop in favor of tomllib when Python >=3.11 is required.
     "xarray>=2025.1.1",
 ]
 dynamic = ["version"]
@@ -55,13 +55,12 @@ build-backend = "hatchling.build"
 [dependency-groups]
 dev = [
     "ipykernel>=6.29.5",
-    "jupyter>=1.1.1",
-    "pytest>=8.3.5",
-    "pytest-cov>=6.1.1",
-    "ruff>=0.11.6",
-    "scipy>=1.15.2", # only needed for test writing netcdf file
-    "cartopy>=0.22",
-    "metpy>=1.3.0",
+    "pytest>=9.0.2",
+    "pytest-cov>=7.0.0",
+    "ruff>=0.14.14",
+    "scipy>=1.17.0",     # only needed for test writing netcdf file
+    "cartopy>=0.25.0",
+    "metpy>=1.7.1",
 ]
 docs = [
     "autodocsumm>=0.2.14",
@@ -82,11 +81,11 @@ docs = [
 
 
 [project.optional-dependencies]
-plot = ["cartopy", "matplotlib", "metpy"]
-metpy = ["metpy"]
-scikit-learn = ["scikit-learn"]
+plot = ["cartopy>=0.25.0", "matplotlib>=3.10.0", "metpy>=1.7.1"]
+metpy = ["metpy>=1.7.1"]
+scikit-learn = ["scikit-learn>=1.8.0"]
 
-pygrib = ["pygrib"]
+pygrib = ["pygrib>=2.1.8"]
 
 extras = [
     "herbie-data[plot,metpy,scikit-learn]", # Didn't include pygrib on purpose

src/herbie/__init__.py

@@ -25,10 +25,9 @@
 """
 
 import os
+import tomllib
 from pathlib import Path
 
-import toml
-
 from herbie.misc import ANSI
 
 __author__ = "Brian K. Blaylock"
@@ -148,7 +147,8 @@ def template(self):
 # Load config file (create one if needed)
 try:
     # Load the Herbie config file
-    config = toml.load(_config_file)
+    with open(_config_file, "rb") as f:
+        config = tomllib.load(f)
 except Exception:
     try:
         # Create the Herbie config file
@@ -175,7 +175,8 @@ def template(self):
         )
 
         # Load the new Herbie config file
-        config = toml.load(_config_file)
+        with open(_config_file, "rb") as f:
+            config = tomllib.load(f)
     except (FileNotFoundError, PermissionError, IOError):
         print(
             f" ╭─{ANSI.herbie}─────────────────────────────────────────────╮\n"
@@ -185,7 +186,7 @@ def template(self):
             f" │ Consider setting env variable HERBIE_CONFIG_PATH.    │\n"
             f" ╰──────────────────────────────────────────────────────╯\n"
         )
-        config = toml.loads(default_toml)
+        config = tomllib.loads(default_toml)
 
 
 # Expand the full path for `save_dir`
@@ -201,9 +202,9 @@ def template(self):
         f" ╰──────────────────────────────────────────────────────╯\n"
     )
 
+from herbie.accessors import HerbieAccessor
 from herbie.core import Herbie
-from herbie.show_versions import show_versions
 from herbie.fast import FastHerbie
 from herbie.latest import HerbieLatest, HerbieWait
+from herbie.show_versions import show_versions
 from herbie.wgrib2 import wgrib2
-from herbie.accessors import HerbieAccessor

src/herbie/core.py

@@ -825,12 +825,12 @@ def index_as_dataframe(self) -> pd.DataFrame:
             df = df.dropna(how="all", axis=1)
 
             df["search_this"] = (
-                df.loc[:, "variable":]
+                ":"
+                + df.loc[:, "variable":]
                 .astype(str)
-                .apply(
-                    lambda x: ":" + ":".join(x).rstrip(":").replace(":nan:", ":"),
-                    axis=1,
-                )
+                .apply(lambda x: x.str.cat(sep=":"), axis=1)
+                .replace(":nan:", ":")
+                + ":"
             )
 
         if self.IDX_STYLE == "eccodes":
@@ -904,12 +904,12 @@ def index_as_dataframe(self) -> pd.DataFrame:
             )
 
             df["search_this"] = (
-                df.loc[:, "param":]
+                ":"
+                + df.loc[:, "param":]
                 .astype(str)
-                .apply(
-                    lambda x: ":" + ":".join(x).rstrip(":").replace(":nan:", ":"),
-                    axis=1,
-                )
+                .apply(lambda x: x.str.cat(sep=":"), axis=1)
+                .replace(":nan:", ":")
+                + ":"
             )
 
         # Attach some attributes

tests/test_init.py

@@ -1,6 +1,5 @@
 import os
-
-import toml
+import tomllib
 
 from herbie import Path, default_toml
 
@@ -23,7 +22,7 @@ def test_Path_expand():
 
 def test_default_toml():
     # Confirm that default_toml is valid
-    a = toml.loads(default_toml)
+    a = tomllib.loads(default_toml)
 
     a["default"]["model"] == "hrrr"
     a["default"]["fxx"] == 0