feat(pandas-gbq): drop support for Python 3.9 (#16476)

tswast · web-flow · commit f38cd44be98a · 2026-04-09T13:35:56.000-05:00
Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly: - [ ] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/google-cloud-python/issues) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea - [ ] Ensure the tests and linter pass - [ ] Code coverage does not decrease (if any source code was changed) - [ ] Appropriate docs were updated (if necessary) Fixes internal b/490130968 🦕
diff --git a/packages/pandas-gbq/noxfile.py b/packages/pandas-gbq/noxfile.py
@@ -34,7 +34,17 @@
 
 DEFAULT_PYTHON_VERSION = "3.14"
 
-UNIT_TEST_PYTHON_VERSIONS = ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+UNIT_TEST_PYTHON_VERSIONS = [
+    "3.10",
+    "3.11",
+    "3.12",
+    "3.13",
+    "3.14",
+    # Not supported, but included so that we can explicitly skip the session
+    # from here. Keep unsupported versions last so that they don't conflict with
+    # the prerelease_deps session.
+    "3.9",
+]
 
 UNIT_TEST_STANDARD_DEPENDENCIES = [
     "mock",
@@ -54,7 +64,7 @@
     "geopandas",
 ]
 UNIT_TEST_EXTRAS_BY_PYTHON = {
-    "3.9": [],
+    "3.10": [],
 }
 
 SYSTEM_TEST_PYTHON_VERSIONS = ["3.12"]
@@ -225,6 +235,8 @@ def default(session):
 @_calculate_duration
 def unit(session):
     """Run the unit test suite."""
+    if session.python == "3.9":
+        session.skip("Python 3.9 is not supported.")
     default(session)
 
 
diff --git a/packages/pandas-gbq/pandas_gbq/core/biglake.py b/packages/pandas-gbq/pandas_gbq/core/biglake.py
@@ -18,7 +18,6 @@
 
 import pandas_gbq.core.resource_references
 
-
 _DRY_RUN_TEMPLATE = """
 SELECT *
 FROM `{project}.{catalog}.{namespace}.{table}`
diff --git a/packages/pandas-gbq/pandas_gbq/core/resource_references.py b/packages/pandas-gbq/pandas_gbq/core/resource_references.py
@@ -8,7 +8,6 @@
 import re
 from typing import Union
 
-
 _TABLE_REFEREENCE_PATTERN = re.compile(
     # In the past, organizations could prefix their project IDs with a domain
     # name. Such projects still exist, especially at Google.
diff --git a/packages/pandas-gbq/pandas_gbq/core/sample.py b/packages/pandas-gbq/pandas_gbq/core/sample.py
@@ -13,10 +13,10 @@
 import psutil
 
 import pandas_gbq.constants
-import pandas_gbq.core.read
 import pandas_gbq.core.biglake
-import pandas_gbq.gbq_connector
+import pandas_gbq.core.read
 import pandas_gbq.core.resource_references
+import pandas_gbq.gbq_connector
 
 # Only import at module-level at type checking time to avoid circular
 # dependencies in the pandas package, which has an optional dependency on
diff --git a/packages/pandas-gbq/setup.py b/packages/pandas-gbq/setup.py
@@ -22,10 +22,10 @@
 release_status = "Development Status :: 4 - Beta"
 dependencies = [
     "setuptools",
-    "db-dtypes >=1.0.4,<2.0.0",
-    "numpy >=1.18.1",
-    "pandas >=1.1.4",
-    "pyarrow >= 4.0.0",
+    "db-dtypes >=1.1.1,<2.0.0",
+    "numpy >=1.26.4",
+    "pandas >=1.5.3",
+    "pyarrow >= 12.0.0",
     # See https://arrow.apache.org/release/22.0.0.html
     "pyarrow >= 22.0.0; python_version >= '3.14'",
     "pydata-google-auth >=1.5.0",
@@ -46,7 +46,7 @@
         "google-cloud-bigquery-storage >=2.16.2, <3.0.0",
     ],
     "tqdm": ["tqdm>=4.23.0"],
-    "geopandas": ["geopandas>=0.9.0", "Shapely>=1.8.4"],
+    "geopandas": ["geopandas>=0.14.4", "Shapely>=1.8.5"],
 }
 
 # Setup boilerplate below this line.
@@ -88,7 +88,6 @@
         "License :: OSI Approved :: BSD License",
         "Programming Language :: Python",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
@@ -102,7 +101,7 @@
     packages=packages,
     install_requires=dependencies,
     extras_require=extras,
-    python_requires=">=3.9",
+    python_requires=">=3.10",
     include_package_data=True,
     zip_safe=False,
 )
diff --git a/packages/pandas-gbq/testing/constraints-3.10.txt b/packages/pandas-gbq/testing/constraints-3.10.txt
@@ -0,0 +1,23 @@
+# This constraints file is used to check that lower bounds
+# are correct in setup.py
+# List *all* library dependencies and extras in this file.
+# Pin the version to the lower bound.
+#
+# e.g., if setup.py has "foo >= 1.14.0, < 2.0.0dev",
+# Then this file should have foo==1.14.0
+db-dtypes==1.1.1
+numpy==1.26.4
+pandas==1.5.3
+psutil==5.9.8
+pyarrow==12.0.0
+pydata-google-auth==1.5.0
+google-api-core==2.15.0
+google-auth==2.14.1
+google-auth-oauthlib==0.7.0
+google-cloud-bigquery==3.20.0
+packaging==22.0.0
+# Extras
+google-cloud-bigquery-storage==2.16.2
+tqdm==4.23.0
+geopandas==0.14.4
+Shapely==1.8.5
diff --git a/packages/pandas-gbq/testing/constraints-3.9.txt b/packages/pandas-gbq/testing/constraints-3.9.txt
diff --git a/packages/pandas-gbq/tests/unit/core/test_biglake.py b/packages/pandas-gbq/tests/unit/core/test_biglake.py
@@ -7,8 +7,7 @@
 
 import google.cloud.bigquery
 
-from pandas_gbq.core import biglake
-from pandas_gbq.core import resource_references
+from pandas_gbq.core import biglake, resource_references
 
 
 def test_get_table_metadata(mock_bigquery_client):
