feat: remove python 3.8 support (#1215)

* feat: remove python 3.8 support

* adds debugging to noxfile and tweaks to correct coverage

* updates lowest version for system test and owlbot

* updates DEFAULT_PYTHON_VERSION to 3.10

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* updates extras in several sessions & lists additional Python ver.

* Revert "adds debugging to noxfile and tweaks to correct coverage"

This reverts commit 4e86c04.

* adds back in code that was removed

* adds pragma to avoid cover fallure.

---------

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: 3 people

.github/sync-repo-settings.yaml

@@ -11,7 +11,6 @@ branchProtectionRules:
     - 'OwlBot Post Processor'
     - 'Kokoro'
     - 'Samples - Lint'
-    - 'Samples - Python 3.8'
     - 'Samples - Python 3.9'
     - 'Samples - Python 3.10'
     - 'Samples - Python 3.11'

CONTRIBUTING.rst

@@ -22,7 +22,7 @@ In order to add a feature:
   documentation.
 
 - The feature must work fully on the following CPython versions:
-  3.8, 3.9, 3.10, 3.11, 3.12, and 3.13 on both UNIX and Windows.
+  3.9, 3.10, 3.11, 3.12, and 3.13 on both UNIX and Windows.
 
 - The feature must not add unnecessary dependencies (where
   "unnecessary" is of course subjective, but new dependencies should
@@ -148,7 +148,7 @@ Running System Tests
 
   .. note::
 
-      System tests are only configured to run under Python 3.8, 3.12, and 3.13.
+      System tests are only configured to run under Python 3.9, 3.12, and 3.13.
       For expediency, we do not run them in older versions of Python 3.
 
   This alone will not run the tests. You'll need to change some local
@@ -195,11 +195,11 @@ configure them just like the System Tests.
 
    # Run all tests in a folder
    $ cd samples/snippets
-   $ nox -s py-3.8
+   $ nox -s py-3.9
 
    # Run a single sample test
    $ cd samples/snippets
-   $ nox -s py-3.8 -- -k <name of test>
+   $ nox -s py-3.9 -- -k <name of test>
 
 ********************************************
 Note About ``README`` as it pertains to PyPI
@@ -221,14 +221,12 @@ Supported Python Versions
 
 We support:
 
--  `Python 3.8`_
 -  `Python 3.9`_
 -  `Python 3.10`_
 -  `Python 3.11`_
 -  `Python 3.12`_
 -  `Python 3.13`_
 
-.. _Python 3.8: https://docs.python.org/3.8/
 .. _Python 3.9: https://docs.python.org/3.9/
 .. _Python 3.10: https://docs.python.org/3.10/
 .. _Python 3.11: https://docs.python.org/3.11/
@@ -241,7 +239,7 @@ Supported versions can be found in our ``noxfile.py`` `config`_.
 .. _config: https://github.com/googleapis/python-bigquery-sqlalchemy/blob/main/noxfile.py
 
 
-We also explicitly decided to support Python 3 beginning with version 3.8.
+We also explicitly decided to support Python 3 beginning with version 3.9.
 Reasons for this include:
 
 -  Encouraging use of newest versions of Python 3

README.rst

@@ -51,7 +51,7 @@ dependencies.
 
 Supported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^
-Python >= 3.8, <3.14
+Python >= 3.9, <3.14
 
 Unsupported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^

noxfile.py

@@ -39,9 +39,9 @@
     "setup.py",
 ]
 
-DEFAULT_PYTHON_VERSION = "3.8"
+DEFAULT_PYTHON_VERSION = "3.10"
 
-UNIT_TEST_PYTHON_VERSIONS: List[str] = ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+UNIT_TEST_PYTHON_VERSIONS: List[str] = ["3.9", "3.10", "3.11", "3.12", "3.13"]
 UNIT_TEST_STANDARD_DEPENDENCIES = [
     "mock",
     "asyncmock",
@@ -56,11 +56,6 @@
     "tests",
 ]
 UNIT_TEST_EXTRAS_BY_PYTHON: Dict[str, List[str]] = {
-    "3.8": [
-        "tests",
-        "alembic",
-        "bqstorage",
-    ],
     "3.11": [
         "tests",
         "geography",
@@ -78,7 +73,7 @@
     ],
 }
 
-SYSTEM_TEST_PYTHON_VERSIONS: List[str] = ["3.8", "3.12", "3.13"]
+SYSTEM_TEST_PYTHON_VERSIONS: List[str] = ["3.9", "3.12", "3.13"]
 SYSTEM_TEST_STANDARD_DEPENDENCIES: List[str] = [
     "mock",
     "pytest",
@@ -91,11 +86,6 @@
     "tests",
 ]
 SYSTEM_TEST_EXTRAS_BY_PYTHON: Dict[str, List[str]] = {
-    "3.8": [
-        "tests",
-        "alembic",
-        "bqstorage",
-    ],
     "3.12": [
         "tests",
         "geography",
@@ -398,10 +388,8 @@ def compliance(session):
         "-c",
         constraints_path,
     )
-    if session.python == "3.8":
-        extras = "[tests,alembic]"
-    elif session.python in ["3.12", "3.13"]:
-        extras = "[tests,geography]"
+    if session.python in ["3.12", "3.13"]:
+        extras = "[tests,geography,alembic]"
     else:
         extras = "[tests]"
     session.install("-e", f".{extras}", "-c", constraints_path)

owlbot.py

@@ -30,14 +30,14 @@
 # ----------------------------------------------------------------------------
 extras = ["tests"]
 extras_by_python = {
-    "3.8": ["tests", "alembic", "bqstorage"],
+    "3.9": ["tests", "alembic", "bqstorage"],
     "3.11": ["tests", "geography", "bqstorage"],
     "3.12": ["tests", "geography", "bqstorage"],
     "3.13": ["tests", "geography", "bqstorage"],
 }
 templated_files = common.py_library(
-    unit_test_python_versions=["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"],
-    system_test_python_versions=["3.8", "3.12", "3.13"],
+    unit_test_python_versions=["3.9", "3.10", "3.11", "3.12", "3.13"],
+    system_test_python_versions=["3.9", "3.12", "3.13"],
     cov_level=100,
     unit_test_extras=extras,
     unit_test_extras_by_python=extras_by_python,

samples/snippets/requirements-test.txt

@@ -5,16 +5,13 @@ google-auth==2.40.3
 google-cloud-testutils==1.6.4
 iniconfig==2.1.0
 packaging==25.0
-pluggy===1.5.0; python_version == '3.8'
 pluggy==1.6.0; python_version >= '3.9'
 py==1.11.0
 pyasn1==0.6.1
 pyasn1-modules==0.4.2
-pyparsing===3.1.4; python_version == '3.8'
 pyparsing==3.2.3; python_version >= '3.9'
 pytest===6.2.5
 rsa==4.9.1
 six==1.17.0
 toml==0.10.2
-typing-extensions===4.13.0; python_version == '3.8'
 typing-extensions==4.14.1; python_version >= '3.9'

samples/snippets/requirements.txt

@@ -1,37 +1,26 @@
-alembic===1.14.0; python_version == '3.8'
 alembic==1.16.4;  python_version >= '3.9'
 certifi==2025.7.14
 charset-normalizer==3.4.2
 geoalchemy2==0.17.1
 google-api-core[grpc]==2.25.1
 google-auth==2.40.3
-google-cloud-bigquery===3.30.0; python_version == '3.8'
 google-cloud-bigquery==3.35.0; python_version >= '3.9'
 google-cloud-core==2.4.3
-google-crc32c===1.5.0; python_version == '3.8'
 google-crc32c==1.7.1; python_version >= '3.9'
 google-resumable-media==2.7.2
 googleapis-common-protos==1.70.0
-greenlet===3.1.1; python_version == '3.8'
 greenlet==3.2.3; python_version >= '3.9'
-grpcio===1.68.0; python_version == '3.8'
 grpcio==1.73.1; python_version >= '3.9'
-grpcio-status===1.68.0; python_version == '3.8'
 grpcio-status==1.73.1; python_version >= '3.9'
 idna==3.10
-importlib-resources===6.4.5; python_version == '3.8'
 importlib-resources==6.5.2; python_version >= '3.9'
-mako===1.3.5; python_version == '3.8'
 mako==1.3.10; python_version >= '3.9'
-markupsafe===2.1.5; python_version == '3.8'
 markupsafe==3.0.2; python_version >= '3.9'
 packaging==25.0
 proto-plus==1.26.1
-protobuf===5.28.3; python_version == '3.8'
 protobuf==6.31.1; python_version >= '3.9'
 pyasn1==0.6.1
 pyasn1-modules==0.4.2
-pyparsing===3.1.4; python_version == '3.8'
 pyparsing==3.2.3; python_version >= '3.9'
 python-dateutil==2.9.0.post0
 pytz==2025.2
@@ -41,7 +30,5 @@ shapely===2.0.7; python_version <= '3.9'
 shapely==2.1.1; python_version >= '3.10'
 six==1.17.0
 sqlalchemy===1.4.27
-typing-extensions===4.13.0; python_version == '3.8'
 typing-extensions==4.14.1; python_version >= '3.9'
-urllib3===2.2.3; python_version == '3.8'
 urllib3==2.5.0; python_version >= '3.9'

setup.py

@@ -62,7 +62,7 @@ def readme():
         # https://github.com/grpc/grpc/pull/15254
         "grpcio >= 1.47.0, < 2.0.0",
         "grpcio >= 1.49.1, < 2.0.0; python_version>='3.11'",
-        "pyarrow >= 3.0.0",
+        "pyarrow >= 5.0.0",
     ],
 }
 

sqlalchemy_bigquery/__init__.py

@@ -48,14 +48,17 @@
 from . import _versions_helpers
 
 sys_major, sys_minor, sys_micro = _versions_helpers.extract_runtime_version()
-if sys_major == 3 and sys_minor in (7, 8):
+
+# Now that support for Python 3.7 and 3.8 has been removed, we don't expect the
+# following check to succeed. The warning is only included for robustness.
+if sys_major == 3 and sys_minor in (7, 8):  # pragma: NO COVER
     warnings.warn(
-        "The python-bigquery library will stop supporting Python 3.7 "
-        "and Python 3.8 in a future major release expected in Q4 2024. "
+        "The python-bigquery-sqlalchemy library no longer supports Python 3.7 "
+        "and Python 3.8. "
         f"Your Python version is {sys_major}.{sys_minor}.{sys_micro}. We "
         "recommend that you update soon to ensure ongoing support. For "
         "more details, see: [Google Cloud Client Libraries Supported Python Versions policy](https://cloud.google.com/python/docs/supported-python-versions)",
-        PendingDeprecationWarning,
+        FutureWarning,
     )