feat: Support Python 3.12

* Replace the use of pkg_resources (from setuptools, which is
  no longer included in virtual environments as of 3.12) with
  importlib.metadata and importlib_resources.

* Add Python 3.12 to the test matrix.

.github/workflows/tox.yml

@@ -14,6 +14,7 @@ jobs:
           - 3.9
           - "3.10"
           - 3.11
+          - 3.12
 
     steps:
     - name: Check out code

CHANGELOG.md

@@ -1,3 +1,7 @@
+## Unreleased
+
+* [Enhancement] Support Python 3.12.
+
 ## Version 2.4.0 (2024-03-13)
 
 * [Enhancement] Make the location and revision of the webhook-receiver application repository configurable.

tox.ini

@@ -1,12 +1,13 @@
 [tox]
-envlist = gitlint,py{38,39,310,311},flake8
+envlist = gitlint,py{38,39,310,311,312},flake8
 
 [gh-actions]
 python =
     3.8: gitlint,py38,flake8
     3.9: gitlint,py39,flake8
     3.10: gitlint,py310,flake8
     3.11: gitlint,py311,flake8
+    3.12: gitlint,py312,flake8
 
 [flake8]
 ignore = E124,W504

tutorwebhookreceiver/__about__.py

@@ -1,9 +1,8 @@
-import pkg_resources
+from importlib import metadata
 # __version__ attribute as suggested by (deferred) PEP 396:
 # https://www.python.org/dev/peps/pep-0396/
 #
 # Single-source package definition as suggested (among several
 # options) by:
 # https://packaging.python.org/guides/single-sourcing-package-version/
-__version__ = pkg_resources.get_distribution(
-    'tutor-contrib-webhook-receiver').version
+__version__ = metadata.version('tutor-contrib-webhook-receiver')

tutorwebhookreceiver/plugin.py

@@ -1,7 +1,10 @@
 from .__about__ import __version__
 from glob import glob
 import os
-import pkg_resources
+# When Tutor drops support for Python 3.8, we'll need to update this to:
+# from importlib import resources as importlib_resources
+# See: https://github.com/overhangio/tutor/issues/966#issuecomment-1938681102
+import importlib_resources
 from tutor import hooks
 
 
@@ -33,8 +36,8 @@
 }
 
 for service in ["mysql", "lms", "webhookreceiver"]:
-    path = pkg_resources.resource_filename(
-        "tutorwebhookreceiver", os.path.join(
+    path = str(
+        importlib_resources.files("tutorwebhookreceiver") / os.path.join(
             "templates", "webhookreceiver", "tasks", service, "init")
     )
     with open(path, encoding="utf-8") as task_file:
@@ -59,7 +62,7 @@
 
 # Add the "templates" folder as a template root
 hooks.Filters.ENV_TEMPLATE_ROOTS.add_item(
-    pkg_resources.resource_filename("tutorwebhookreceiver", "templates")
+    str(importlib_resources.files("tutorwebhookreceiver") / "templates")
 )
 # Render the "build" and "apps" folders
 hooks.Filters.ENV_TEMPLATE_TARGETS.add_items(
@@ -69,12 +72,9 @@
     ],
 )
 # Load patches from files
-for path in glob(
-    os.path.join(
-        pkg_resources.resource_filename("tutorwebhookreceiver", "patches"),
-        "*",
-    )
-):
+for path in glob(str(
+        importlib_resources.files("tutorwebhookreceiver") / "patches" / "*")):
+
     with open(path, encoding="utf-8") as patch_file:
         hooks.Filters.ENV_PATCHES.add_item(
             (os.path.basename(path), patch_file.read())