Add support for Wagtail 5.1, 5.2, deprecate <=5.0

This commit adds support for Wagtail 5.1 and 5.2 (LTS) while also
removing support for previous versions.

5.1 deprecates the Wagtail modeladmin package in favor of snippets:

https://docs.wagtail.org/en/stable/releases/5.1.html#wagtail-contrib-modeladmin-is-deprecated

This commit migrates the admin editing implementation of SharingSites
from modeladmin to snippets.

It also fixes a Python unit test impacted by the Wagtail listing view
redesign in 5.2 (commit 29244cf006e49c7c1b27c663b8bd678d2c5e3212):

https://docs.wagtail.org/en/latest/releases/5.2.html#redesigned-page-listing-view

.github/workflows/test.yml

@@ -36,12 +36,7 @@ jobs:
       matrix:
         python: ['3.8', '3.11']
         django: ['3.2', '4.2']
-        wagtail: ['4.1', '5.0']
-        exclude:
-          - django: '4.2'
-            wagtail: '4.1'
-          - python: '3.11'
-            django: '3.2'
+        wagtail: ['5.1', '5.2']
 
     steps:
       - uses: actions/checkout@v3

README.rst

@@ -39,7 +39,7 @@ Add ``wagtailsharing`` as an installed app in your Django settings:
       ...
   )
 
-``wagtail.contrib.modeladmin`` is also required and must be included in your list of installed apps.
+``wagtail.widgets`` is also required and must be included in your list of installed apps.
 
 The code examples below assume that you are using a recent Wagtail version (3.0+).
 
@@ -203,7 +203,7 @@ This project has been tested for compatibility with:
 
 * Python 3.9+
 * Django 3.2+
-* Wagtail 3.0 - 5.0
+* Wagtail 5.1+ (see past releases for older Wagtail support)
 
 It should be compatible with all intermediate versions, as well.
 If you find that it is not, please `file an issue <https://github.com/cfpb/wagtail-sharing/issues/new>`_.

pyproject.toml

@@ -9,15 +9,13 @@ authors = [
     {name = "CFPB", email = "tech@cfpb.gov" }
 ]
 dependencies = [
-    "wagtail>=3",
+    "wagtail>=5.1",
 ]
 classifiers = [
     "Framework :: Django",
     "Framework :: Django :: 3.2",
     "Framework :: Django :: 4.2",
     "Framework :: Wagtail",
-    "Framework :: Wagtail :: 3",
-    "Framework :: Wagtail :: 4",
     "Framework :: Wagtail :: 5",
     "License :: CC0 1.0 Universal (CC0 1.0) Public Domain Dedication",
     "License :: Public Domain",

tox.ini

@@ -2,8 +2,7 @@
 skipsdist=True
 envlist=
     lint,
-    python{3.8}-django{3.2}-wagtail{3.0,4.1,5.0},
-    python{3.8,3.11}-django{4.2}-wagtail{5.0},
+    python{3.8,3.11}-django{3.2,4.2}-wagtail{5.1,5.2},
     coverage
 
 [testenv]
@@ -16,11 +15,8 @@ basepython=
     python3.11: python3.11
 
 deps=
-    django3.2: Django>=3.2,<3.3
-    django4.2: Django>=4.2,<4.3
-    wagtail3.0: wagtail>=3.0,<4.0
-    wagtail4.1: wagtail>=4.1,<4.2
-    wagtail5.0: wagtail>=5.0,<5.1
+    wagtail5.1: wagtail>=5.1,<5.2
+    wagtail5.2: wagtail>=5.2,<5.3
 
 [testenv:lint]
 basepython=python3.8
@@ -59,7 +55,7 @@ sections=FUTURE,STDLIB,DJANGO,WAGTAIL,THIRDPARTY,FIRSTPARTY,LOCALFOLDER
 [testenv:interactive]
 basepython=python3.8
 deps=
-    wagtail>=5.0,<5.1
+    wagtail>=5.2,<5.3
 
 commands_pre=
     python {toxinidir}/testmanage.py makemigrations

wagtailsharing/apps.py

@@ -1,8 +1,6 @@
 from django.apps import AppConfig
 from django.utils.translation import gettext_lazy as _
 
-from . import checks  # noqa F401
-
 
 class WagtailSharingAppConfig(AppConfig):
     name = "wagtailsharing"

wagtailsharing/tests/settings.py

@@ -27,7 +27,6 @@
 
 WAGTAIL_APPS = (
     "wagtail.contrib.forms",
-    "wagtail.contrib.modeladmin",
     "wagtail.contrib.routable_page",
     "wagtail.contrib.settings",
     "wagtail.test.routablepage",
@@ -36,6 +35,7 @@
     "wagtail.documents",
     "wagtail.images",
     "wagtail.sites",
+    "wagtail.snippets",
     "wagtail.users",
 )
 

wagtailsharing/tests/test_wagtail_hooks.py

@@ -34,7 +34,7 @@ def test_link_makes_button(self):
             button = next(links)
             self.assertEqual(button.url, url)
             self.assertIn(
-                self.page.get_admin_display_title(), button.attrs["title"]
+                self.page.get_admin_display_title(), button.attrs["aria-label"]
             )
 
 

wagtailsharing/wagtail_hooks.py

@@ -7,21 +7,22 @@
 
 from wagtail import hooks
 from wagtail.admin import widgets as wagtailadmin_widgets
-from wagtail.contrib.modeladmin.options import ModelAdmin, modeladmin_register
+from wagtail.snippets.models import register_snippet
+from wagtail.snippets.views.snippets import SnippetViewSet
 
 from wagtailsharing.helpers import get_sharing_url
 from wagtailsharing.models import SharingSite
 
 
-class SharingSiteModelAdmin(ModelAdmin):
+class SharingSiteViewSet(SnippetViewSet):
     model = SharingSite
-    menu_icon = "site"
+    icon = "site"
     menu_order = 603
     add_to_settings_menu = True
     list_display = ("site", "hostname", "port")
 
 
-modeladmin_register(SharingSiteModelAdmin)
+register_snippet(SharingSiteViewSet)
 
 
 @hooks.register("register_page_header_buttons")
@@ -35,7 +36,7 @@ def add_sharing_link(page, page_perms, is_parent=False, next_url=None):
             sharing_url,
             icon_name="draft",
             attrs={
-                "title": _("View shared revision of '{}'").format(
+                "aria-label": _("View shared revision of '{}'").format(
                     page.get_admin_display_title()
                 ),
             },