aboutsummaryrefslogtreecommitdiff
path: root/webmentions_ssg/cli
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--webmentions_ssg/cli/__init__.py3
-rw-r--r--webmentions_ssg/cli/mail.py47
-rw-r--r--webmentions_ssg/cli/users.py105
3 files changed, 155 insertions, 0 deletions
diff --git a/webmentions_ssg/cli/__init__.py b/webmentions_ssg/cli/__init__.py
new file mode 100644
index 0000000..25d78d5
--- /dev/null
+++ b/webmentions_ssg/cli/__init__.py
@@ -0,0 +1,3 @@
+# SPDX-FileCopyrightText: 2026 Dennis Fink <me+coding@dennisfink.me>
+#
+# SPDX-License-Identifier: BSD-3-Clause
diff --git a/webmentions_ssg/cli/mail.py b/webmentions_ssg/cli/mail.py
new file mode 100644
index 0000000..07dc50b
--- /dev/null
+++ b/webmentions_ssg/cli/mail.py
@@ -0,0 +1,47 @@
+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}.")
diff --git a/webmentions_ssg/cli/users.py b/webmentions_ssg/cli/users.py
new file mode 100644
index 0000000..2dcb17e
--- /dev/null
+++ b/webmentions_ssg/cli/users.py
@@ -0,0 +1,105 @@
+import click
+import sqlalchemy as sa
+from flask.cli import AppGroup
+
+from .. import DATABASE
+
+USERS_CLI = AppGroup("users", help="Manage users.")
+
+
+def _require_user(username: str):
+ """Return a user by username or report a CLI-friendly error."""
+ from ..models import User
+
+ user = DATABASE.session.scalar(sa.select(User).where(User.username == username))
+ if user is None:
+ raise click.ClickException(f"User {username!r} does not exist.")
+ return user
+
+
+@USERS_CLI.command("create", help="Create a user.")
+@click.option("--username", prompt="Username", help="Username for the new user.")
+@click.password_option(confirmation_prompt=True)
+def create_user(username: str, password: str) -> None:
+ """
+ Create a user with a securely hashed password.
+
+ :param username: Username for the new user.
+ :param password: Plain-text password to hash and store.
+ :raises click.ClickException: If the credentials are invalid or the user exists.
+ """
+ from ..models import User
+
+ username = username.strip()
+ if not username:
+ raise click.ClickException("Username must not be empty.")
+
+ if not password:
+ raise click.ClickException("Password must not be empty.")
+
+ if DATABASE.session.scalar(sa.select(User).where(User.username == username)):
+ raise click.ClickException(f"User {username!r} already exists.")
+
+ DATABASE.session.add(User(username=username, password=password))
+ try:
+ DATABASE.session.commit()
+ except sa.exc.IntegrityError as exc:
+ DATABASE.session.rollback()
+ raise click.ClickException(f"User {username!r} already exists.") from exc
+
+ click.echo(f"Created user {username!r}.")
+
+
+@USERS_CLI.command("list", help="List registered users.")
+def list_users() -> None:
+ """List user IDs and usernames in alphabetical order."""
+ from ..models import User
+
+ users = DATABASE.session.scalars(sa.select(User).order_by(User.username)).all()
+ if not users:
+ click.echo("No users found.")
+ return
+
+ click.echo("ID\tUSERNAME")
+ for user in users:
+ click.echo(f"{user.id}\t{user.username}")
+
+
+@USERS_CLI.command("set-password", help="Reset a user's password.")
+@click.argument("username")
+@click.password_option(confirmation_prompt=True)
+def set_user_password(username: str, password: str) -> None:
+ """
+ Change a user's password without displaying it.
+
+ :param username: Username of the account to update.
+ :param password: New plain-text password to hash and store.
+ :raises click.ClickException: If the account is missing or the password is empty.
+ """
+ if not password:
+ raise click.ClickException("Password must not be empty.")
+
+ user = _require_user(username)
+ user.password = password
+ DATABASE.session.commit()
+ click.echo(f"Updated password for user {username!r}.")
+
+
+@USERS_CLI.command("delete", help="Delete a user.")
+@click.argument("username")
+@click.option("-y", "--yes", is_flag=True, help="Skip the deletion confirmation.")
+def delete_user(username: str, yes: bool) -> None:
+ """
+ Permanently delete a user after confirmation, unless --yes is passed.
+
+ :param username: Username of the account to remove.
+ :param yes: Whether to skip the confirmation prompt.
+ :raises click.ClickException: If the account does not exist.
+ """
+ user = _require_user(username)
+ if not yes:
+ click.confirm(f"Delete user {username!r}?", abort=True)
+
+ DATABASE.session.delete(user)
+ DATABASE.session.commit()
+ click.echo(f"Deleted user {username!r}.")