chore: require Python ≥ 3.9

Author: vchudnov-g

.github/workflows/tests.yaml

@@ -16,7 +16,7 @@ concurrency:
 env:
   SHOWCASE_VERSION: 0.35.0
   PROTOC_VERSION: 3.20.2
-  OLDEST_PYTHON: 3.7
+  OLDEST_PYTHON: 3.9
   LATEST_STABLE_PYTHON: 3.14
   # TODO(https://github.com/googleapis/gapic-generator-python/issues/2450):
   # Switch this to Python 3.15 alpha1 pre-release
@@ -25,7 +25,7 @@ env:
   # TODO(https://github.com/googleapis/gapic-generator-python/issues/2450):
   # Add Python 3.15 alpha1 pre-release
   # https://peps.python.org/pep-0790/
-  ALL_PYTHON: "['3.7', '3.8', '3.9', '3.10', '3.11', '3.12', '3.13', '3.14']"
+  ALL_PYTHON: "['3.9', '3.10', '3.11', '3.12', '3.13', '3.14']"
 
 permissions:
   contents: read
@@ -93,9 +93,6 @@ jobs:
         # Run mypy on all of the supported python versions listed in setup.py
         # https://github.com/python/mypy/blob/master/setup.py
         python: ${{ fromJSON(needs.all_python_setup.outputs.all_python) }}
-        exclude:
-          # Remove once https://github.com/googleapis/gapic-generator-python/issues/2303 is fixed
-          - python: '3.7'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
@@ -119,9 +116,7 @@ jobs:
         target: [showcase, showcase_w_rest_async]
         logging_scope: ["", "google"]
 
-    # 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
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
       - name: Set up Python "${{ matrix.python }}"
@@ -212,9 +207,7 @@ jobs:
         variant: ['', _alternative_templates, _mixins, _alternative_templates_mixins, _w_rest_async]
         logging_scope: ["", "google"]
 
-    # 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
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
       - name: Set up Python "${{ matrix.python }}"
