refactor: drop Python 3.8

Author: nedbat

.github/workflows/coverage.yml

@@ -45,19 +45,15 @@ jobs:
           # tox.ini so that tox will run properly. PYVERSIONS
           # Available versions:
           # https://github.com/actions/python-versions/blob/main/versions-manifest.json
-          - "3.8"
           - "3.9"
           - "3.10"
           - "3.11"
           - "3.12"
           - "3.13"
-          - "pypy-3.8"
           - "pypy-3.9"
           - "pypy-3.10"
         exclude:
           # Mac PyPy always takes the longest, and doesn't add anything.
-          - os: macos
-            python-version: "pypy-3.8"
           - os: macos
             python-version: "pypy-3.9"
           - os: macos
@@ -146,7 +142,7 @@ jobs:
       - name: "Set up Python"
         uses: actions/setup-python@f677139bbe7f9c59b41e40162b753c062f5d49a3 # v5.2.0
         with:
-          python-version: "3.8" # Minimum of PYVERSIONS
+          python-version: "3.9" # Minimum of PYVERSIONS
           # At a certain point, installing dependencies failed on pypy 3.9 and
           # 3.10 on Windows.  Commenting out the cache here fixed it.  Someday
           # try using the cache again.

.github/workflows/kit.yml

@@ -79,7 +79,7 @@ jobs:
           #   }
           #   # PYVERSIONS. Available versions: https://pypi.org/project/cibuildwheel/
           #   # PyPy versions are handled further below in the "pypy" step.
-          #   pys = ["cp38", "cp39", "cp310", "cp311", "cp312", "cp313"]
+          #   pys = ["cp39", "cp310", "cp311", "cp312", "cp313"]
           #
           #   # Some OS/arch combinations need overrides for the Python versions:
           #   os_arch_pys = {
@@ -156,11 +156,11 @@ jobs:
       - name: "Check out the repo"
         uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938 # v4.2.0
 
-      - name: "Install Python 3.8"
+      - name: "Install Python"
         uses: actions/setup-python@f677139bbe7f9c59b41e40162b753c062f5d49a3 # v5.2.0
         with:
           # PYVERSIONS
-          python-version: "3.8"
+          python-version: "3.9"
           cache: pip
           cache-dependency-path: 'requirements/*.pip'
 
@@ -201,11 +201,11 @@ jobs:
       - name: "Check out the repo"
         uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938 # v4.2.0
 
-      - name: "Install Python 3.8"
+      - name: "Install Python"
         uses: actions/setup-python@f677139bbe7f9c59b41e40162b753c062f5d49a3 # v5.2.0
         with:
           # PYVERSIONS
-          python-version: "3.8"
+          python-version: "3.9"
           cache: pip
           cache-dependency-path: 'requirements/*.pip'
 
@@ -242,7 +242,7 @@ jobs:
       - name: "Install PyPy"
         uses: actions/setup-python@f677139bbe7f9c59b41e40162b753c062f5d49a3 # v5.2.0
         with:
-          python-version: "pypy-3.8" # Minimum of PyPy PYVERSIONS
+          python-version: "pypy-3.9" # Minimum of PyPy PYVERSIONS
           cache: pip
           cache-dependency-path: 'requirements/*.pip'
 
@@ -256,7 +256,7 @@ jobs:
         run: |
           # One wheel works for all PyPy versions. PYVERSIONS
           # yes, this is weird syntax: https://github.com/pypa/build/issues/202
-          echo -e "[bdist_wheel]\npython_tag=pp38.pp39.pp310" > $DIST_EXTRA_CONFIG
+          echo -e "[bdist_wheel]\npython_tag=pp39.pp310" > $DIST_EXTRA_CONFIG
           pypy3 -m build -w
 
       - name: "List wheels"

.github/workflows/quality.yml

@@ -42,7 +42,7 @@ jobs:
       - name: "Install Python"
         uses: actions/setup-python@f677139bbe7f9c59b41e40162b753c062f5d49a3 # v5.2.0
         with:
-          python-version: "3.8" # Minimum of PYVERSIONS
+          python-version: "3.9" # Minimum of PYVERSIONS
           cache: pip
           cache-dependency-path: 'requirements/*.pip'
 
@@ -65,7 +65,7 @@ jobs:
       - name: "Install Python"
         uses: actions/setup-python@f677139bbe7f9c59b41e40162b753c062f5d49a3 # v5.2.0
         with:
