From 52422170cb72b3776f80bdc18ee04488178fb854 Mon Sep 17 00:00:00 2001
From: Vytautas Liuolia <vytautas.liuolia@gmail.com>
Date: Wed, 10 Apr 2024 13:22:38 +0200
Subject: [PATCH] chore: make CPython 3.12 default CI version (#2227)

* chore: make CPython 3.12 default CI version

* chore(CI): update forgotten Windows, macOS & cov gates

* chore: try codecov v4
---
 .github/workflows/tests.yaml | 22 +++++++++++-----------
 CONTRIBUTING.md              |  2 +-
 docs/changes/4.0.0.rst       |  2 +-
 tox.ini                      | 12 ++++++------
 4 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/.github/workflows/tests.yaml b/.github/workflows/tests.yaml
index 6a0ddbe40..cdb9d9cfd 100644
--- a/.github/workflows/tests.yaml
+++ b/.github/workflows/tests.yaml
@@ -18,7 +18,7 @@ jobs:
       fail-fast: false
       matrix:
         python-version:
-          - "3.10"
+          - "3.12"
         os:
           - "ubuntu-latest"
         toxenv:
@@ -28,9 +28,9 @@ jobs:
           - "pep8-docstrings"
           - "mypy"
           - "mypy_tests"
-          - "py310"
-          - "py310_sans_msgpack"
-          - "py310_cython"
+          - "py312"
+          - "py312_sans_msgpack"
+          - "py312_cython"
           - "docs"
           - "towncrier"
           - "look"
@@ -82,12 +82,12 @@ jobs:
           - python-version: "3.12"
             os: ubuntu-latest
             toxenv: py312_cython
-          - python-version: "3.10"
+          - python-version: "3.12"
             os: macos-latest
-            toxenv: py310_nocover
-          - python-version: "3.10"
+            toxenv: py312_nocover
+          - python-version: "3.12"
             os: windows-latest
-            toxenv: py310_nocover
+            toxenv: py312_nocover
           # These env require 3.8 and 20.04, see tox.ini
           - python-version: "3.8"
             os: ubuntu-20.04
@@ -133,14 +133,14 @@ jobs:
         run: tox -e ${{ matrix.toxenv }}
 
       - name: Combine coverage
-        if: ${{ matrix.toxenv == 'py310' || matrix.toxenv == 'py310_sans_msgpack' }}
+        if: ${{ matrix.toxenv == 'py312' || matrix.toxenv == 'py312_sans_msgpack' }}
         run: |
           coverage --version
           coverage combine
 
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v1
-        if: ${{ matrix.toxenv == 'py310' || matrix.toxenv == 'py310_sans_msgpack' }}
+        uses: codecov/codecov-action@v4
+        if: ${{ matrix.toxenv == 'py312' || matrix.toxenv == 'py312_sans_msgpack' }}
         with:
           env_vars: PYTHON
           fail_ci_if_error: true
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 2e3d8082f..b28054167 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -37,7 +37,7 @@ $ pip install -U blue
 $ blue .
 ```
 
-You can check all this by running ``tox`` from within the Falcon project directory. Your environment must be based on CPython 3.8, 3.10 or 3.11:
+You can check all this by running ``tox`` from within the Falcon project directory. Your environment must be based on CPython 3.8, 3.10, 3.11 or 3.12:
 
 ```bash
 $ pip install -U tox
diff --git a/docs/changes/4.0.0.rst b/docs/changes/4.0.0.rst
index 93359c678..361c17619 100644
--- a/docs/changes/4.0.0.rst
+++ b/docs/changes/4.0.0.rst
@@ -13,7 +13,7 @@ Changes to Supported Platforms
 ------------------------------
 
 - CPython 3.11 is now fully supported. (`#2072 <https://github.com/falconry/falcon/issues/2072>`__)
-- CPython 3.12 will be fully supported. (`#2196 <https://github.com/falconry/falcon/issues/2196>`__)
+- CPython 3.12 is now fully supported. (`#2196 <https://github.com/falconry/falcon/issues/2196>`__)
 - End-of-life Python 3.5 & 3.6 are no longer supported. (`#2074 <https://github.com/falconry/falcon/pull/2074>`__)
 - Python 3.7 is no longer actively supported, but the framework should still
   continue to install from source. We may remove the support for 3.7 altogether
diff --git a/tox.ini b/tox.ini
index 1715258c5..67d9d7c7d 100644
--- a/tox.ini
+++ b/tox.ini
@@ -99,21 +99,21 @@ deps = {[testenv]deps}
 commands = pip uninstall --yes msgpack
            coverage run -m pytest tests -k "test_ws and test_msgpack_missing"
 
-[testenv:py310]
-basepython = python3.10
+[testenv:py312]
+basepython = python3.12
 deps = {[testenv]deps}
        pytest-randomly
        jsonschema
 commands = {[with-coverage]commands}
 
-[testenv:py310_sans_msgpack]
-basepython = python3.10
+[testenv:py312_sans_msgpack]
+basepython = python3.12
 deps = {[testenv]deps}
 commands = pip uninstall --yes msgpack
            coverage run -m pytest tests -k "test_ws and test_msgpack_missing"
 
-[testenv:py310_nocover]
-basepython = python3.10
+[testenv:py312_nocover]
+basepython = python3.12
 deps = {[testenv]deps}
        pytest-randomly
        jsonschema