Skip to contentSkip to conversation

Drop support for Python 3.8

PATCH In review Thomas Huth 6 participants 11 messages Apr 25, 2025 – May 7, 2025

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Drop support for Python 3.8

From: Thomas Huth <[email protected]>

Python 3.8 went "end of life" in October 2024 and Fedora 42 dropped this version already, so the "python" CI job is currently failing. Thus it's time to drop support for this Python version in QEMU, too.

---
This is an alternative suggestion to:
https://lore.kernel.org/qemu-devel/[email protected]/

 docs/about/build-platforms.rst         |  2 +-
 configure                              | 14 +++++++-------
 python/Makefile                        |  8 ++++----
 python/setup.cfg                       |  7 +++----
 python/tests/minreqs.txt               |  2 +-
 scripts/qapi/mypy.ini                  |  2 +-
 tests/docker/dockerfiles/python.docker |  1 -
 7 files changed, 17 insertions(+), 19 deletions(-)
docs/about/build-platforms.rst +1 -1
index 52521552c8a..c3651871d20 100644
@@ -101,7 +101,7 @@ Python runtime
   option of the ``configure`` script to point QEMU to a supported
   version of the Python runtime.
 
-  As of QEMU |version|, the minimum supported version of Python is 3.8.
+  As of QEMU |version|, the minimum supported version of Python is 3.9.
 
 Python build dependencies
   Some of QEMU's build dependencies are written in Python.  Usually these
configure +7 -7
index 000309cf610..40705afdf57 100755
@@ -540,17 +540,17 @@ if test -n "$linux_arch" && ! test -d "$source_path/linux-headers/asm-$linux_arc
 fi
 
 check_py_version() {
-    # We require python >= 3.8.
+    # We require python >= 3.9.
     # NB: a True python conditional creates a non-zero return code (Failure)
-    "$1" -c 'import sys; sys.exit(sys.version_info < (3,8))'
+    "$1" -c 'import sys; sys.exit(sys.version_info < (3,9))'
 }
 
 first_python=
 if test -z "${PYTHON}"; then
     # A bare 'python' is traditionally python 2.x, but some distros
     # have it as python 3.x, so check in both places.
-    for binary in python3 python python3.12 python3.11 \
-                          python3.10 python3.9 python3.8; do
+    for binary in python3 python python3.13 python3.12 python3.11 \
+                          python3.10 python3.9 ; do
         if has "$binary"; then
             python=$(command -v "$binary")
             if check_py_version "$python"; then
@@ -933,7 +933,7 @@ then
     # If first_python is set, there was a binary somewhere even though
     # it was not suitable.  Use it for the error message.
     if test -n "$first_python"; then
-        error_exit "Cannot use '$first_python', Python >= 3.8 is required." \
+        error_exit "Cannot use '$first_python', Python >= 3.9 is required." \
             "Use --python=/path/to/python to specify a supported Python."
     else
         error_exit "Python not found. Use --python=/path/to/python"
@@ -941,11 +941,11 @@ then
 fi
 
 if ! check_py_version "$python"; then
-  error_exit "Cannot use '$python', Python >= 3.8 is required." \
+  error_exit "Cannot use '$python', Python >= 3.9 is required." \
              "Use --python=/path/to/python to specify a supported Python." \
              "Maybe try:" \
              "  openSUSE Leap 15.3+: zypper install python39" \
-             "  CentOS 8: dnf install python38"
+             "  CentOS: dnf install python3.12"
 fi
 
 # Resolve PATH
python/Makefile +4 -4
index 1fa4ba2498e..764b79ccb23 100644
@@ -9,13 +9,13 @@ help:
 	@echo "make check-minreqs:"
 	@echo "    Run tests in the minreqs virtual environment."
 	@echo "    These tests use the oldest dependencies."
-	@echo "    Requires: Python 3.8"
-	@echo "    Hint (Fedora): 'sudo dnf install python3.8'"
+	@echo "    Requires: Python 3.9"
+	@echo "    Hint (Fedora): 'sudo dnf install python3.9'"
 	@echo ""
 	@echo "make check-tox:"
 	@echo "    Run tests against multiple python versions."
 	@echo "    These tests use the newest dependencies."
-	@echo "    Requires: Python 3.8 - 3.11, and tox."
+	@echo "    Requires: Python 3.9 - 3.11, and tox."
 	@echo "    Hint (Fedora): 'sudo dnf install python3-tox python3.11'"
 	@echo "    The variable QEMU_TOX_EXTRA_ARGS can be use to pass extra"
 	@echo "    arguments to tox".