-          python-version: "3.8" # Minimum of PYVERSIONS, but at least 3.8
+          python-version: "3.9" # Minimum of PYVERSIONS
           cache: pip
           cache-dependency-path: 'requirements/*.pip'
 

.github/workflows/testsuite.yml

@@ -45,13 +45,11 @@ jobs:
           # Available versions:
           # https://github.com/actions/python-versions/blob/main/versions-manifest.json
           # https://github.com/actions/setup-python/blob/main/docs/advanced-usage.md#available-versions-of-python-and-pypy
-          - "3.8"
           - "3.9"
           - "3.10"
           - "3.11"
           - "3.12"
           - "3.13"
-          - "pypy-3.8"
           - "pypy-3.9"
           - "pypy-3.10"
         exclude:

README.rst

@@ -25,8 +25,8 @@ Coverage.py runs on these versions of Python:
 
 .. PYVERSIONS
 
-* Python 3.8 through 3.12, and 3.13.0rc1, including free-threading.
-* PyPy3 versions 3.8 through 3.10.
+* Python 3.9 through 3.12, and 3.13.0rc2, including free-threading.
+* PyPy3 versions 3.9 and 3.10.
 
 Documentation is on `Read the Docs`_.  Code repository and issue tracker are on
 `GitHub`_.

coverage/env.py

@@ -53,11 +53,6 @@ class PYBEHAVIOR:
     # across versions.
     if pep626:
         optimize_if_not_debug = 1
-    elif PYPY:
-        if PYVERSION >= (3, 9):
-            optimize_if_not_debug = 2
-        else:
-            optimize_if_not_debug = 3
     else:
         optimize_if_not_debug = 2
 
@@ -67,14 +62,13 @@ class PYBEHAVIOR:
     # CPython 3.9a1 made sys.argv[0] and other reported files absolute paths.
     report_absolute_files = (
         (CPYTHON or (PYPY and PYPYVERSION >= (7, 3, 10)))
-        and PYVERSION >= (3, 9)
     )
 
     # Lines after break/continue/return/raise are no longer compiled into the
     # bytecode.  They used to be marked as missing, now they aren't executable.
     omit_after_jump = (
         pep626
-        or (PYPY and PYVERSION >= (3, 9) and PYPYVERSION >= (7, 3, 12))
+        or (PYPY and PYPYVERSION >= (7, 3, 12))
     )
 
     # PyPy has always omitted statements after return.

coverage/execfile.py

@@ -145,10 +145,8 @@ def _prepare2(self) -> None:
             for ext in [".py", ".pyc", ".pyo"]:
                 try_filename = os.path.join(self.arg0, "__main__" + ext)
                 # 3.8.10 changed how files are reported when running a
-                # directory.  But I'm not sure how far this change is going to
-                # spread, so I'll just hard-code it here for now.
-                if env.PYVERSION >= (3, 8, 10):
-                    try_filename = os.path.abspath(try_filename)
+                # directory.
+                try_filename = os.path.abspath(try_filename)
                 if os.path.exists(try_filename):
                     self.arg0 = try_filename
                     break

doc/contributing.rst

@@ -49,7 +49,7 @@ these steps:
 
 #.  (Optional) Create a virtualenv to work in, and activate it.  There
     are a number of ways to do this.  Use the method you are comfortable with.
-    Ideally, use Python3.8 (the lowest version coverage.py supports).
+    Ideally, use Python 3.9 (the lowest version coverage.py supports).
 
 #.  Clone the repository::
 
@@ -257,7 +257,7 @@ files.  These are created by running ``make upgrade``.
 
 .. minimum of PYVERSIONS:
 
-It's important to use Python 3.8 to run ``make upgrade`` so that the pinned
+It's important to use Python 3.9 to run ``make upgrade`` so that the pinned
 versions will work on all of the Python versions currently supported by
 coverage.py.
 

doc/index.rst

@@ -18,8 +18,8 @@ supported on:
 
 .. PYVERSIONS
 
-* Python 3.8 through 3.12, and 3.13.0rc1, including free-threading.
-* PyPy3 versions 3.8 through 3.10.
+* Python 3.9 through 3.12, and 3.13.0rc2, including free-threading.
+* PyPy3 versions 3.9 and 3.10.
 
 .. ifconfig:: prerelease
 

setup.py

