chore: require Python ≥ 3.9, protobuf ≥ 4.25.8

.github/workflows/unittest.yml

@@ -35,21 +35,19 @@ jobs:
         nox -s prerelease_deps
   unit:
     name: unit${{ matrix.option }}-${{ matrix.python }}
-    # TODO(https://github.com/googleapis/gapic-generator-python/issues/2303): use `ubuntu-latest` once this bug is fixed.
-    # Use ubuntu-22.04 until Python 3.7 is removed from the test matrix
-    # https://docs.github.com/en/actions/using-github-hosted-runners/using-github-hosted-runners/about-github-hosted-runners#standard-github-hosted-runners-for-public-repositories
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-latest
     strategy:
       matrix:
         python:
-          - "3.7"
-          - "3.8"
           - "3.9"
           - "3.10"
           - "3.11"
           - "3.12"
           - "3.13"
           - "3.14"
+        option:
+          - ""
+          - "_protobuf_4x"
     steps:
     - name: Checkout
       uses: actions/checkout@v4
@@ -64,14 +62,14 @@ jobs:
         python -m pip install nox
     - name: Run unit tests
       env:
-        COVERAGE_FILE: .coverage-${{matrix.python }}
+        COVERAGE_FILE: .coverage${{ matrix.option }}-${{matrix.python }}
       run: |
-        nox -s unit-${{ matrix.python }}
+        nox -s unit${{ matrix.option }}-${{ matrix.python }}
     - name: Upload coverage results
       uses: actions/upload-artifact@v4
       with:
-        name: coverage-artifact-${{ matrix.python }}
-        path: .coverage-${{ matrix.python }}
+        name: coverage-artifact-${{ matrix.option }}-${{ matrix.python }}
+        path: .coverage${{ matrix.option }}-${{ matrix.python }}
         include-hidden-files: true
 
   report-coverage:

.kokoro/test-samples-impl.sh

@@ -33,8 +33,7 @@ export PYTHONUNBUFFERED=1
 env | grep KOKORO
 
 # Install nox
-# `virtualenv==20.26.6` is added for Python 3.7 compatibility
-python3.9 -m pip install --upgrade --quiet nox virtualenv==20.26.6
+python3.9 -m pip install --upgrade --quiet nox
 
 # Use secrets acessor service account to get secrets
 if [[ -f "${KOKORO_GFILE_DIR}/secrets_viewer_service_account.json" ]]; then

CONTRIBUTING.rst

@@ -21,7 +21,7 @@ In order to add a feature:
   documentation.
 
 - The feature must work fully on the following CPython versions:
-  3.7, 3.8, 3.9, 3.10, 3.11, 3.12, 3.13 and 3.14 on both UNIX and Windows.
+  3.9, 3.10, 3.11, 3.12, 3.13 and 3.14 on both UNIX and Windows.
 
 - The feature must not add unnecessary dependencies (where
   "unnecessary" is of course subjective, but new dependencies should
@@ -197,17 +197,13 @@ Supported Python Versions
 
 We support:
 
--  `Python 3.7`_
--  `Python 3.8`_
 -  `Python 3.9`_
 -  `Python 3.10`_
 -  `Python 3.11`_
 -  `Python 3.12`_
 -  `Python 3.13`_
 -  `Python 3.14`_
 
-.. _Python 3.7: https://docs.python.org/3.7/
-.. _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/

google/api_core/_python_package_support.py

@@ -15,7 +15,6 @@
 """Code to check versions of dependencies used by Google Cloud Client Libraries."""
 
 import warnings
-import sys
 from typing import Optional, Tuple
 
 from collections import namedtuple
@@ -25,12 +24,7 @@
     _get_distribution_and_import_packages,
 )
 
-if sys.version_info >= (3, 8):
-    from importlib import metadata
-else:
-    # TODO(https://github.com/googleapis/python-api-core/issues/835): Remove
-    # this code path once we drop support for Python 3.7
-    import importlib_metadata as metadata
+from importlib import metadata
 
 ParsedVersion = Tuple[int, ...]
 
@@ -43,7 +37,7 @@
 _PACKAGE_DEPENDENCY_WARNINGS = [
     DependencyConstraint(
         "google.protobuf",
-        minimum_fully_supported_version="4.25.8",
+        minimum_fully_supported_version="5.0.0",
         recommended_version="6.x",
     )
 ]
