Feat: Add support for python 3.13 and drop support for python 3.8

.github/workflows/bump-changelog.yml

@@ -12,8 +12,8 @@ concurrency:
   cancel-in-progress: true
 
 env:
-  default-python: "3.12"
-  minimum-supported-python: "3.8"
+  default-python: "3.13"
+  minimum-supported-python: "3.9"
 
 jobs:
   bump-changelog:

.github/workflows/create_tests_package_lists.yml

@@ -11,12 +11,12 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        python-version: ["3.12", "3.11", "3.10", "3.9", "3.8"]
+        python-version: ["3.13", "3.12", "3.11", "3.10", "3.9"]
         include:
           - os: macos-latest
-            python-version: "3.12"
+            python-version: "3.13"
           - os: windows-latest
-            python-version: "3.12"
+            python-version: "3.13"
     steps:
       - uses: actions/checkout@v4
       - name: Set up Python ${{ matrix.python-version }}

.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.13", "3.12", "3.11", "3.10", "3.9"]
 
     steps:
       - uses: actions/checkout@v4

.github/workflows/release.yml

@@ -15,8 +15,8 @@ concurrency:
   cancel-in-progress: true
 
 env:
-  default-python: "3.12"
-  minimum-supported-python: "3.8"
+  default-python: "3.13"
+  minimum-supported-python: "3.9"
 
 jobs:
   create-tag:

.github/workflows/tests.yml

@@ -13,8 +13,8 @@ concurrency:
   cancel-in-progress: true
 
 env:
-  default-python: "3.12"
-  minimum-supported-python: "3.8"
+  default-python: "3.13"
+  minimum-supported-python: "3.9"
 
 jobs:
   tests:
@@ -23,12 +23,12 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest]
-        python-version: ["3.12", "3.11", "3.10", "3.9", "3.8"]
+        python-version: ["3.13", "3.12", "3.11", "3.10", "3.9"]
         include:
           - os: windows-latest
-            python-version: "3.12"
+            python-version: "3.13"
           - os: macos-latest
-            python-version: "3.12"
+            python-version: "3.13"
 
     steps:
       - uses: actions/checkout@v4

.pre-commit-config.yaml

@@ -7,7 +7,7 @@ repos:
   - id: trailing-whitespace
   - id: check-yaml
 - repo: https://github.com/tox-dev/pyproject-fmt
-  rev: "2.2.4"
+  rev: "v2.5.0"
   hooks:
     - id: pyproject-fmt
 - repo: https://github.com/astral-sh/ruff-pre-commit

changelog.d/1598.feature.md

@@ -0,0 +1 @@
+Added support for Python 3.13 and dropped support for Python 3.8. pipx now requires Python 3.9 or newer.

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

noxfile.py

@@ -5,8 +5,8 @@
 
 import nox
 
-PYTHON_ALL_VERSIONS = ["3.12", "3.11", "3.10", "3.9", "3.8"]
-PYTHON_DEFAULT_VERSION = "3.12"
+PYTHON_ALL_VERSIONS = ["3.13", "3.12", "3.11", "3.10", "3.9"]
+PYTHON_DEFAULT_VERSION = "3.13"
 DOC_DEPENDENCIES = [
     "jinja2",
     "mkdocs",

pyproject.toml

@@ -20,17 +20,17 @@ license = "MIT"
 authors = [
   { name = "Chad Smith", email = "[email protected]" },
 ]
-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",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
 ]
 dynamic = [
   "version",
@@ -41,7 +41,7 @@ dependencies = [
   "packaging>=20",
   "platformdirs>=2.1",
   "tomli; python_version<'3.11'",
-  "userpath!=1.9,>=1.6",
+  "userpath>=1.6,!=1.9",
 ]
 urls."Bug Tracker" = "https://github.com/pypa/pipx/issues"
 urls.Documentation = "https://pipx.pypa.io"

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.")

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)
 

testdata/empty_project/pyproject.toml

@@ -12,14 +12,14 @@ description = "Empty Python Project"
 authors = [
   { name = "My Name", email = "[email protected]" },
 ]
-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",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
 ]
 scripts.empty-project = "empty_project.main:cli"
 entry-points."pipx.run".empty-project = "empty_project.main:cli"