Add nox and tox py312 jobs

Python 3.12 is a thing now and is present in a stable Linux distro
release (Ubuntu Noble). It seems reasonable for people to want to run
nox and tox against py312 targets. Let's make it easy for them and add
jobs to do that for them.

Change-Id: I9d644cfbe65b92207a5fe2ad6dd950093bda87dd

doc/source/python-jobs.rst

@@ -10,6 +10,7 @@ Python Jobs
 .. zuul:autojob:: tox-py39
 .. zuul:autojob:: tox-py310
 .. zuul:autojob:: tox-py311
+.. zuul:autojob:: tox-py312
 .. zuul:autojob:: tox-docs
 .. zuul:autojob:: tox-linters
 .. zuul:autojob:: tox-molecule
@@ -24,6 +25,7 @@ Python Jobs
 .. zuul:autojob:: nox-py39
 .. zuul:autojob:: nox-py310
 .. zuul:autojob:: nox-py311
+.. zuul:autojob:: nox-py312
 .. zuul:autojob:: nox-docs
 .. zuul:autojob:: nox-linters
 .. zuul:autojob:: nox-cover

zuul-tests.d/project.yaml

@@ -12,6 +12,8 @@
             nodeset: ubuntu-jammy
         - tox-py311:
             nodeset: ubuntu-jammy
+        - tox-py312:
+            nodeset: ubuntu-noble
     gate:
       jobs:
         - zuul-tox-docs
@@ -21,6 +23,8 @@
             nodeset: ubuntu-jammy
         - tox-py311:
             nodeset: ubuntu-jammy
+        - tox-py312:
+            nodeset: ubuntu-noble
     promote:
       jobs:
         - zuul-promote-docs

zuul.d/python-jobs.yaml

@@ -203,6 +203,17 @@
       tox_envlist: py311
       python_version: "3.11"
 
+- job:
+    name: tox-py312
+    parent: tox
+    description: |
+      Run unit tests for a Python project under cPython version 3.12.
+
+      Uses tox with the ``py312`` environment.
+    vars:
+      tox_envlist: py312
+      python_version: "3.12"
+
 - job:
     name: tox-docs
     # This is not parented to tox since we do not need
@@ -468,6 +479,18 @@
       nox_force_python: "3.11"
       python_version: "3.11"
 
+- job:
+    name: nox-py312
+    parent: nox
+    description: |
+      Run unit tests for a Python project under cPython version 3.12.
+
+      Uses nox with the ``test`` keyword forcing python 3.12.
+    vars:
+      nox_keyword: tests
+      nox_force_python: "3.12"
+      python_version: "3.12"
+
 - job:
     name: nox-cover
     parent: nox