@@ -23,7 +23,6 @@
 Operating System :: OS Independent
 Programming Language :: Python
 Programming Language :: Python :: 3
-Programming Language :: Python :: 3.8
 Programming Language :: Python :: 3.9
 Programming Language :: Python :: 3.10
 Programming Language :: Python :: 3.11
@@ -120,7 +119,7 @@
         "Mastodon": "https://hachyderm.io/@coveragepy",
         "Mastodon (nedbat)": "https://hachyderm.io/@nedbat",
     },
-    python_requires=">=3.8",  # minimum of PYVERSIONS
+    python_requires=">=3.9",  # minimum of PYVERSIONS
 )
 
 # A replacement for the build_ext command which raises a single exception

tests/test_arcs.py

@@ -1544,10 +1544,6 @@ def test_if_debug(self) -> None:
             branchz_missing=branchz_missing,
         )
 
-    @pytest.mark.xfail(
-        env.PYPY and env.PYVERSION[:2] == (3, 8) and env.PYPYVERSION >= (7, 3, 11),
-        reason="https://foss.heptapod.net/pypy/pypy/-/issues/3882",
-    )
     def test_if_not_debug(self) -> None:
         if env.PYBEHAVIOR.optimize_if_not_debug == 1:
             branchz = "23 28 34 37"

tests/test_html.py

@@ -806,10 +806,6 @@ def test_a(self) -> None:
             '<td class="right" data-ratio="2 3">67%</td>',
         )
 
-    @pytest.mark.skipif(
-        env.PYPY and env.PYVERSION[:2] == (3, 8),
-        reason="PyPy 3.8 produces different results!?",
-    )
     def test_b_branch(self) -> None:
         self.make_file("b.py", """\
             def one(x):

tests/test_parser.py

@@ -725,10 +725,6 @@ def g():
         assert parser.raw_statements == raw_statements
         assert parser.statements == set()
 
-    @pytest.mark.xfail(
-        env.PYPY and env.PYVERSION[:2] == (3, 8),
-        reason="AST doesn't mark end of classes correctly",
-    )
     def test_class_decorator_pragmas(self) -> None:
         parser = self.parse_text("""\
             class Foo(object):

tox.ini

@@ -4,7 +4,7 @@
 [tox]
 # When changing this list, be sure to check the [gh] list below.
 # PYVERSIONS
-envlist = py3{8,9,10,11,12,13}, pypy3, doc, lint, mypy
+envlist = py3{9,10,11,12,13}, pypy3, doc, lint, mypy
 skip_missing_interpreters = {env:COVERAGE_SKIP_MISSING_INTERPRETERS:True}
 toxworkdir = {env:TOXWORKDIR:.tox}
 
@@ -18,15 +18,15 @@ extras =
 deps =
     -r requirements/pip.pip
     -r requirements/pytest.pip
-    py3{8,9,10,11}: -r requirements/light-threads.pip
+    py3{9,10,11}: -r requirements/light-threads.pip
 
 # Windows can't update the pip version with pip running, so use Python
 # to install things.
 install_command = python -m pip install -U {opts} {packages}
 
 passenv = *
 setenv =
-    pypy3{,8,9,10}: COVERAGE_TEST_CORES=pytrace
+    pypy3{,9,10}: COVERAGE_TEST_CORES=pytrace
     # For some tests, we need .pyc files written in the current directory,
     # so override any local setting.
     PYTHONPYCACHEPREFIX=
@@ -84,7 +84,7 @@ commands =
 
 [testenv:lint]
 # Minimum of PYVERSIONS
-basepython = python3.8
+basepython = python3.9
 deps =
     -r requirements/dev.pip
 
@@ -105,7 +105,7 @@ commands =
     twine check dist/*
 
 [testenv:mypy]
-basepython = python3.8
+basepython = python3.9
 
 deps =
     -r requirements/mypy.pip
@@ -116,14 +116,13 @@ setenv =
 
 commands =
     # PYVERSIONS
-    mypy --python-version=3.8 --exclude=sysmon {env:TYPEABLE}
+    mypy --python-version=3.9 --exclude=sysmon {env:TYPEABLE}
     mypy --python-version=3.12 {env:TYPEABLE}
 
 [gh]
 # https://pypi.org/project/tox-gh/
 # PYVERSIONS
 python =
-    3.8 = py38
     3.9 = py39
     3.10 = py310
     3.11 = py311