@@ -59,7 +59,7 @@ PIP_INSTALL = pip install --disable-pip-version-check
 min-venv: $(QEMU_MINVENV_DIR) $(QEMU_MINVENV_DIR)/bin/activate
 $(QEMU_MINVENV_DIR) $(QEMU_MINVENV_DIR)/bin/activate: setup.cfg tests/minreqs.txt
 	@echo "VENV $(QEMU_MINVENV_DIR)"
-	@python3.8 -m venv $(QEMU_MINVENV_DIR)
+	@python3.9 -m venv $(QEMU_MINVENV_DIR)
 	@(								\
 		echo "ACTIVATE $(QEMU_MINVENV_DIR)";			\
 		. $(QEMU_MINVENV_DIR)/bin/activate;			\
python/setup.cfg +3 -4
index cf5af7e6641..c48dff280a3 100644
@@ -14,7 +14,6 @@ classifiers =
     Natural Language :: English
     Operating System :: OS Independent
     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
@@ -23,7 +22,7 @@ classifiers =
     Typing :: Typed
 
 [options]
-python_requires = >= 3.8
+python_requires = >= 3.9
 packages =
     qemu.qmp
     qemu.machine
@@ -78,7 +77,7 @@ exclude = __pycache__,
 
 [mypy]
 strict = True
-python_version = 3.8
+python_version = 3.9
 warn_unused_configs = True
 namespace_packages = True
 warn_unused_ignores = False
@@ -186,7 +185,7 @@ multi_line_output=3
 # of python available on your system to run this test.
 
 [tox:tox]
-envlist = py38, py39, py310, py311, py312, py313
+envlist = py39, py310, py311, py312, py313
 skip_missing_interpreters = true
 
 [testenv]
python/tests/minreqs.txt +1 -1
index a3f423efd84..6445407ba87 100644
@@ -1,5 +1,5 @@
 # This file lists the ***oldest possible dependencies*** needed to run
-# "make check" successfully under ***Python 3.8***. It is used primarily
+# "make check" successfully under ***Python 3.9***. It is used primarily
 # by GitLab CI to ensure that our stated minimum versions in setup.cfg
 # are truthful and regularly validated.
 #
scripts/qapi/mypy.ini +1 -1
index 8109470a031..c9dbcec2db0 100644
@@ -1,4 +1,4 @@
 [mypy]
 strict = True
 disallow_untyped_calls = False
-python_version = 3.8
+python_version = 3.9
tests/docker/dockerfiles/python.docker +0 -1
index 8f0af9ef25f..59e70a02484 100644
@@ -15,7 +15,6 @@ ENV PACKAGES \
     python3.11 \
     python3.12 \
     python3.13 \
-    python3.8 \
     python3.9
 
 RUN dnf install -y $PACKAGES
Signature · 1 line
2.49.0
Reviewed-by on v1 1/1
#1 lore raw
Quoted 11 lines · Thomas Huth

From: Thomas Huth <[email protected]>

Python 3.8 went "end of life" in October 2024 and Fedora 42 dropped this version already, so the "python" CI job is currently failing. Thus it's time to drop support for this Python version in QEMU, too.

---
This is an alternative suggestion to:
https://lore.kernel.org/qemu-devel/[email protected]/

Quoted 8 lines
 docs/about/build-platforms.rst         |  2 +-
 configure                              | 14 +++++++-------
 python/Makefile                        |  8 ++++----
 python/setup.cfg                       |  7 +++----
 python/tests/minreqs.txt               |  2 +-
 scripts/qapi/mypy.ini                  |  2 +-
 tests/docker/dockerfiles/python.docker |  1 -
 7 files changed, 17 insertions(+), 19 deletions(-)

With regards,
Daniel

Signature · 3 lines
|: https://berrange.com      -o-    https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org         -o-            https://fstop138.berrange.com :|
|: https://entangle-photo.org    -o-    https://www.instagram.com/dberrange :|
Reviewed-by on v1 1/1
#2 lore raw
In reply to Thomas Huth

Hi Thomas,

Quoted 24 lines · Thomas Huth

From: Thomas Huth <[email protected]>

Python 3.8 went "end of life" in October 2024 and Fedora 42 dropped this version already, so the "python" CI job is currently failing. Thus it's time to drop support for this Python version in QEMU, too.

---
This is an alternative suggestion to:
https://lore.kernel.org/qemu-devel/[email protected]/

  docs/about/build-platforms.rst         |  2 +-
  configure                              | 14 +++++++-------
  python/Makefile                        |  8 ++++----
  python/setup.cfg                       |  7 +++----
  python/tests/minreqs.txt               |  2 +-
  scripts/qapi/mypy.ini                  |  2 +-
  tests/docker/dockerfiles/python.docker |  1 -
  7 files changed, 17 insertions(+), 19 deletions(-)
  if test -z "${PYTHON}"; then
      # A bare 'python' is traditionally python 2.x, but some distros
      # have it as python 3.x, so check in both places.

configure if test -n "$linux_arch" && ! test -d "$source_path/linux-headers/asm-$linux_arc · line 552

Quoted 3 lines
configure +1 -2
-    for binary in python3 python python3.12 python3.11 \
-                          python3.10 python3.9 python3.8; do
+    for binary in python3 python python3.13 python3.12 python3.11 \

The 3.13 test was missing in commit 45b14be9b63 ("python: enable testing for 3.13"). Preferably adding in a preliminary commit, otherwise mention in this patch description:

Quoted 4 lines

+ python3.10 python3.9 ; do
if has "$binary"; then
python=$(command -v "$binary")
if check_py_version "$python"; then

#3 lore raw
Quoted 28 lines · Philippe Mathieu-Daudé

Hi Thomas,

Quoted 21 lines · Thomas Huth

From: Thomas Huth <[email protected]>
Python 3.8 went "end of life" in October 2024 and Fedora 42 dropped this version already, so the "python" CI job is currently failing. Thus it's time to drop support for this Python version in QEMU, too.

---
This is an alternative suggestion to:
https://lore.kernel.org/qemu-devel/[email protected]/

  docs/about/build-platforms.rst         |  2 +-
  configure                              | 14 +++++++-------
  python/Makefile                        |  8 ++++----
  python/setup.cfg                       |  7 +++----
  python/tests/minreqs.txt               |  2 +-
  scripts/qapi/mypy.ini                  |  2 +-
  tests/docker/dockerfiles/python.docker |  1 -
  7 files changed, 17 insertions(+), 19 deletions(-)
  if test -z "${PYTHON}"; then
      # A bare 'python' is traditionally python 2.x, but some distros
      # have it as python 3.x, so check in both places.

configure if test -n "$linux_arch" && ! test -d "$source_path/linux-headers/asm-$linux_arc · line 552

Quoted 3 lines
configure +1 -2
-    for binary in python3 python python3.12 python3.11 \
-                          python3.10 python3.9 python3.8; do
+    for binary in python3 python python3.13 python3.12 python3.11 \
Quoted 5 lines

The 3.13 test was missing in commit 45b14be9b63 ("python: enable testing for 3.13"). Preferably adding in a preliminary commit, otherwise mention in this patch description:

Yes. The patch looks good to me otherwise. But John knows a lot more about this stuff than I do; would be good to get his blessing.

Quoted 4 lines
Quoted 4 lines

+ python3.10 python3.9 ; do
if has "$binary"; then
python=$(command -v "$binary")
if check_py_version "$python"; then

#4 lore raw

Hi!

Quoted 6 lines · Markus Armbruster
Quoted 5 lines · Philippe Mathieu-Daudé
Quoted 4 lines · Thomas Huth

From: Thomas Huth <[email protected]>
Python 3.8 went "end of life" in October 2024 and Fedora 42 dropped this version already, so the "python" CI job is currently failing. Thus it's time to drop support for this Python version in QEMU, too.

...

Quoted 10 lines
Quoted 10 lines

configure if test -n "$linux_arch" && ! test -d "$source_path/linux-headers/asm-$linux_arc · line 552

Quoted 6 lines
   if test -z "${PYTHON}"; then
       # A bare 'python' is traditionally python 2.x, but some distros
       # have it as python 3.x, so check in both places.
configure +1 -2
-    for binary in python3 python python3.12 python3.11 \
-                          python3.10 python3.9 python3.8; do
+    for binary in python3 python python3.13 python3.12 python3.11 \

The 3.13 test was missing in commit 45b14be9b63 ("python: enable testing for 3.13"). Preferably adding in a preliminary commit, otherwise mention in this patch description

Yes, I'll add a sentence to the patch description!

Quoted 1 line
Quoted 1 line

Thanks!

Quoted 2 lines

Yes. The patch looks good to me otherwise. But John knows a lot more about this stuff than I do; would be good to get his blessing.

Seems like John is currently away from keyboard / busy with other stuff? I think we should go ahead and include this patch to get the CI green again, so I'll add it to my next pull request. If there is still anything that needs to be done on top, it can be done in another patch later.

Thomas

#5 lore raw
Quoted 23 lines · Thomas Huth

Hi!

Quoted 6 lines · Markus Armbruster
Quoted 5 lines · Philippe Mathieu-Daudé
Quoted 4 lines · Thomas Huth

From: Thomas Huth <[email protected]>
Python 3.8 went "end of life" in October 2024 and Fedora 42 dropped this version already, so the "python" CI job is currently failing. Thus it's time to drop support for this Python version in QEMU, too.

...

Quoted 10 lines
Quoted 10 lines

configure if test -n "$linux_arch" && ! test -d "$source_path/linux-headers/asm-$linux_arc · line 552

Quoted 6 lines
   if test -z "${PYTHON}"; then
       # A bare 'python' is traditionally python 2.x, but some distros
       # have it as python 3.x, so check in both places.
configure +1 -2
-    for binary in python3 python python3.12 python3.11 \
-                          python3.10 python3.9 python3.8; do
+    for binary in python3 python python3.13 python3.12 python3.11 \

The 3.13 test was missing in commit 45b14be9b63 ("python: enable testing for 3.13"). Preferably adding in a preliminary commit, otherwise mention in this patch description

Yes, I'll add a sentence to the patch description!

Quoted 8 lines
Quoted 1 line
Quoted 1 line

Thanks!

Quoted 2 lines

Yes. The patch looks good to me otherwise. But John knows a lot more about this stuff than I do; would be good to get his blessing.

Seems like John is currently away from keyboard / busy with other stuff? I think we should go ahead and include this patch to get the CI green again, so I'll add it to my next pull request. If there is still anything that needs to be done on top, it can be done in another patch later.

Makes sense. I assume you'll amend the commit message to address Philippe's review.

#6 lore raw
Quoted 34 lines · Markus Armbruster
Quoted 18 lines · Thomas Huth

Hi!

Quoted 6 lines · Markus Armbruster
Quoted 5 lines · Philippe Mathieu-Daudé
Quoted 4 lines · Thomas Huth

From: Thomas Huth <[email protected]>
Python 3.8 went "end of life" in October 2024 and Fedora 42 dropped this version already, so the "python" CI job is currently failing. Thus it's time to drop support for this Python version in QEMU, too.

...

Quoted 8 lines
Quoted 8 lines

configure if test -n "$linux_arch" && ! test -d "$source_path/linux-headers/asm-$linux_arc · line 552

Quoted 6 lines
   if test -z "${PYTHON}"; then
       # A bare 'python' is traditionally python 2.x, but some distros
       # have it as python 3.x, so check in both places.
configure +1 -2
-    for binary in python3 python python3.12 python3.11 \
-                          python3.10 python3.9 python3.8; do
+    for binary in python3 python python3.13 python3.12 python3.11 \

The 3.13 test was missing in commit 45b14be9b63 ("python: enable

testing

Quoted 1 line
Quoted 1 line
Quoted 1 line

for 3.13"). Preferably adding in a preliminary commit, otherwise

mention

Quoted 11 lines
Quoted 1 line
Quoted 1 line

in this patch description

Yes, I'll add a sentence to the patch description!

Quoted 1 line
Quoted 1 line

Thanks!

Quoted 2 lines

Yes. The patch looks good to me otherwise. But John knows a lot more about this stuff than I do; would be good to get his blessing.

Quoted 7 lines
Quoted 1 line

Seems like John is currently away from keyboard / busy with other stuff?

I think we should go ahead and include this patch to get the CI green again, so I'll add it to my next pull request. If there is still anything that needs to be done on top, it can be done in another patch later.

Makes sense. I assume you'll amend the commit message to address Philippe's review.

Sorry, I was chasing the tail end of Sphinx fixes and fixing up the standalone Python library which had quite a few problems with its CI, and I figured I would then backport all of the various problems I encountered to our CI here; I see you've already been tackling it while I was looking away... sorry!

(Markus tried to warn me ...)

See also:
https://gitlab.com/qemu-project/python-qemu-qmp/-/merge_requests/34
https://gitlab.com/qemu-project/python-qemu-qmp/-/merge_requests/35
https://gitlab.com/gitlab-org/gitlab/-/issues/539290

If there are no objections to moving to 3.9 as the minimum, I certainly don't mind. Go right ahead and I'll clean up afterwards as part of my "delint qapi" series in which I'd like to fix quite a few other things that are currently wonky. In fact, moving to 3.9 as a minimum might make all of that much easier for me and allow deeper cleanings.

--js

#7 lore raw
Quoted 1 line · John Snow

If there are no objections to moving to 3.9 as the minimum, I certainly don't mind. Go right ahead and I'll clean up afterwards as part of my "delint qapi" series in which I'd like to fix quite a few other things that are currently wonky. In fact, moving to 3.9 as a minimum might make all of that much easier for me and allow deeper cleanings.

Out of curiosity what is it that you'd like from 3.9? Based on
https://docs.python.org/3/whatsnew/3.9.html it strikes me as a small release (it has types such as list[str], but then one might as well wait for 3.10's union types).

#8 lore raw
In reply to John Snow

On 06/05/2025 00.49, John Snow wrote:
...

Quoted 1 line

If there are no objections to moving to 3.9 as the minimum, I certainly don't mind. Go right ahead and I'll clean up afterwards as part of my "delint qapi" series in which I'd like to fix quite a few other things that are currently wonky. In fact, moving to 3.9 as a minimum might make all of that much easier for me and allow deeper cleanings.

Hi John!

It has just been merged:

https://gitlab.com/qemu-project/qemu/-/commit/d64db833d6e3cbe9ea5f36342480f9

Do you want me to provide a patch for python-qemu-qmp, too, or will you handle it?

Thomas

#9 lore raw
Quoted 5 lines · Thomas Huth

On 06/05/2025 00.49, John Snow wrote:
...

Quoted 3 lines

If there are no objections to moving to 3.9 as the minimum, I certainly don't mind. Go right ahead and I'll clean up afterwards as part of my "delint qapi" series in which I'd like to fix quite a few other things

Quoted 9 lines

that

Quoted 1 line

are currently wonky. In fact, moving to 3.9 as a minimum might make all

of

Quoted 1 line

that much easier for me and allow deeper cleanings.

Hi John!

It has just been merged:

Yay! Thanks a lot for doing this. I lost my appetite for arguing for Python version bumps, but when other people do it, I am always cheering :) Sorry to have been MIA while you were submitting this.

Quoted 7 lines

https://gitlab.com/qemu-project/qemu/-/commit/d64db833d6e3cbe9ea5f36342480f9

Do you want me to provide a patch for python-qemu-qmp, too, or will you handle it?

I'll handle it - the CI over there was hosed as well and needed some other adjustments that aren't applicable to mainline CI, I got it green again just this morning.

Technically, the standalone QMP package still supports 3.7, because I have a bit tighter control over the dependencies and environments there, which has allowed me to support older versions for longer. It's probably due for a bump now that 3.9 is our minimum, though.

Related: Akihiko is trying to bump the Sphinx version, I want to integrate linting for the QAPI subpackage, Peter Maydell is encountering Sphinx build errors dependent on the version installed, and Daniel wants to integrate python linting into make check - I have to line everything up and make sure it all works at the same time. Hopefully good progress on that by week's end now that I've knocked out the standalone CI issues.

Quoted 2 lines

Thomas

#10 lore raw
Quoted 10 lines · John Snow
Quoted 8 lines · Thomas Huth

On 06/05/2025 00.49, John Snow wrote:
...

Quoted 5 lines

If there are no objections to moving to 3.9 as the minimum, I certainly don't mind. Go right ahead and I'll clean up afterwards as part of my "delint qapi" series in which I'd like to fix quite a few other things that are currently wonky. In fact, moving to 3.9 as a minimum might make all of that much easier for me and allow deeper cleanings.

Quoted 8 lines
Quoted 4 lines

Hi John!

It has just been merged:

Yay! Thanks a lot for doing this. I lost my appetite for arguing for Python version bumps, but when other people do it, I am always cheering :) Sorry to have been MIA while you were submitting this.

I'm cheering, too!

Supporting a wide range of Python versions has been costly. Most recently, it made John write docs/sphinx/compat.py, which looks like every line of code there was bought with blood, sweat, and tears.

[...]