Drop support for Python 3.8 (#1628)

dukecat0 · web-flow · commit 4546189bbb61 · 2025-05-05T22:57:38.000+08:00
* Drop support for Python 3.8

* Remove package list
diff --git a/.github/workflows/bump-changelog.yml b/.github/workflows/bump-changelog.yml
@@ -13,7 +13,7 @@ concurrency:
 
 env:
   default-python: "3.12"
-  minimum-supported-python: "3.8"
+  minimum-supported-python: "3.9"
 
 jobs:
   bump-changelog:
diff --git a/.github/workflows/create_tests_package_lists.yml b/.github/workflows/create_tests_package_lists.yml
@@ -11,7 +11,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        python-version: ["3.12", "3.11", "3.10", "3.9", "3.8"]
+        python-version: ["3.12", "3.11", "3.10", "3.9"]
         include:
           - os: macos-latest
             python-version: "3.12"
diff --git a/.github/workflows/exhaustive_package_test.yml b/.github/workflows/exhaustive_package_test.yml
@@ -12,7 +12,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        python-version: ["3.12", "3.11", "3.10", "3.9", "3.8"]
+        python-version: ["3.12", "3.11", "3.10", "3.9"]
 
     steps:
       - uses: actions/checkout@v4
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -16,7 +16,7 @@ concurrency:
 
 env:
   default-python: "3.12"
-  minimum-supported-python: "3.8"
+  minimum-supported-python: "3.9"
 
 jobs:
   create-tag:
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
@@ -14,7 +14,7 @@ concurrency:
 
 env:
   default-python: "3.12"
-  minimum-supported-python: "3.8"
+  minimum-supported-python: "3.9"
 
 jobs:
   tests:
@@ -23,7 +23,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest]
-        python-version: ["3.12", "3.11", "3.10", "3.9", "3.8"]
+        python-version: ["3.12", "3.11", "3.10", "3.9"]
         include:
           - os: windows-latest
             python-version: "3.12"
diff --git a/docs/README.md b/docs/README.md
@@ -118,7 +118,7 @@ Upgrade pipx with `py -m pip install --user --upgrade pipx`.
 ### Using pipx without installing (via zipapp)
 
 You can also use pipx without installing it. The zipapp can be downloaded from
