# SPDX-FileCopyrightText: 2026 Dennis Fink # # SPDX-License-Identifier: BSD-3-Clause """Provide a command for testing outgoing email configuration.""" import click from flask import current_app from flask.cli import AppGroup from flask_mail import Message from .. import MAIL MAIL_CLI = AppGroup("mail", help="Handle mail") @MAIL_CLI.command("test", help="Send an email to test the SMTP configuration") @click.option( "--to", "recipient", help="Recipient address (defaults to NOTIFICATION_EMAIL)." ) def send_test_mail(recipient: str | None) -> None: """ Send a test email using the configured SMTP server. :param recipient: Optional recipient overriding NOTIFICATION_EMAIL. :raises click.ClickException: If configuration is missing or sending fails. """ recipient = recipient or current_app.config.get("NOTIFICATION_EMAIL") if not recipient: raise click.ClickException( "No recipient specified. Set NOTIFICATION_EMAIL or pass --to." ) sender = current_app.config.get("MAIL_DEFAULT_SENDER") if not sender: raise click.ClickException("MAIL_DEFAULT_SENDER is not configured.") message = Message( subject="webmentions-ssg: test email", sender=sender, recipients=[recipient], body=( "This is a test email from webmentions-ssg.\n\n" "If you received this message, the outgoing mail configuration works.\n" ), ) try: MAIL.send(message) except Exception as exc: raise click.ClickException(f"Could not send test email: {exc}") from exc click.echo(f"Test email sent to {recipient}.")