diff options
| author | Dennis Fink | 2026-10-27 16:33:56 +0100 |
|---|---|---|
| committer | Dennis Fink | 2026-10-27 16:33:56 +0100 |
| commit | 5afb245d13b91047d68d7b7343245c41b6460953 (patch) | |
| tree | 5565d4d42335b4c7c1ef82e2937a50c232c17d47 /webmentions_ssg/cli/users.py | |
| parent | a67967275d0093f0ac3c3af85bf5396511c64422 (diff) | |
| download | webmentions-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 'webmentions_ssg/cli/users.py')
| -rw-r--r-- | webmentions_ssg/cli/users.py | 105 |
1 files changed, 105 insertions, 0 deletions
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}.") |