@@ -85,8 +79,7 @@ def get_dependency_version(
     """Get the parsed version of an installed package dependency.
 
     This function checks for an installed package and returns its version
-    as a comparable tuple of integers object for safe comparison. It handles
-    both modern (Python 3.8+) and legacy (Python 3.7) environments.
+    as a comparable tuple of integers object for safe comparison.
 
     Args:
         dependency_name: The distribution name of the package (e.g., 'requests').

google/api_core/gapic_v1/method.py

@@ -31,9 +31,6 @@
 class _MethodDefault(enum.Enum):
     # Uses enum so that pytype/mypy knows that this is the only possible value.
     # https://stackoverflow.com/a/60605919/101923
-    #
-    # Literal[_DEFAULT_VALUE] is an alternative, but only added in Python 3.8.
-    # https://docs.python.org/3/library/typing.html#typing.Literal
     _DEFAULT_VALUE = object()
 
 

google/api_core/grpc_helpers.py

@@ -27,25 +27,7 @@
 
 from google.api_core import exceptions, general_helpers
 
-PROTOBUF_VERSION = google.protobuf.__version__
-
-# The grpcio-gcp package only has support for protobuf < 4
-if PROTOBUF_VERSION[0:2] == "3.":  # pragma: NO COVER
-    try:
-        import grpc_gcp
-
-        warnings.warn(
-            """Support for grpcio-gcp is deprecated. This feature will be
-            removed from `google-api-core` after January 1, 2024. If you need to
-            continue to use this feature, please pin to a specific version of
-            `google-api-core`.""",
-            DeprecationWarning,
-        )
-        HAS_GRPC_GCP = True
-    except ImportError:
-        HAS_GRPC_GCP = False
-else:
-    HAS_GRPC_GCP = False
+HAS_GRPC_GCP = False
 
 
 # The list of gRPC Callable interfaces that return iterators.
@@ -366,8 +348,7 @@ def create_channel(
               result in `ValueError` as this combination  is not yet supported.
 
         kwargs: Additional key-word args passed to
-            :func:`grpc_gcp.secure_channel` or :func:`grpc.secure_channel`.
-            Note: `grpc_gcp` is only supported in environments with protobuf < 4.0.0.
+            :func:`grpc.secure_channel`.
 
     Returns:
         grpc.Channel: The created channel.
@@ -393,20 +374,6 @@ def create_channel(
         default_host=default_host,
     )
 
-    # Note that grpcio-gcp is deprecated
-    if HAS_GRPC_GCP:  # pragma: NO COVER
-        if compression is not None and compression != grpc.Compression.NoCompression:
-            warnings.warn(
-                "The `compression` argument is ignored for grpc_gcp.secure_channel creation.",
-                DeprecationWarning,
-            )
-        if attempt_direct_path:
-            warnings.warn(
-                """The `attempt_direct_path` argument is ignored for grpc_gcp.secure_channel creation.""",
-                DeprecationWarning,
-            )
-        return grpc_gcp.secure_channel(target, composite_credentials, **kwargs)
-
     if attempt_direct_path:
         target = _modify_target_for_direct_path(target)
 

google/api_core/operations_v1/__init__.py

@@ -33,7 +33,7 @@
     from google.api_core.operations_v1.operations_rest_client_async import AsyncOperationsRestClient
 
     __all__ += ["AsyncOperationsRestClient", "AsyncOperationsRestTransport"]
-except ImportError:
+except ImportError:  # pragma: NO COVER
     # This import requires the `async_rest` extra.
     # Don't raise an exception if `AsyncOperationsRestTransport` cannot be imported
     # as other transports are still available.

google/api_core/operations_v1/abstract_operations_base_client.py

@@ -32,7 +32,7 @@
     )
 
     HAS_ASYNC_REST_DEPENDENCIES = True
-except ImportError as e:
+except ImportError as e:  # pragma: NO COVER
     HAS_ASYNC_REST_DEPENDENCIES = False
     ASYNC_REST_EXCEPTION = e
 
@@ -51,7 +51,7 @@ class AbstractOperationsBaseClientMeta(type):
 
     _transport_registry = OrderedDict()  # type: Dict[str, Type[OperationsTransport]]
     _transport_registry["rest"] = OperationsRestTransport
-    if HAS_ASYNC_REST_DEPENDENCIES:
+    if HAS_ASYNC_REST_DEPENDENCIES:  # pragma: NO COVER
         _transport_registry["rest_asyncio"] = AsyncOperationsRestTransport
 
     def get_transport_class(

google/api_core/operations_v1/transports/__init__.py

@@ -32,7 +32,7 @@
     _transport_registry["rest_asyncio"] = cast(
         OperationsTransport, AsyncOperationsRestTransport
     )
-except ImportError:
+except ImportError:  # pragma: NO COVER
     # This import requires the `async_rest` extra.
     # Don't raise an exception if `AsyncOperationsRestTransport` cannot be imported
     # as other transports are still available.