aboutsummaryrefslogtreecommitdiff
path: root/webmentions_ssg
diff options
context:
space:
mode:
authorDennis Fink2026-10-27 16:33:56 +0100
committerDennis Fink2026-10-27 16:33:56 +0100
commit5afb245d13b91047d68d7b7343245c41b6460953 (patch)
tree5565d4d42335b4c7c1ef82e2937a50c232c17d47 /webmentions_ssg
parenta67967275d0093f0ac3c3af85bf5396511c64422 (diff)
downloadwebmentions-ssg-5afb245d13b91047d68d7b7343245c41b6460953.tar.gz
webmentions-ssg-5afb245d13b91047d68d7b7343245c41b6460953.zip
feat(core): expand user management CLI
Add commands to list users, reset passwords, and delete accounts. Move mail and user commands into dedicated CLI modules.
Diffstat (limited to '')
-rw-r--r--webmentions_ssg/__init__.py81
-rw-r--r--webmentions_ssg/cli/__init__.py3
-rw-r--r--webmentions_ssg/cli/mail.py47
-rw-r--r--webmentions_ssg/cli/users.py105
4 files changed, 162 insertions, 74 deletions
diff --git a/webmentions_ssg/__init__.py b/webmentions_ssg/__init__.py
index 11bd632..3dda31b 100644
--- a/webmentions_ssg/__init__.py
+++ b/webmentions_ssg/__init__.py
@@ -7,13 +7,11 @@ import logging.handlers
import os
from pathlib import Path
-import click
import coloredlogs
-import sqlalchemy as sa
-from flask import Flask, current_app
+from flask import Flask
from flask.cli import AppGroup
from flask_bootstrap import Bootstrap5
-from flask_mail import Mail, Message
+from flask_mail import Mail
from flask_migrate import Migrate, upgrade
from flask_sqlalchemy import SQLAlchemy
from flask_wtf.csrf import CSRFProtect
@@ -38,9 +36,7 @@ MIGRATE = Migrate()
HUEY = Huey()
MAIL = Mail()
-USERS_CLI = AppGroup("users", help="Handle users")
DB_CLI = AppGroup("db", help="Handle database")
-MAIL_CLI = AppGroup("mail", help="Handle mail")
def create_app(config_class: type[DefaultConfig] | None = None) -> Flask:
@@ -130,39 +126,15 @@ def create_app(config_class: type[DefaultConfig] | None = None) -> Flask:
app.register_blueprint(root_page)
- app.cli.add_command(USERS_CLI)
- app.cli.add_command(MAIL_CLI)
-
- return app
-
-
-@USERS_CLI.command("create", help="Create or add users")
-@click.option("--username", prompt=True)
-@click.password_option(confirmation_prompt=True)
-def create_user(username: str, password: str) -> None:
- """
- Create a new user.
-
- :param username: Username of the user to create.
- :param password: Plain-text password to hash and store for the user.
- :raises click.ClickException: If a user with the given username already
- exists.
- """
+ from .cli.users import USERS_CLI
- from .models import User
-
- if (
- DATABASE.session.scalar(sa.select(User).where(User.username == username))
- is not None
- ):
- raise click.ClickException(f"User {username!r} already exists.")
+ app.cli.add_command(USERS_CLI)
- user = User(username=username, password=password)
+ from .cli.mail import MAIL_CLI
- DATABASE.session.add(user)
- DATABASE.session.commit()
+ app.cli.add_command(MAIL_CLI)
- click.echo(f"Created user {username!r}.")
+ return app
@DB_CLI.command("create")
@@ -171,42 +143,3 @@ def create_db() -> None:
Upgrade the database to the latest migration revision.
"""
upgrade()
-
-
-@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/__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}.")