Add support for Python 3.12 (#859)

* Update docs to match supported versions

* Add support for Python 3.12

* Add colour to CI logs for readability

* Also test PRs and add manual trigger

.github/workflows/python-build.yml

@@ -1,19 +1,21 @@
 name: Python Tests
 run-name: Run Tests by ${{ github.actor }}
-on: [push]
+on: [push, pull_request, workflow_dispatch]
 jobs:
   tests:
     env:
+      FORCE_COLOR: 1
       GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
     strategy:
       matrix:
-        python: ["3.8", "3.9", "3.10", "3.11"]
+        python: ["3.8", "3.9", "3.10", "3.11", "3.12"]
     runs-on: ubuntu-latest
     steps:
       - name: Set up Python ${{ matrix.python }}
         uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python }}
+          allow-prereleases: true
       - name: Check out repository code
         uses: actions/checkout@v3
       - name: Install prereq

docs/contributing.rst

@@ -152,7 +152,7 @@ request that fails this test suite will be **rejected**.
 Testing multiple versions of Python
 -----------------------------------
 
-OAuthLib supports Python 3.5, 3.6, 3.7 and PyPy 2.7 & PyPy 3. Testing
+OAuthLib supports Python 3.6+ and PyPy3. Testing
 all versions conveniently can be done using `Tox`_.
 
 .. sourcecode:: bash

setup.py

@@ -58,6 +58,7 @@ def fread(fn):
         'Programming Language :: Python :: 3.9',
         'Programming Language :: Python :: 3.10',
         'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
         'Programming Language :: Python :: 3 :: Only',
         'Programming Language :: Python :: Implementation',
         'Programming Language :: Python :: Implementation :: CPython',

tox.ini

@@ -1,6 +1,6 @@
 # require tox>=4
 [tox]
-envlist = py38,py39,py310,py311,pypy3,docs,readme,bandit,isort
+envlist = py38,py39,py310,py311,py312,pypy3,docs,readme,bandit,isort
 
 [testenv]
 deps=