aboutsummaryrefslogtreecommitdiff
path: root/tests/test_failure_guidance.py
diff options
context:
space:
mode:
authorDennis Fink2026-11-19 19:42:41 +0100
committerDennis Fink2026-11-19 20:59:24 +0100
commit88f54d9a7699944b7d56f978e724b1c0b54dde98 (patch)
tree88ecc527903a91a6f6622ca288b278e5875aff3d /tests/test_failure_guidance.py
parent8ec35babe87ff8139ec23cc10b858b7481f132db (diff)
downloadwebmentions-ssg-88f54d9a7699944b7d56f978e724b1c0b54dde98.tar.gz
webmentions-ssg-88f54d9a7699944b7d56f978e724b1c0b54dde98.zip
feat(sender): add bulk resend and delivery history
Allow admins to resend all failed Webmentions globally or requeue every delivery for a source using the shared confirmation workflow. Record outgoing status history, expand sent source details, and provide human-readable guidance for current and historical delivery failures.
Diffstat (limited to 'tests/test_failure_guidance.py')
-rw-r--r--tests/test_failure_guidance.py116
1 files changed, 116 insertions, 0 deletions
diff --git a/tests/test_failure_guidance.py b/tests/test_failure_guidance.py
new file mode 100644
index 0000000..008412f
--- /dev/null
+++ b/tests/test_failure_guidance.py
@@ -0,0 +1,116 @@
+# SPDX-FileCopyrightText: 2026 Dennis Fink <me+coding@dennisfink.me>
+#
+# SPDX-License-Identifier: BSD-3-Clause
+
+import pytest
+
+from webmentions_ssg.failure_guidance import (
+ describe_received_failure,
+ describe_sent_failure,
+)
+
+
+@pytest.mark.parametrize(
+ ("reason", "expected_fragment", "local_step"),
+ [
+ ("Source does not mention target", "link to the target URL", False),
+ ("Source returned HTTP 410", "permanently gone", False),
+ ("Source document is too large", "maximum response size", False),
+ ("Source resolves to a non-public address", "non-public address", False),
+ ("Source hostname could not be resolved", "DNS", False),
+ ("Source could not be fetched", "could not fetch", False),
+ ("Invalid source hostname", "valid hostname", False),
+ ("Source domain is blocked", "blocklist", True),
+ ("Source domain is not allowlisted", "allowed source-domain", True),
+ ("Verification recovery limit reached", "automatic recovery stopped", True),
+ ("Target hostname is not in ALLOWED_TARGET_HOSTNAMES", "target hostname", True),
+ (
+ "Target hostname is not in ALLOWED_TARGET_HOSTNAMES.",
+ "target hostname",
+ True,
+ ),
+ ("Source returned HTTP 404", "not found", False),
+ ("Source returned HTTP 401", "denied access", False),
+ ("Source returned HTTP 403", "denied access", False),
+ ("Source returned HTTP 429", "limiting requests", False),
+ ("Source returned HTTP 503", "server error", False),
+ ("Source returned HTTP 400", "returned HTTP 400", False),
+ (
+ "Unsupported source content type: application/json",
+ "application/json",
+ False,
+ ),
+ ],
+)
+def test_only_receiver_controlled_failures_suggest_steps(
+ reason: str, expected_fragment: str, local_step: bool
+) -> None:
+ guidance = describe_received_failure(reason)
+ assert guidance is not None
+ assert expected_fragment in guidance.explanation
+ assert bool(guidance.next_step) is local_step
+
+
+@pytest.mark.parametrize("reason", ["unknown failure", "", "Source returned HTTP 999"])
+def test_unknown_received_failures_are_not_misclassified(reason: str) -> None:
+ assert describe_received_failure(reason) is None
+
+
+@pytest.mark.parametrize(
+ ("reason", "expected_fragment", "operator_step"),
+ [
+ ("No Webmention endpoint discovered", "does not advertise", False),
+ ("Target returned HTTP 404", "not found", False),
+ ("Target returned HTTP 410", "permanently gone", False),
+ ("Target returned HTTP 403", "denied access", False),
+ ("Target returned HTTP 429", "rate-limiting", True),
+ ("Target returned HTTP 503", "server error", True),
+ ("Target returned HTTP 400", "did not complete delivery", False),
+ ("Webmention endpoint returned HTTP 302", "did not complete delivery", False),
+ ("Webmention endpoint returned HTTP 400", "rejected the submission", True),
+ ("Webmention endpoint returned HTTP 422", "rejected the submission", True),
+ ("Webmention endpoint returned HTTP 404", "not found", False),
+ ("Webmention endpoint returned HTTP 408", "timed out", True),
+ ("Webmention endpoint returned HTTP 429", "rate-limiting", True),
+ ("Webmention endpoint returned HTTP 500", "server error", True),
+ ("Webmention endpoint returned HTTP 503.", "server error", True),
+ ("Target document is too large", "response-size limit", True),
+ ("Invalid target URL: 'ftp://example.com'", "valid HTTP", True),
+ ("Invalid Webmention endpoint: 'ftp://example.com'", "malformed", False),
+ ("Could not resolve hostname 'example.com'", "DNS resolution", True),
+ ("Non-public network address for 'localhost'", "non-public", True),
+ ("No public addresses available for 'example.com'", "public address", False),
+ ("Retry limit reached (6 attempts)", "exhausted", True),
+ ("Webmention request failed", "could not complete", True),
+ ("timed out", "timed out", True),
+ ("The read operation timed out", "read timeout", True),
+ ("[Errno 111] Connection refused", "refused", True),
+ ("All connection attempts failed", "could not establish", True),
+ ("Server disconnected without sending a response", "closed", False),
+ ],
+)
+def test_sent_failure_guidance(
+ reason: str, expected_fragment: str, operator_step: bool
+) -> None:
+ guidance = describe_sent_failure(reason)
+ assert guidance is not None
+ assert expected_fragment in guidance.explanation
+ assert bool(guidance.next_step) is operator_step
+
+
+@pytest.mark.parametrize(
+ "reason",
+ [
+ "",
+ "Unrecognized sender failure",
+ "Target returned HTTP 999",
+ "Retry limit reached",
+ ],
+)
+def test_unknown_sent_failures_keep_raw_reason(reason: str) -> None:
+ assert describe_sent_failure(reason) is None
+
+
+def test_received_and_sent_reasons_do_not_cross_classify() -> None:
+ assert describe_received_failure("No Webmention endpoint discovered") is None
+ assert describe_sent_failure("Source domain is blocked") is None