angrybeanie_wagtail/env/lib/python3.12/site-packages/wagtail/admin/tests/tests.py

555 lines
22 KiB
Python
Raw Permalink Normal View History

2025-07-25 21:32:16 +10:00
import json
import unittest
from django.conf import settings
from django.contrib.auth.models import Group, Permission
from django.core import mail
from django.core.management import call_command
from django.test import TestCase, override_settings
from django.urls import reverse, reverse_lazy
from django.utils.translation import gettext_lazy as _
from taggit.models import Tag
from wagtail.admin.auth import user_has_any_page_permission
from wagtail.admin.mail import send_mail
from wagtail.admin.menu import MenuItem
from wagtail.models import Page
from wagtail.test.testapp.models import RestaurantTag
from wagtail.test.utils import WagtailTestUtils
class TestHome(WagtailTestUtils, TestCase):
def setUp(self):
# Login
self.login()
def test_simple(self):
response = self.client.get(reverse("wagtailadmin_home"))
self.assertEqual(response.status_code, 200)
self.assertContains(response, "Test Site")
def test_accessible_skip_link_exists(self):
response = self.client.get(reverse("wagtailadmin_home"))
self.assertEqual(response.status_code, 200)
soup = self.get_soup(response.content)
# Check that the skip link is present and has the correct attributes
skip_link = soup.select_one(".skiplink")
self.assertIsNotNone(skip_link)
self.assertEqual(skip_link["href"], "#main")
self.assertEqual(skip_link["data-controller"], "w-focus")
self.assertEqual(skip_link["data-action"], "w-focus#focus:prevent")
# Check that the main content area has the correct ID
main_content = soup.select_one("#main")
self.assertIsNotNone(main_content)
def test_admin_menu(self):
response = self.client.get(reverse("wagtailadmin_home"))
self.assertEqual(response.status_code, 200)
# check that custom menu items (including classname / icon_name) are pulled in
self.assertContains(
response,
'{"name": "kittens", "label": "Kittens!", "icon_name": "kitten", "classname": "kitten--test", "attrs": {"data-is-custom": "true"}, "url": "http://www.tomroyal.com/teaandkittens/"}',
)
# Check that the explorer menu item is here, with the right start page.
self.assertContains(
response,
'[{"name": "explorer", "label": "Pages", "icon_name": "folder-open-inverse", "classname": "", "attrs": {}, "url": "/admin/pages/"}, 1]',
)
# There should be a link to the full-featured snippet admin in on the home page.
self.assertContains(response, '"url": "/admin/deep/within/the/admin/"')
# check that is_shown is respected on menu items
response = self.client.get(reverse("wagtailadmin_home") + "?hide-kittens=true")
self.assertNotContains(
response,
'{"name": "kittens", "label": "Kittens!", "icon_name": "kitten", "classname": "kitten--test", "attrs": {"data-is-custom": "true"}, "url": "http://www.tomroyal.com/teaandkittens/"}',
)
def test_dashboard_panels(self):
response = self.client.get(reverse("wagtailadmin_home"))
self.assertEqual(response.status_code, 200)
self.assertContains(
response,
"<p>It looks like you're making a website. Would you like some help?</p>",
)
# check that media attached to dashboard panels is correctly pulled in
self.assertContains(
response, '<script src="/static/testapp/js/clippy.js"></script>', html=True
)
def test_summary_items(self):
response = self.client.get(reverse("wagtailadmin_home"))
self.assertEqual(response.status_code, 200)
self.assertContains(response, "<li>0 broken links</li>")
# check that media attached to summary items is correctly pulled in
self.assertContains(
response,
'<link href="/static/testapp/css/broken-links.css" media="all" rel="stylesheet">',
html=True,
)
def test_never_cache_header(self):
# This tests that wagtailadmins global cache settings have been applied correctly
response = self.client.get(reverse("wagtailadmin_home"))
self.assertIn("no-cache", response["Cache-Control"])
self.assertIn("no-store", response["Cache-Control"])
self.assertIn("max-age=0", response["Cache-Control"])
self.assertIn("must-revalidate", response["Cache-Control"])
@unittest.skipIf(
settings.AUTH_USER_MODEL == "emailuser.EmailUser",
"Only applicable to CustomUser",
)
def test_nonascii_email(self):
# Test that non-ASCII email addresses don't break the admin; previously these would
# cause a failure when generating Gravatar URLs
self.create_superuser(
username="snowman", email="☃@thenorthpole.com", password="password"
)
# Login
self.assertTrue(self.client.login(username="snowman", password="password"))
response = self.client.get(reverse("wagtailadmin_home"))
self.assertEqual(response.status_code, 200)
class TestEditorHooks(WagtailTestUtils, TestCase):
def setUp(self):
self.homepage = Page.objects.get(id=2)
self.login()
def test_editor_css_hooks_on_add(self):
response = self.client.get(
reverse(
"wagtailadmin_pages:add", args=("tests", "simplepage", self.homepage.id)
)
)
self.assertEqual(response.status_code, 200)
self.assertContains(
response, '<link rel="stylesheet" href="/path/to/my/custom.css">'
)
def test_editor_js_hooks_on_add(self):
response = self.client.get(
reverse(
"wagtailadmin_pages:add", args=("tests", "simplepage", self.homepage.id)
)
)
self.assertEqual(response.status_code, 200)
self.assertContains(response, '<script src="/path/to/my/custom.js"></script>')
def test_editor_css_hooks_on_edit(self):
response = self.client.get(
reverse("wagtailadmin_pages:edit", args=(self.homepage.id,))
)
self.assertEqual(response.status_code, 200)
self.assertContains(
response, '<link rel="stylesheet" href="/path/to/my/custom.css">'
)
def test_editor_js_hooks_on_edit(self):
response = self.client.get(
reverse("wagtailadmin_pages:edit", args=(self.homepage.id,))
)
self.assertEqual(response.status_code, 200)
self.assertContains(response, '<script src="/path/to/my/custom.js"></script>')
class TestSendMail(TestCase):
def test_send_email(self):
send_mail(
"Test subject", "Test content", ["nobody@email.com"], "test@email.com"
)
# Check that the email was sent
self.assertEqual(len(mail.outbox), 1)
self.assertEqual(mail.outbox[0].subject, "Test subject")
self.assertEqual(mail.outbox[0].body, "Test content")
self.assertEqual(mail.outbox[0].to, ["nobody@email.com"])
self.assertEqual(mail.outbox[0].from_email, "test@email.com")
@override_settings(WAGTAILADMIN_NOTIFICATION_FROM_EMAIL="anothertest@email.com")
def test_send_fallback_to_wagtailadmin_notification_from_email_setting(self):
send_mail("Test subject", "Test content", ["nobody@email.com"])
# Check that the email was sent
self.assertEqual(len(mail.outbox), 1)
self.assertEqual(mail.outbox[0].subject, "Test subject")
self.assertEqual(mail.outbox[0].body, "Test content")
self.assertEqual(mail.outbox[0].to, ["nobody@email.com"])
self.assertEqual(mail.outbox[0].from_email, "anothertest@email.com")
@override_settings(DEFAULT_FROM_EMAIL="yetanothertest@email.com")
def test_send_fallback_to_default_from_email_setting(self):
send_mail("Test subject", "Test content", ["nobody@email.com"])
# Check that the email was sent
self.assertEqual(len(mail.outbox), 1)
self.assertEqual(mail.outbox[0].subject, "Test subject")
self.assertEqual(mail.outbox[0].body, "Test content")
self.assertEqual(mail.outbox[0].to, ["nobody@email.com"])
self.assertEqual(mail.outbox[0].from_email, "yetanothertest@email.com")
def test_send_default_from_email(self):
send_mail("Test subject", "Test content", ["nobody@email.com"])
# Check that the email was sent
self.assertEqual(len(mail.outbox), 1)
self.assertEqual(mail.outbox[0].subject, "Test subject")
self.assertEqual(mail.outbox[0].body, "Test content")
self.assertEqual(mail.outbox[0].to, ["nobody@email.com"])
self.assertEqual(mail.outbox[0].from_email, "webmaster@localhost")
def test_send_html_email(self):
"""Test that the kwarg 'html_message' works as expected on send_mail by creating 'alternatives' on the EmailMessage object"""
send_mail(
"Test HTML subject",
"TEXT content",
["has.html@email.com"],
html_message="<h2>Test HTML content</h2>",
)
send_mail("Test TEXT subject", "TEXT content", ["mr.plain.text@email.com"])
# Check that the emails were sent
self.assertEqual(len(mail.outbox), 2)
# check that the first email is the HTML email
email_message = mail.outbox[0]
self.assertEqual(email_message.subject, "Test HTML subject")
self.assertEqual(
email_message.alternatives, [("<h2>Test HTML content</h2>", "text/html")]
)
self.assertEqual(
email_message.body, "TEXT content"
) # note: plain text will always be added to body, even with alternatives
self.assertEqual(email_message.to, ["has.html@email.com"])
# confirm that without html_message kwarg we do not get 'alternatives'
email_message = mail.outbox[1]
self.assertEqual(email_message.subject, "Test TEXT subject")
self.assertEqual(email_message.alternatives, [])
self.assertEqual(email_message.body, "TEXT content")
self.assertEqual(email_message.to, ["mr.plain.text@email.com"])
def test_send_cc(self):
send_mail(
"Test subject",
"Test content",
["nobody@email.com"],
"test@email.com",
cc=["cc.test@email.com"],
)
# Check that the email was sent
self.assertEqual(len(mail.outbox), 1)
self.assertEqual(mail.outbox[0].subject, "Test subject")
self.assertEqual(mail.outbox[0].body, "Test content")
self.assertEqual(mail.outbox[0].to, ["nobody@email.com"])
self.assertEqual(mail.outbox[0].from_email, "test@email.com")
self.assertEqual(mail.outbox[0].cc, ["cc.test@email.com"])
def test_send_bcc(self):
send_mail(
"Test subject",
"Test content",
["nobody@email.com"],
"test@email.com",
bcc=["bcc.test@email.com"],
)
# Check that the email was sent
self.assertEqual(len(mail.outbox), 1)
self.assertEqual(mail.outbox[0].subject, "Test subject")
self.assertEqual(mail.outbox[0].body, "Test content")
self.assertEqual(mail.outbox[0].to, ["nobody@email.com"])
self.assertEqual(mail.outbox[0].from_email, "test@email.com")
self.assertEqual(mail.outbox[0].bcc, ["bcc.test@email.com"])
def test_send_reply_to(self):
send_mail(
"Test subject",
"Test content",
["nobody@email.com"],
"test@email.com",
reply_to=["reply_to.test@email.com"],
)
# Check that the email was sent
self.assertEqual(len(mail.outbox), 1)
self.assertEqual(mail.outbox[0].subject, "Test subject")
self.assertEqual(mail.outbox[0].body, "Test content")
self.assertEqual(mail.outbox[0].to, ["nobody@email.com"])
self.assertEqual(mail.outbox[0].from_email, "test@email.com")
self.assertEqual(mail.outbox[0].reply_to, ["reply_to.test@email.com"])
def test_send_all_extra_fields(self):
send_mail(
"Test subject",
"Test content",
["nobody@email.com"],
"test@email.com",
cc=["cc.test@email.com"],
bcc=["bcc.test@email.com"],
reply_to=["reply_to.test@email.com"],
)
# Check that the email was sent
self.assertEqual(len(mail.outbox), 1)
self.assertEqual(mail.outbox[0].subject, "Test subject")
self.assertEqual(mail.outbox[0].body, "Test content")
self.assertEqual(mail.outbox[0].to, ["nobody@email.com"])
self.assertEqual(mail.outbox[0].from_email, "test@email.com")
self.assertEqual(mail.outbox[0].cc, ["cc.test@email.com"])
self.assertEqual(mail.outbox[0].bcc, ["bcc.test@email.com"])
self.assertEqual(mail.outbox[0].reply_to, ["reply_to.test@email.com"])
class TestTagsAutocomplete(WagtailTestUtils, TestCase):
def setUp(self):
self.login()
Tag.objects.create(name="Test", slug="test")
RestaurantTag.objects.create(name="Italian", slug="italian")
RestaurantTag.objects.create(name="Indian", slug="indian")
def test_tags_autocomplete(self):
response = self.client.get(
reverse("wagtailadmin_tag_autocomplete"), {"term": "test"}
)
self.assertEqual(response.status_code, 200)
self.assertEqual(response["Content-Type"], "application/json")
data = json.loads(response.content.decode("utf-8"))
self.assertEqual(data, ["Test"])
def test_tags_autocomplete_partial_match(self):
response = self.client.get(
reverse("wagtailadmin_tag_autocomplete"), {"term": "te"}
)
self.assertEqual(response.status_code, 200)
self.assertEqual(response["Content-Type"], "application/json")
data = json.loads(response.content.decode("utf-8"))
self.assertEqual(data, ["Test"])
def test_tags_autocomplete_different_term(self):
response = self.client.get(
reverse("wagtailadmin_tag_autocomplete"), {"term": "hello"}
)
self.assertEqual(response.status_code, 200)
self.assertEqual(response["Content-Type"], "application/json")
data = json.loads(response.content.decode("utf-8"))
self.assertEqual(data, [])
def test_tags_autocomplete_no_term(self):
response = self.client.get(reverse("wagtailadmin_tag_autocomplete"))
self.assertEqual(response.status_code, 200)
self.assertEqual(response["Content-Type"], "application/json")
data = json.loads(response.content.decode("utf-8"))
self.assertEqual(data, [])
def test_tags_autocomplete_custom_model(self):
response = self.client.get(
reverse(
"wagtailadmin_tag_model_autocomplete", args=("tests", "restauranttag")
),
{"term": "ital"},
)
self.assertEqual(response.status_code, 200)
self.assertEqual(response["Content-Type"], "application/json")
data = json.loads(response.content.decode("utf-8"))
self.assertEqual(data, ["Italian"])
# should not return results from the standard Tag model
response = self.client.get(
reverse(
"wagtailadmin_tag_model_autocomplete", args=("tests", "restauranttag")
),
{"term": "test"},
)
self.assertEqual(response.status_code, 200)
self.assertEqual(response["Content-Type"], "application/json")
data = json.loads(response.content.decode("utf-8"))
self.assertEqual(data, [])
def test_tags_autocomplete_limit(self):
tags = [Tag(name=f"Tag {i}", slug=f"tag-{i}") for i in range(15)]
Tag.objects.bulk_create(tags)
# Send a request to the autocomplete endpoint with a broad search term
response = self.client.get(
reverse("wagtailadmin_tag_autocomplete"), {"term": "Tag"}
)
# Confirm the response is successful
self.assertEqual(response.status_code, 200)
self.assertEqual(response["Content-Type"], "application/json")
data = json.loads(response.content.decode("utf-8"))
# The results should be limited to avoid performance issues (#12415)
self.assertEqual(len(data), 10)
sorted_tags = sorted(tags, key=lambda t: t.name)
self.assertEqual(data, [tag.name for tag in sorted_tags[:10]])
class TestMenuItem(WagtailTestUtils, TestCase):
def setUp(self):
self.login()
response = self.client.get(reverse("wagtailadmin_home"))
self.request = response.wsgi_request
def test_menuitem_with_classname(self):
menuitem = MenuItem(
_("Test"),
reverse_lazy("wagtailadmin_home"),
classname="highlight-item",
)
self.assertEqual(menuitem.classname, "highlight-item")
class TestUserPassesTestPermissionDecorator(WagtailTestUtils, TestCase):
"""
Test for custom user_passes_test permission decorators.
testapp_bob_only_zone is a view configured to only grant access to users with a first_name of Bob
"""
def test_user_passes_test(self):
# create and log in as a user called Bob
self.create_superuser(
first_name="Bob", last_name="Mortimer", username="test", password="password"
)
self.login(username="test", password="password")
response = self.client.get(reverse("testapp_bob_only_zone"))
self.assertEqual(response.status_code, 200)
def test_user_fails_test(self):
# create and log in as a user not called Bob
self.create_superuser(
first_name="Vic", last_name="Reeves", username="test", password="password"
)
self.login(username="test", password="password")
response = self.client.get(reverse("testapp_bob_only_zone"))
self.assertRedirects(response, reverse("wagtailadmin_home"))
def test_user_fails_test_ajax(self):
# create and log in as a user not called Bob
self.create_superuser(
first_name="Vic", last_name="Reeves", username="test", password="password"
)
self.login(username="test", password="password")
response = self.client.get(
reverse("testapp_bob_only_zone"), HTTP_X_REQUESTED_WITH="XMLHttpRequest"
)
self.assertEqual(response.status_code, 403)
class TestUserHasAnyPagePermission(WagtailTestUtils, TestCase):
def test_superuser(self):
user = self.create_superuser(
username="superuser", email="admin@example.com", password="p"
)
self.assertTrue(user_has_any_page_permission(user))
def test_inactive_superuser(self):
user = self.create_superuser(
username="superuser", email="admin@example.com", password="p"
)
user.is_active = False
self.assertFalse(user_has_any_page_permission(user))
def test_editor(self):
user = self.create_user(username="editor", email="ed@example.com", password="p")
editors = Group.objects.get(name="Editors")
user.groups.add(editors)
self.assertTrue(user_has_any_page_permission(user))
def test_moderator(self):
user = self.create_user(
username="moderator", email="mod@example.com", password="p"
)
editors = Group.objects.get(name="Moderators")
user.groups.add(editors)
self.assertTrue(user_has_any_page_permission(user))
def test_no_permissions(self):
user = self.create_user(username="pleb", email="pleb@example.com", password="p")
user.user_permissions.add(
Permission.objects.get(
content_type__app_label="wagtailadmin", codename="access_admin"
)
)
self.assertFalse(user_has_any_page_permission(user))
class Test404(WagtailTestUtils, TestCase):
def test_admin_404_template_used_append_slash_true(self):
self.login()
with self.settings(APPEND_SLASH=True):
response = self.client.get("/admin/sdfgdsfgdsfgsdf", follow=True)
# Check 404 error after CommonMiddleware redirect
self.assertEqual(response.status_code, 404)
self.assertTemplateUsed(response, "wagtailadmin/404.html")
soup = self.get_soup(response.content)
self.assertFalse(soup.select("script"))
self.assertFalse(soup.select("[data-sprite]"))
def test_not_logged_in_redirect(self):
response = self.client.get("/admin/sdfgdsfgdsfgsdf/")
# Check that the user was redirected to the login page and that next was set correctly
self.assertRedirects(
response, reverse("wagtailadmin_login") + "?next=/admin/sdfgdsfgdsfgsdf/"
)
class TestAdminURLAppendSlash(WagtailTestUtils, TestCase):
def setUp(self):
# Find root page
self.root_page = Page.objects.get(id=2)
def test_return_correct_view_for_correct_url_without_ending_slash(self):
self.login()
with self.settings(APPEND_SLASH=True):
# Remove trailing slash from URL
response = self.client.get(
reverse("wagtailadmin_explore_root")[:-1], follow=True
)
# Check that correct page is returned after CommonMiddleware redirect
self.assertEqual(response.status_code, 200)
self.assertTemplateUsed(
response, "wagtailadmin/pages/explorable_index.html"
)
self.assertEqual(Page.objects.get(id=1), response.context["parent_page"])
self.assertIn(self.root_page, response.context["pages"])
class TestRemoveStaleContentTypes(TestCase):
def test_remove_stale_content_types_preserves_access_admin_permission(self):
call_command("remove_stale_contenttypes", interactive=False)
self.assertTrue(
Permission.objects.filter(
content_type__app_label="wagtailadmin", codename="access_admin"
).exists()
)