# SPDX-FileCopyrightText: 2026 Dennis Fink # # SPDX-License-Identifier: BSD-3-Clause import uuid from types import ModuleType from unittest.mock import patch import pytest from flask import Flask from huey.exceptions import TaskLockedException from webmentions_ssg import db from webmentions_ssg.extensions import huey from webmentions_ssg.models import ReceivedWebmention @pytest.fixture def notifications(app: Flask) -> ModuleType: from webmentions_ssg.tasks import notifications return notifications def create_mention(app: Flask, status: str = "verified") -> uuid.UUID: identifier = uuid.uuid7() with app.app_context(): db.session.add( ReceivedWebmention( uuid=identifier, source=f"https://source.example/{identifier}", target="https://dennisfink.me/post", status=status, ) ) db.session.commit() return identifier def test_digest_sends_one_email_for_multiple_verified_mentions( notifications: ModuleType, app: Flask ) -> None: app.config["NOTIFICATION_EMAIL"] = "owner@example.com" first = create_mention(app) second = create_mention(app) unverified = create_mention(app, "failed") with app.app_context(): with patch("webmentions_ssg.tasks.notifications.mail.send") as send: notifications.send_webmention_digest() notifications.send_webmention_digest() send.assert_called_once() message = send.call_args.args[0] assert message.recipients == ["owner@example.com"] assert "2 new Webmentions" in message.body assert "source.example" not in message.body first_mention = db.session.get(ReceivedWebmention, first) second_mention = db.session.get(ReceivedWebmention, second) unverified_mention = db.session.get(ReceivedWebmention, unverified) assert first_mention is not None assert second_mention is not None assert unverified_mention is not None assert first_mention.notification_sent_at is not None assert second_mention.notification_sent_at is not None assert unverified_mention.notification_sent_at is None def test_digest_skips_when_notifications_disabled( notifications: ModuleType, app: Flask ) -> None: app.config["NOTIFICATION_EMAIL"] = None identifier = create_mention(app) with app.app_context(): with patch("webmentions_ssg.tasks.notifications.mail.send") as send: notifications.send_webmention_digest() send.assert_not_called() mention = db.session.get(ReceivedWebmention, identifier) assert mention is not None assert mention.notification_sent_at is None def test_digest_does_not_mark_mentions_when_email_fails( notifications: ModuleType, app: Flask ) -> None: app.config["NOTIFICATION_EMAIL"] = "owner@example.com" identifier = create_mention(app) with app.app_context(): with ( patch( "webmentions_ssg.tasks.notifications.mail.send", side_effect=RuntimeError("SMTP unavailable"), ), pytest.raises(RuntimeError, match="SMTP unavailable"), ): notifications.send_webmention_digest() mention = db.session.get(ReceivedWebmention, identifier) assert mention is not None assert mention.notification_sent_at is None with patch("webmentions_ssg.tasks.notifications.mail.send") as send: notifications.send_webmention_digest() send.assert_called_once() mention = db.session.get(ReceivedWebmention, identifier) assert mention is not None assert mention.notification_sent_at is not None def test_digest_skips_when_no_new_mentions( notifications: ModuleType, app: Flask ) -> None: app.config["NOTIFICATION_EMAIL"] = "owner@example.com" with app.app_context(): with patch("webmentions_ssg.tasks.notifications.mail.send") as send: notifications.send_webmention_digest() send.assert_not_called() def test_digest_lock_uses_current_backend( notifications: ModuleType, app: Flask ) -> None: """A digest imported before reinitialization uses the new backend's lock.""" with app.app_context(): previous_backend = huey.huey huey.init_app(app) assert huey.huey is not previous_backend with ( huey.lock_task("send-webmention-digest"), pytest.raises(TaskLockedException), ): notifications.send_webmention_digest()