# SPDX-FileCopyrightText: 2026 Dennis Fink # # SPDX-License-Identifier: BSD-3-Clause """Test application configuration defaults, loading, and hardening.""" from pathlib import Path import pytest from wtforms import Field, ValidationError from wtforms.form import BaseForm from webmentions_ssg import create_app from webmentions_ssg.config import ( DefaultConfig, DevelopmentConfig, ProductionConfig, TestingConfig, ) from webmentions_ssg.forms.validators import AllowedHostname @pytest.mark.parametrize( ("config_class", "expected_secure"), [ (DefaultConfig, True), (ProductionConfig, True), (DevelopmentConfig, False), (TestingConfig, False), ], ) def test_session_cookie_defaults( config_class: type[DefaultConfig], expected_secure: bool ) -> None: assert config_class.SESSION_COOKIE_SECURE is expected_secure assert config_class.SESSION_COOKIE_HTTPONLY is True assert config_class.SESSION_COOKIE_SAMESITE == "Lax" def test_explicit_config_overrides_session_cookie_defaults() -> None: class CookieOverrideConfig(TestingConfig): SESSION_COOKIE_SECURE = True SESSION_COOKIE_HTTPONLY = False SESSION_COOKIE_SAMESITE = "Strict" app = create_app(CookieOverrideConfig) assert app.config["SESSION_COOKIE_SECURE"] is True assert app.config["SESSION_COOKIE_HTTPONLY"] is False assert app.config["SESSION_COOKIE_SAMESITE"] == "Strict" def test_missing_production_configuration_is_fatal(tmp_path: Path) -> None: class MissingProductionConfig(ProductionConfig): CONFIG_FILE = str(tmp_path / "missing.cfg") with pytest.raises(FileNotFoundError, match="missing.cfg"): create_app(MissingProductionConfig) def test_missing_development_configuration_is_optional(tmp_path: Path) -> None: class LocalDevelopmentConfig(DevelopmentConfig): CONFIG_FILE = str(tmp_path / "missing.cfg") LOG_FILE = str(tmp_path / "development.log") app = create_app(LocalDevelopmentConfig) assert app.config["ALLOWED_HOSTNAMES"] == set() def test_endpoint_limits_are_inherited_from_defaults() -> None: for config in (DefaultConfig, DevelopmentConfig, ProductionConfig, TestingConfig): assert config.MAX_REDIRECTS == 20 assert config.MAX_SOURCE_BYTES == 1_000_000 assert config.REQUEST_TIMEOUT == 5.0 assert config.REQUEST_TOTAL_TIMEOUT == 30.0 assert DefaultConfig.ALLOWED_HOSTNAMES == set() def test_allowed_hostnames_are_normalized_at_startup(tmp_path: Path) -> None: class MixedCaseConfig(TestingConfig): LOG_FILE = str(tmp_path / "test.log") ALLOWED_HOSTNAMES = [" DennisFink.Me ", "EXAMPLE.COM", "dennisfink.me"] app = create_app(MixedCaseConfig) assert app.config["ALLOWED_HOSTNAMES"] == {"dennisfink.me", "example.com"} assert isinstance(app.config["ALLOWED_HOSTNAMES"], set) # The form validator must compare complete hostnames, never substrings. target = Field() validator = AllowedHostname(message="Hostname not allowed") form = BaseForm({}) with app.app_context(): for url in ("https://dennisfink.me/post", "https://EXAMPLE.com/post"): target.data = url validator(form, target) for url in ("https://fink/post", "https://evil-dennisfink.me/post"): target.data = url with pytest.raises(ValidationError, match="Hostname not allowed"): validator(form, target) @pytest.mark.parametrize( "hostnames,expected_exception", [ ("dennisfink.me", TypeError), (None, TypeError), ({"dennisfink.me": True}, TypeError), (123, TypeError), (["example.com", None], ValueError), (["example.com", ""], ValueError), (["example.com", " "], ValueError), ], ) def test_invalid_allowed_hostnames_fail_at_startup( tmp_path: Path, hostnames: object, expected_exception: type[Exception] ) -> None: class InvalidHostnameConfig(TestingConfig): LOG_FILE = str(tmp_path / "test.log") ALLOWED_HOSTNAMES = hostnames with pytest.raises(expected_exception, match="ALLOWED_HOSTNAMES"): create_app(InvalidHostnameConfig) def test_production_requires_nonempty_allowed_hostnames(tmp_path: Path) -> None: config_path = tmp_path / "production.cfg" config_path.write_text('RATELIMIT_STORAGE_URI = "redis://localhost:6379"\n') class EmptyHostnamesConfig(ProductionConfig): CONFIG_FILE = str(config_path) with pytest.raises(RuntimeError, match="ALLOWED_HOSTNAMES"): create_app(EmptyHostnamesConfig) def test_environment_allowed_hostnames_override_config_file( tmp_path: Path, monkeypatch: pytest.MonkeyPatch ) -> None: config_path = tmp_path / "development.cfg" config_path.write_text('ALLOWED_HOSTNAMES = ["first.example"]\n') monkeypatch.setenv("WEBMENTIONS_SSG_ALLOWED_HOSTNAMES", '["SECOND.EXAMPLE"]') class LocalDevelopmentConfig(DevelopmentConfig): CONFIG_FILE = str(config_path) LOG_FILE = str(tmp_path / "development.log") app = create_app(LocalDevelopmentConfig) assert app.config["ALLOWED_HOSTNAMES"] == {"second.example"}