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.