# SPDX-FileCopyrightText: 2026 Dennis Fink # # SPDX-License-Identifier: BSD-3-Clause import uuid from datetime import UTC, datetime, timedelta from http import HTTPStatus from types import ModuleType from unittest.mock import Mock import pytest from flask import Flask from flask.testing import FlaskClient from webmentions_ssg import db from webmentions_ssg.models.sources import SentWebmention from webmentions_ssg.models.user import User from .helpers import ( create_outgoing, create_resendable_sent_webmention, create_sent_source, log_in, mock_admin_action_form, ) @pytest.fixture def sources_module(app: Flask) -> ModuleType: _ = app from webmentions_ssg.views import sources 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_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, sources_module: ModuleType, monkeypatch: pytest.MonkeyPatch, valid: bool, ) -> None: log_in(app, client) form = mock_admin_action_form(sources_module, monkeypatch, valid=valid) manual_scan_sources = Mock() monkeypatch.setattr(sources_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, sources_module: ModuleType, monkeypatch: pytest.MonkeyPatch, ) -> None: log_in(app, client) source_identifier, webmention_identifier = create_resendable_sent_webmention(app) mock_admin_action_form(sources_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, sources_module: ModuleType, monkeypatch: pytest.MonkeyPatch, ) -> None: log_in(app, client) source_identifier = create_sent_source(app) mock_admin_action_form(sources_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, sources_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(sources_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, sources_module: ModuleType, monkeypatch: pytest.MonkeyPatch, ) -> None: log_in(app, client) source_identifier, webmention_identifier = create_resendable_sent_webmention(app) mock_admin_action_form(sources_module, monkeypatch, valid=True) send_webmention = Mock() monkeypatch.setattr(sources_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