-[Github releases](https://github.com/pypa/pipx/releases) and you can invoke it with a Python 3.8+ interpreter:
+[Github releases](https://github.com/pypa/pipx/releases) and you can invoke it with a Python 3.9+ interpreter:
 
 ```
 python pipx.pyz ensurepath
diff --git a/docs/comparisons.md b/docs/comparisons.md
@@ -125,7 +125,7 @@ Similarities:
 
 pae advantages:
 
-- Supports all versions of Python from 2.7 upward. pipx requires ≥3.8.
+- Supports all versions of Python from 2.7 upward. pipx requires ≥3.9.
 - Fewer dependencies. (See the detailed comparison for more information.)
 - Easier to have multiple versions of a single program and/or use different Python versions for a single program.
 - Somewhat more convenient for running arbitrary command-line programs in virtual environments, installing multiple packages in a single environment, and activating virtual environments.
diff --git a/docs/contributing.md b/docs/contributing.md
@@ -131,13 +131,13 @@ nox -s tests-3.12
 > You can run a specific unit test by passing arguments to pytest, the test runner pipx uses:
 >
 > ```
-> nox -s tests-3.8 -- -k EXPRESSION
+> nox -s tests-3.9 -- -k EXPRESSION
 > ```
 >
 > `EXPRESSION` can be a test name, such as
 >
 > ```
-> nox -s tests-3.8 -- -k test_uninstall
+> nox -s tests-3.9 -- -k test_uninstall
 > ```
 >
 > Coverage errors can usually be ignored when only running a subset of tests.
diff --git a/docs/installation.md b/docs/installation.md
@@ -1,6 +1,6 @@
 ## System Requirements
 
-python 3.8+ is required to install pipx. pipx can run binaries from packages with Python 3.3+. Don't have Python 3.8 or
+python 3.9+ is required to install pipx. pipx can run binaries from packages with Python 3.3+. Don't have Python 3.9 or
 later? See [Python 3 Installation & Setup Guide](https://realpython.com/installing-python/).
 
 You also need to have `pip` installed on your machine for `python3`. Installing it varies from system to system. Consult
@@ -116,7 +116,7 @@ terminal session and verify `pipx` does run.
 ### Using pipx without installing (via zipapp)
 
 The zipapp can be downloaded from [Github releases](https://github.com/pypa/pipx/releases) and you can invoke it with a
-Python 3.8+ interpreter:
+Python 3.9+ interpreter:
 
 ```
 python pipx.pyz ensurepath
diff --git a/pyproject.toml b/pyproject.toml
@@ -20,13 +20,12 @@ license = "MIT"
 authors = [
   { name = "Chad Smith", email = "chadsmith.software@gmail.com" },
 ]
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 classifiers = [
   "License :: OSI Approved :: MIT License",
   "Operating System :: OS Independent",
   "Programming Language :: Python",
   "Programming Language :: Python :: 3 :: Only",
-  "Programming Language :: Python :: 3.8",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
diff --git a/src/pipx/__init__.py b/src/pipx/__init__.py
@@ -1,4 +1,4 @@
 import sys
 
-if sys.version_info < (3, 8, 0):
-    sys.exit("Python 3.8 or later is required. See https://github.com/pypa/pipx for installation instructions.")
+if sys.version_info < (3, 9, 0):
+    sys.exit("Python 3.9 or later is required. See https://github.com/pypa/pipx for installation instructions.")
diff --git a/src/pipx/constants.py b/src/pipx/constants.py
@@ -6,7 +6,7 @@
 
 PIPX_SHARED_PTH = "pipx_shared.pth"
 TEMP_VENV_EXPIRATION_THRESHOLD_DAYS = 14
-MINIMUM_PYTHON_VERSION = "3.8"
+MINIMUM_PYTHON_VERSION = "3.9"
 MAN_SECTIONS = ["man%d" % i for i in range(1, 10)]
 FETCH_MISSING_PYTHON = os.environ.get("PIPX_FETCH_MISSING_PYTHON", False)
 
diff --git a/src/pipx/util.py b/src/pipx/util.py
@@ -425,9 +425,4 @@ def pipx_wrap(text: str, subsequent_indent: str = "", keep_newlines: bool = Fals
 
 
 def is_paths_relative(path: Path, parent: Path):
-    # Can be replaced with path.is_relative_to() if support for python3.8 is dropped
-    try:
-        path.resolve().relative_to(parent.resolve())
-    except ValueError:
-        return False
-    return True
+    return path.is_relative_to(parent)
diff --git a/testdata/empty_project/pyproject.toml b/testdata/empty_project/pyproject.toml
@@ -12,10 +12,9 @@ description = "Empty Python Project"
 authors = [
   { name = "My Name", email = "me@example.com" },
 ]
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 classifiers = [
   "Programming Language :: Python :: 3 :: Only",
-  "Programming Language :: Python :: 3.8",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
diff --git a/testdata/tests_packages/unix-python3.8.txt b/testdata/tests_packages/unix-python3.8.txt

Original file line number	Diff line number	Diff line change
`@@ -131,13 +131,13 @@ nox -s tests-3.12`
`131`	`131`	`> You can run a specific unit test by passing arguments to pytest, the test runner pipx uses:`
`132`	`132`	`>`
`133`	`133`	> ```
`134`		`-> nox -s tests-3.8 -- -k EXPRESSION`
	`134`	`+> nox -s tests-3.9 -- -k EXPRESSION`
`135`	`135`	> ```
`136`	`136`	`>`
`137`	`137`	> `EXPRESSION` can be a test name, such as
`138`	`138`	`>`
`139`	`139`	> ```
`140`		`-> nox -s tests-3.8 -- -k test_uninstall`
	`140`	`+> nox -s tests-3.9 -- -k test_uninstall`
`141`	`141`	> ```
`142`	`142`	`>`
`143`	`143`	`> Coverage errors can usually be ignored when only running a subset of tests.`