@@ -318,9 +311,7 @@ jobs:
     strategy:
       matrix:
         python: ${{ fromJSON(needs.all_python_setup.outputs.all_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
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
       - name: Set up Python ${{ matrix.python }}
@@ -344,9 +335,7 @@ jobs:
       matrix:
         python: ${{ fromJSON(needs.all_python_setup.outputs.all_python) }}
         variant: ['', _alternative_templates]
-    # 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
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
       - name: Set up Python ${{ matrix.python }}

DEVELOPMENT.md

@@ -18,7 +18,7 @@
 
 Execute unit tests by running one of the sessions prefixed with `unit-`.
 
--   Example: `nox -s unit-3.8`
+-   Example: `nox -s unit-3.13`
 -   See all Nox sessions with `nox -l`.
 
 ## Formatting

README.rst

@@ -5,7 +5,7 @@ API Client Generator for Python
 
 |release level| |pypi| |versions|
 
-    A generator for protocol buffer described APIs for and in Python 3.
+    A client library generator for APIs described through protocol buffers.
 
 This is a generator for API client libraries for APIs
 specified by `protocol buffers`_, such as those inside Google.

noxfile.py

@@ -37,8 +37,6 @@
 BLACK_EXCLUDES = "|".join([".*golden.*", ".*pb2.py"])
 
 ALL_PYTHON = (
-    "3.7",
-    "3.8",
     "3.9",
     "3.10",
     "3.11",
@@ -170,17 +168,11 @@ def fragment(session, use_ads_templates=False):
         "pytest",
         "pytest-cov",
         "pytest-xdist",
-        "asyncmock; python_version < '3.8'",
         "pytest-asyncio",
         "grpcio-tools",
     )
-    session.install("-e", ".")
-
-    # TODO(https://github.com/googleapis/gapic-generator-python/issues/2473):
-    # Warnings emitted from google-api-core starting in 2.28
-    # appear to cause issues when running protoc.
     # The specific failure is `Plugin output is unparseable`
-    if session.python in ("3.7", "3.8", "3.9", "3.10"):
+    if session.python in ("3.9", "3.10"):
         session.install("google-api-core<2.28")
 
     frag_files = (
@@ -250,7 +242,7 @@ def showcase_library(
     # Warnings emitted from google-api-core starting in 2.28
     # appear to cause issues when running protoc.
     # The specific failure is `Plugin output is unparseable`
-    if session.python in ("3.7", "3.8", "3.9", "3.10"):
+    if session.python in ("3.9", "3.10"):
         session.install("google-api-core<2.28")
 
     # Install a client library for Showcase.
@@ -357,40 +349,20 @@ def showcase_library(
                 f"{tmp_dir}/testing/constraints-{session.python}.txt"
             )
             # Install the library with a constraints file.
-            if session.python == "3.7":
-                session.install("-e", tmp_dir, "-r", constraints_path)
-                if rest_async_io_enabled:
-                    # NOTE: We re-install `google-api-core` and `google-auth` to override the respective
-                    # versions for each specified in constraints-3.7.txt. This is needed because async REST
-                    # is not supported with the minimum version of `google-api-core` and `google-auth`.
-                    # TODO(https://github.com/googleapis/gapic-generator-python/issues/2211): Remove hardcoded dependencies
-                    # from here and add a new constraints file for testing the minimum supported versions for async REST feature.
-                    session.install(
-                        "--no-cache-dir",
-                        "--force-reinstall",
-                        "google-api-core[grpc, async_rest]==2.21.0",
-                    )
-                    # session.install('--no-cache-dir', '--force-reinstall', "google-api-core==2.20.0")
-                    session.install(
-                        "--no-cache-dir",
-                        "--force-reinstall",
-                        "google-auth[aiohttp]==2.35.0",
-                    )
-            else:
-                session.install(
-                    "-e",
-                    tmp_dir + ("[async_rest]" if rest_async_io_enabled else ""),
-                    "-r",
-                    constraints_path,
-                )
-                # Exclude `google-auth==2.40.0` which contains a regression
-                # https://github.com/googleapis/gapic-generator-python/issues/2385
-                session.install(
-                    "--no-cache-dir",
-                    "--force-reinstall",
-                    "--upgrade",
-                    "google-auth[aiohttp]!=2.40.0",
-                )
+            session.install(
+                "-e",
+                tmp_dir + ("[async_rest]" if rest_async_io_enabled else ""),
+                "-r",
+                constraints_path,
+            )
+            # Exclude `google-auth==2.40.0` which contains a regression
+            # https://github.com/googleapis/gapic-generator-python/issues/2385
+            session.install(
+                "--no-cache-dir",
+                "--force-reinstall",
+                "--upgrade",
+                "google-auth[aiohttp]!=2.40.0",
+            )
         else:
             # The ads templates do not have constraints files.
             # See https://github.com/googleapis/gapic-generator-python/issues/1788
@@ -497,41 +469,23 @@ def run_showcase_unit_tests(session, fail_under=100, rest_async_io_enabled=False
         "pytest",
         "pytest-cov",
         "pytest-xdist",
-        "asyncmock; python_version < '3.8'",
         "pytest-asyncio",
     )
     # Run the tests.
-    # NOTE: async rest is not supported against the minimum supported version of google-api-core.
-    # Therefore, we ignore the coverage requirement in this case.
-    if session.python == "3.7" and rest_async_io_enabled:
-        session.run(
-            "py.test",
-            *(
-                session.posargs
-                or [
-                    "-n=auto",
-                    "--quiet",
-                    "--cov=google",
-                    "--cov-append",
-                    path.join("tests", "unit"),
-                ]
-            ),
-        )
-    else:
-        session.run(
-            "py.test",
-            *(
-                session.posargs
-                or [
-                    "-n=auto",
-                    "--quiet",
-                    "--cov=google",
-                    "--cov-append",
-                    f"--cov-fail-under={str(fail_under)}",
-                    path.join("tests", "unit"),
-                ]
-            ),
-        )
+    session.run(
+        "py.test",
+        *(
+            session.posargs
+            or [
+                "-n=auto",
+                "--quiet",
+                "--cov=google",
+                "--cov-append",
+                f"--cov-fail-under={str(fail_under)}",
+                path.join("tests", "unit"),
+            ]
+        ),
+    )
 
 
 @nox.session(python=ALL_PYTHON)

setup.py

@@ -70,8 +70,6 @@
         "License :: OSI Approved :: Apache Software License",
         "Programming Language :: Python",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.7",
-        "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
@@ -83,7 +81,7 @@
         "Topic :: Software Development :: Libraries :: Python Modules",
     ],
     platforms="Posix; MacOS X",
-    python_requires=">=3.7",
+    python_requires=">=3.9",
     install_requires=dependencies,
     include_package_data=True,
     zip_safe=False,