# SPDX-FileCopyrightText: 2026 Dennis Fink # # SPDX-License-Identifier: BSD-3-Clause import re import uuid from datetime import UTC, datetime, timedelta from html import unescape from http import HTTPStatus from types import ModuleType from unittest.mock import Mock from urllib.parse import parse_qs, urlsplit import pytest from flask import Flask from flask.testing import FlaskClient from webmentions_ssg import db from webmentions_ssg.models import ReceivedWebmention, SentWebmention, User from .helpers import ( SOURCE_URL, TARGET_URL, create_outgoing, create_received_webmention, create_resendable_sent_webmention, create_sent_source, log_in, mock_admin_action_form, ) @pytest.fixture def views_module(app: Flask) -> ModuleType: _ = app from webmentions_ssg.views import admin as module return module @pytest.mark.parametrize("path", ["/sources", f"/sources/{uuid.uuid7()}"]) def test_sent_views_require_login(client: FlaskClient, path: str) -> None: response = client.get(path) assert response.status_code == HTTPStatus.FOUND assert "/login" in response.headers["Location"] def test_sent_lists_sources(app: Flask, client: FlaskClient) -> None: log_in(app, client) identifier = create_sent_source(app) response = client.get("/sources") assert response.status_code == HTTPStatus.OK html = response.get_data(as_text=True) assert "blog/example/index.html" in html assert "https://dennisfink.me/blog/example/" in html assert f"/sources/{identifier}" in html def test_sent_source_lists_webmentions(app: Flask, client: FlaskClient) -> None: log_in(app, client) identifier = create_sent_source(app) response = client.get(f"/sources/{identifier}") assert response.status_code == HTTPStatus.OK html = response.get_data(as_text=True) assert "blog/example/index.html" in html assert "https://dennisfink.me/blog/example/" in html first_target = "https://example.com/a" second_target = "https://example.com/b" assert first_target in html assert second_target in html assert html.index(first_target) < html.index(second_target) assert "Webmention endpoint returned HTTP 400" in html assert "https://example.com/webmention" in html def test_sent_source_returns_404_for_unknown_source( app: Flask, client: FlaskClient ) -> None: log_in(app, client) response = client.get(f"/sources/{uuid.uuid7()}") assert response.status_code == HTTPStatus.NOT_FOUND def test_received_requires_login(client: FlaskClient) -> None: response = client.get("/received") assert response.status_code == HTTPStatus.FOUND assert "/login" in response.headers["Location"] def test_received_lists_webmentions(app: Flask, client: FlaskClient) -> None: log_in(app, client) create_received_webmention(app) response = client.get("/received") assert response.status_code == HTTPStatus.OK html = response.get_data(as_text=True) assert SOURCE_URL in html assert TARGET_URL in html @pytest.mark.parametrize( ("filter_status", "expected_statuses"), [ ("pending", {"received"}), ("verifying", {"verifying"}), ("verified", {"verified"}), ("declined", {"failed", "source_removed"}), ], ) def test_received_filters_by_display_status( app: Flask, client: FlaskClient, filter_status: str, expected_statuses: set[str] ) -> None: log_in(app, client) statuses = ("received", "verifying", "verified", "failed", "source_removed") for status in statuses: create_received_webmention( app, source=f"https://{status}.example/post", status=status ) response = client.get("/received", query_string={"status": filter_status}) assert response.status_code == HTTPStatus.OK html = response.get_data(as_text=True) for status in statuses: assert (f"https://{status}.example/post" in html) == ( status in expected_statuses ) assert re.search( rf']*\bvalue="{filter_status}")(?=[^>]*\bselected\b)[^>]*>', html ) def test_received_get_filter_form_renders_wtforms_fields( app: Flask, client: FlaskClient ) -> None: log_in(app, client) response = client.get( "/received", query_string={ "status": "pending", "q": "example.org", "date_from": "2026-11-08", "date_to": "2026-11-14", }, ) assert response.status_code == HTTPStatus.OK html = response.get_data(as_text=True) for field in ("status", "q", "date_from", "date_to"): assert f'name="{field}"' in html assert 'type="search"' in html assert html.count('type="date"') == 2 assert 'value="example.org"' in html assert 'value="2026-11-08"' in html assert 'value="2026-11-14"' in html assert re.search(r']*method="get"[^>]*role="search"', html) def test_received_filters_source_or_target_as_literal_substring( app: Flask, client: FlaskClient ) -> None: log_in(app, client) create_received_webmention( app, source="https://site.example/Alpha_10%", target="https://other.example/a" ) create_received_webmention( app, source="https://other.example/b", target="https://site.example/alpha_10%" ) create_received_webmention( app, source="https://site.example/alphaX100", target="https://other.example/c" ) response = client.get("/received", query_string={"q": "ALPHA_10%"}) assert response.status_code == HTTPStatus.OK html = response.get_data(as_text=True) assert "https://other.example/a" in html assert "https://other.example/b" in html assert "https://other.example/c" not in html def test_received_filters_by_inclusive_updated_date_range( app: Flask, client: FlaskClient ) -> None: log_in(app, client) dates = { "before": datetime(2026, 11, 7, 23, 59, 59, tzinfo=UTC), "first": datetime(2026, 11, 8, tzinfo=UTC), "last": datetime(2026, 11, 14, 23, 59, 59, 999999, tzinfo=UTC), "after": datetime(2026, 11, 15, tzinfo=UTC), } for label, updated_at in dates.items(): create_received_webmention( app, source=f"https://{label}.example/post", status="failed", updated_at=updated_at, ) response = client.get( "/received", query_string={ "status": "declined", "date_from": "2026-11-08", "date_to": "2026-11-14", }, ) assert response.status_code == HTTPStatus.OK html = response.get_data(as_text=True) for label in ("first", "last"): assert f"https://{label}.example/post" in html for label in ("before", "after"): assert f"https://{label}.example/post" not in html def test_received_filters_are_combined(app: Flask, client: FlaskClient) -> None: log_in(app, client) for status, source, day in ( ("failed", "https://match.example/a", 12), ("verified", "https://match.example/b", 12), ("failed", "https://other.example/c", 12), ("failed", "https://match.example/d", 1), ): create_received_webmention( app, source=source, status=status, updated_at=datetime(2026, 11, day, tzinfo=UTC), ) response = client.get( "/received?status=declined&q=match.example&date_from=2026-11-08&date_to=2026-11-14" ) html = response.get_data(as_text=True) assert "https://match.example/a" in html for suffix in ("b", "c", "d"): assert f"/{suffix}" not in html assert "1 total" in html @pytest.mark.parametrize( "query_string", [ "status=unknown", "date_from=not-a-date", "date_from=2026-11-8", "date_to=2026-02-30", "date_from=2026-11-15&date_to=2026-11-08", ], ) def test_received_rejects_invalid_filters( app: Flask, client: FlaskClient, query_string: str ) -> None: log_in(app, client) assert client.get(f"/received?{query_string}").status_code == HTTPStatus.BAD_REQUEST def test_received_pagination_and_actions_keep_filters( app: Flask, client: FlaskClient ) -> None: log_in(app, client) for index in range(26): create_received_webmention( app, source=f"https://match.example/{index}", status="failed", updated_at=datetime(2026, 11, 12, tzinfo=UTC), ) filters = { "status": "declined", "q": "match.example", "date_from": "2026-11-08", "date_to": "2026-11-14", } response = client.get("/received", query_string=filters) assert response.status_code == HTTPStatus.OK html = response.get_data(as_text=True) assert "26 total" in html pagination_links = re.findall(r'href="([^"]+)"', html) action_links = re.findall(r'data-action="([^"]+)"', html) assert action_links expected_filters = {key: [value] for key, value in filters.items()} assert any( urlsplit(unescape(link)).path == "/received" and parse_qs(urlsplit(unescape(link)).query) == {**expected_filters, "page": ["2"]} for link in pagination_links ) for link in action_links: assert parse_qs(urlsplit(unescape(link)).query) == { **expected_filters, "page": ["1"], } @pytest.mark.parametrize("action", ["delete", "reverify"]) def test_received_action_redirect_keeps_filters( app: Flask, client: FlaskClient, views_module: ModuleType, monkeypatch: pytest.MonkeyPatch, action: str, ) -> None: log_in(app, client) identifier = create_received_webmention(app) mock_admin_action_form(views_module, monkeypatch, valid=True) monkeypatch.setattr(views_module, "verify_webmention", Mock()) response = client.post( f"/received/{identifier}/{action}", query_string={ "page": 3, "status": "declined", "q": "example.org/a&b", "date_from": "2026-11-08", "date_to": "2026-11-14", }, ) assert response.status_code == HTTPStatus.FOUND redirect_url = urlsplit(response.headers["Location"]) assert redirect_url.path == "/received" assert parse_qs(redirect_url.query) == { "page": ["3"], "status": ["declined"], "q": ["example.org/a&b"], "date_from": ["2026-11-08"], "date_to": ["2026-11-14"], } @pytest.mark.parametrize("action", ["delete", "reverify"]) def test_received_action_rejects_invalid_filters_before_mutating( app: Flask, client: FlaskClient, views_module: ModuleType, monkeypatch: pytest.MonkeyPatch, action: str, ) -> None: log_in(app, client) identifier = create_received_webmention(app, status="received") mock_admin_action_form(views_module, monkeypatch, valid=True) verify = Mock() monkeypatch.setattr(views_module, "verify_webmention", verify) response = client.post( f"/received/{identifier}/{action}", query_string={"status": "invalid"} ) assert response.status_code == HTTPStatus.BAD_REQUEST with app.app_context(): row = db.session.get(ReceivedWebmention, identifier) assert row is not None assert row.status == "received" verify.assert_not_called() @pytest.mark.parametrize("action", ["delete", "reverify"]) def test_received_admin_actions_require_login(client: FlaskClient, action: str) -> None: response = client.post(f"/received/{uuid.uuid7()}/{action}") assert response.status_code == HTTPStatus.FOUND assert "/login" in response.headers["Location"] @pytest.mark.parametrize("action", ["delete", "reverify"]) def test_received_admin_actions_reject_invalid_form( app: Flask, client: FlaskClient, views_module: ModuleType, monkeypatch: pytest.MonkeyPatch, action: str, ) -> None: log_in(app, client) identifier = create_received_webmention(app) form = mock_admin_action_form(views_module, monkeypatch, valid=False) response = client.post(f"/received/{identifier}/{action}") assert response.status_code == HTTPStatus.BAD_REQUEST form.validate_on_submit.assert_called_once_with() @pytest.mark.parametrize("action", ["delete", "reverify"]) def test_received_admin_actions_return_404_for_unknown_webmention( app: Flask, client: FlaskClient, views_module: ModuleType, monkeypatch: pytest.MonkeyPatch, action: str, ) -> None: log_in(app, client) mock_admin_action_form(views_module, monkeypatch, valid=True) response = client.post(f"/received/{uuid.uuid7()}/{action}") assert response.status_code == HTTPStatus.NOT_FOUND def test_delete_received_webmention( app: Flask, client: FlaskClient, views_module: ModuleType, monkeypatch: pytest.MonkeyPatch, ) -> None: log_in(app, client) identifier = create_received_webmention(app) mock_admin_action_form(views_module, monkeypatch, valid=True) response = client.post(f"/received/{identifier}/delete?page=3") assert response.status_code == HTTPStatus.FOUND assert response.headers["Location"].endswith("/received?page=3") with app.app_context(): assert db.session.get(ReceivedWebmention, identifier) is None def test_reverify_received_webmention( app: Flask, client: FlaskClient, views_module: ModuleType, monkeypatch: pytest.MonkeyPatch, ) -> None: log_in(app, client) identifier = create_received_webmention( app, status="failed", failure_reason="Previous failure" ) with app.app_context(): row = db.session.get(ReceivedWebmention, identifier) assert row is not None row.recovery_attempts = 3 db.session.commit() mock_admin_action_form(views_module, monkeypatch, valid=True) verify_webmention = Mock() monkeypatch.setattr(views_module, "verify_webmention", verify_webmention) response = client.post(f"/received/{identifier}/reverify?page=2") assert response.status_code == HTTPStatus.FOUND assert response.headers["Location"].endswith("/received?page=2") with app.app_context(): webmention = db.session.get(ReceivedWebmention, identifier) assert webmention is not None assert webmention.status == "received" assert webmention.failure_reason is None assert webmention.recovery_attempts == 0 verify_webmention.assert_called_once_with(identifier) def test_rescan_sent_sources_requires_login(client: FlaskClient) -> None: response = client.post("/sources/rescan") assert response.status_code == HTTPStatus.FOUND assert "/login" in response.headers["Location"] @pytest.mark.parametrize("valid", [False, True]) def test_rescan_sent_sources( app: Flask, client: FlaskClient, views_module: ModuleType, monkeypatch: pytest.MonkeyPatch, valid: bool, ) -> None: log_in(app, client) form = mock_admin_action_form(views_module, monkeypatch, valid=valid) manual_scan_sources = Mock() monkeypatch.setattr(views_module, "manual_scan_sources", manual_scan_sources) response = client.post("/sources/rescan") assert response.status_code == ( HTTPStatus.FOUND if valid else HTTPStatus.BAD_REQUEST ) form.validate_on_submit.assert_called_once_with() if valid: assert response.headers["Location"].endswith("/sources") manual_scan_sources.assert_called_once_with() else: manual_scan_sources.assert_not_called() def test_resend_sent_webmention_requires_login(client: FlaskClient) -> None: response = client.post(f"/sources/{uuid.uuid7()}/{uuid.uuid7()}/resend") assert response.status_code == HTTPStatus.FOUND assert "/login" in response.headers["Location"] def test_resend_sent_webmention_rejects_invalid_form( app: Flask, client: FlaskClient, views_module: ModuleType, monkeypatch: pytest.MonkeyPatch, ) -> None: log_in(app, client) source_identifier, webmention_identifier = create_resendable_sent_webmention(app) mock_admin_action_form(views_module, monkeypatch, valid=False) response = client.post( f"/sources/{source_identifier}/{webmention_identifier}/resend" ) assert response.status_code == HTTPStatus.BAD_REQUEST def test_resend_sent_webmention_returns_404_for_unknown_webmention( app: Flask, client: FlaskClient, views_module: ModuleType, monkeypatch: pytest.MonkeyPatch, ) -> None: log_in(app, client) source_identifier = create_sent_source(app) mock_admin_action_form(views_module, monkeypatch, valid=True) response = client.post(f"/sources/{source_identifier}/{uuid.uuid7()}/resend") assert response.status_code == HTTPStatus.NOT_FOUND def test_resend_sent_webmention_rejects_wrong_source( app: Flask, client: FlaskClient, views_module: ModuleType, monkeypatch: pytest.MonkeyPatch, ) -> None: log_in(app, client) _, webmention_identifier = create_resendable_sent_webmention(app) wrong_source_identifier = create_sent_source(app) mock_admin_action_form(views_module, monkeypatch, valid=True) response = client.post( f"/sources/{wrong_source_identifier}/{webmention_identifier}/resend" ) assert response.status_code == HTTPStatus.NOT_FOUND def test_resend_sent_webmention_reopens_current_revision( app: Flask, client: FlaskClient, views_module: ModuleType, monkeypatch: pytest.MonkeyPatch, ) -> None: log_in(app, client) source_identifier, webmention_identifier = create_resendable_sent_webmention(app) mock_admin_action_form(views_module, monkeypatch, valid=True) send_webmention = Mock() monkeypatch.setattr(views_module, "send_webmention", send_webmention) with app.app_context(): webmention = db.session.get(SentWebmention, webmention_identifier) assert webmention is not None webmention.attempt_count = 6 webmention.next_retry_at = datetime.now(UTC) + timedelta(hours=24) db.session.commit() response = client.post( f"/sources/{source_identifier}/{webmention_identifier}/resend" ) assert response.status_code == HTTPStatus.FOUND assert response.headers["Location"].endswith(f"/sources/{source_identifier}") with app.app_context(): webmention = db.session.get(SentWebmention, webmention_identifier) assert webmention is not None assert webmention.desired_revision == 3 assert webmention.processed_revision is None assert webmention.attempt_count == 0 assert webmention.next_retry_at is None assert webmention.sent_revision == 2 assert webmention.status is None assert webmention.failure_reason is None assert webmention.webmention_endpoint is None assert webmention.endpoint_response_status is None assert webmention.status_url is None send_webmention.assert_called_once_with(webmention_identifier) @pytest.mark.parametrize( ("status_url", "safe"), [ ("https://example.com/status", True), ("http://example.com/status", True), ("javascript:alert(1)", False), ("data:text/html,evil", False), ("ftp://example.com/status", False), ], ) def test_admin_only_links_safe_existing_status_urls( app: Flask, client: FlaskClient, status_url: str, safe: bool ) -> None: source_identifier, _ = create_outgoing(app, status_url=status_url) with app.app_context(): user = User(username="admin", password="test") db.session.add(user) db.session.commit() user_id = user.get_id() with client.session_transaction() as session: session["_user_id"] = str(user_id) session["_fresh"] = True response = client.get(f"/sources/{source_identifier}") assert response.status_code == HTTPStatus.OK html = response.get_data(as_text=True) assert (f'href="{status_url}"' in html) is safe assert status_url in html