Add support for Python 3.12 🚀

filters/__init__.py

@@ -1,7 +1,7 @@
-# http://stackoverflow.com/a/2073599/
-from pkg_resources import require
-__version__ = require('phx-filters')[0].version
-del require
+from importlib.metadata import distribution
+
+__version__ = distribution('phx-filters').version
+del distribution
 
 # Make the base filters accessible from the top level of the package.
 # Note that the order is important here, due to dependencies.

filters/extensions.py

@@ -1,10 +1,10 @@
 import typing
+from importlib.metadata import EntryPoint, entry_points
 from inspect import getmembers as get_members, isabstract as is_abstract, \
     isclass as is_class, ismodule as is_module
 from logging import getLogger
 
 from class_registry import EntryPointClassRegistry
-from pkg_resources import EntryPoint, iter_entry_points
 
 from filters.base import BaseFilter
 
@@ -49,6 +49,11 @@ def __init__(self, group: str = GROUP_NAME) -> None:
         super().__init__(group)
 
     def __getattr__(self, item: str) -> typing.Type[BaseFilter]:
+        """
+        Provides attr-like interface for accessing extension filters (the
+        default interface for class registries is to access items rather than
+        attributes).
+        """
         return self[item]
 
     def __repr__(self):
@@ -58,8 +63,7 @@ def _get_cache(self) -> typing.Dict[str, typing.Type[BaseFilter]]:
         if self._cache is None:
             self._cache = {}
 
-            for target in iter_entry_points(
-                    self.group):  # type: EntryPoint
+            for target in entry_points(group=self.group):  # type: EntryPoint
                 filter_ = target.load()
 
                 ift_result = is_filter_type(filter_)

test/helper.py

@@ -0,0 +1,41 @@
+import sys
+from importlib.metadata import DistributionFinder, PathDistribution
+from os import path
+from pathlib import Path
+
+
+class DummyDistributionFinder(DistributionFinder):
+    """
+    Injects a dummy distribution into the meta path finder, so that we can
+    pretend like it's been pip installed during unit tests (i.e., so that we
+    can test ``EntryPointsClassRegistry``), without polluting the persistent
+    virtualenv.
+    """
+
+    DUMMY_PACKAGE_DIR = 'filter_extension.egg-info'
+
+    @classmethod
+    def install(cls):
+        for finder in sys.meta_path:
+            if isinstance(finder, cls):
+                # If we've already installed an instance of the class, then
+                # something is probably wrong with our tests.
+                raise ValueError(f'{cls.__name__} is already installed')
+
+        sys.meta_path.append(cls())
+
+    @classmethod
+    def uninstall(cls):
+        for i, finder in enumerate(sys.meta_path):
+            if isinstance(finder, cls):
+                sys.meta_path.pop(i)
+                return
+        else:
+            # If we didn't find an installed instance of the class, then
+            # something is probably wrong with our tests.
+            raise ValueError(f'{cls.__name__} was not installed')
+
+    def find_distributions(self, context=...) -> list[PathDistribution]:
+        return [PathDistribution(
+            Path(path.join(path.dirname(__file__), self.DUMMY_PACKAGE_DIR))
+        )]

test/test_extensions.py

@@ -1,23 +1,18 @@
-from os.path import dirname
 from unittest import TestCase
 
-from pkg_resources import working_set
-
 from filters.extensions import FilterExtensionRegistry
 from filters.macros import FilterMacroType
 from test import TestFilterAlpha, TestFilterBravo
+from test.helper import DummyDistributionFinder
 
 
 def setUpModule():
-    #
-    # Install a fake distribution that we can use to inject entry
-    # points at runtime.
-    #
-    # The side effects from this are pretty severe, but they (very
-    # probably) only impact this test, and they are undone as soon as
-    # the process terminates.
-    #
-    working_set.add_entry(dirname(__file__))
+    # Inject a distribution that defines some entry points.
+    DummyDistributionFinder.install()
+
+
+def tearDownModule():
+    DummyDistributionFinder.uninstall()
 
 
 class FilterExtensionRegistryTestCase(TestCase):

test/test_string.py

@@ -1290,7 +1290,7 @@ def test_fail_no_match(self):
 
     def test_pass_unicode_character_class(self):
         """
-        By default, character classes like ``\w`` will take unicode into
+        By default, character classes like ``\\w`` will take unicode into
         account.
         """
         # "Hi, there!" in Japanese, according to the internet :innocent:
@@ -1382,7 +1382,7 @@ def test_pass_pattern_split(self):
         You can also use a regex to split the string.
         """
         self.assertFilterPasses(
-            self._filter('foo-12-bar-34-baz', pattern='[-\d]+'),
+            self._filter('foo-12-bar-34-baz', pattern=r'[-\d]+'),
             ['foo', 'bar', 'baz'],
         )
 
@@ -1393,7 +1393,7 @@ def test_pass_pattern_split_with_groups(self):
         """
         self.assertFilterPasses(
             # Note grouping parentheses in the regex.
-            self._filter('foo-12-bar-34-baz', pattern='([-\d]+)'),
+            self._filter('foo-12-bar-34-baz', pattern=r'([-\d]+)'),
             ['foo', '-12-', 'bar', '-34-', 'baz'],
         )
 
@@ -1405,7 +1405,7 @@ def test_pass_no_split(self):
         parts.
         """
         self.assertFilterPasses(
-            self._filter('foo:bar:baz', pattern='[-\d]+'),
+            self._filter('foo:bar:baz', pattern=r'[-\d]+'),
             ['foo:bar:baz'],
         )
 
@@ -1659,7 +1659,7 @@ def test_pass_curly_hex(self):
         """
         You can include curly braces around hex values.
 
-        Use ``Regex(r'^[\da-f]+$') | Uuid`` if you only want to allow plain
+        Use ``Regex(r'^[\\da-f]+$') | Uuid`` if you only want to allow plain
         hex.
         """
         filtered = self._filter('{54d6ebf8a3f55ed59becdedfb3b0773f}')
@@ -1678,7 +1678,7 @@ def test_pass_urn(self):
         antiquated, but still valid.
 
         If you want to prohibit URNs, chain this filter with
-        ``Regex(r'^[\da-f]+$')``.
+        ``Regex(r'^[\\da-f]+$')``.
 
         References:
 
@@ -1764,7 +1764,7 @@ def test_pass_unicode(self):
         """
         The incoming value is a unicode.
         """
-        self.assertFilterPasses('┻━┻︵ \(°□°)/ ︵ ┻━┻ ')  # RAWR!
+        self.assertFilterPasses(r'┻━┻︵ \(°□°)/ ︵ ┻━┻ ')  # RAWR!
 
     def test_pass_bytes_utf8(self):
         """

tox.ini

@@ -1,5 +1,5 @@
 [tox]
-envlist = py3{11,10,9}
+envlist = py3{12,11,10}
 
 [testenv]
 commands = python -m unittest