mirror of
https://forgejo.ellis.link/continuwuation/continuwuity.git
synced 2025-06-27 01:36:36 +02:00
106 lines
2.7 KiB
Rust
106 lines
2.7 KiB
Rust
mod commands;
|
|
|
|
use clap::Subcommand;
|
|
use conduit::Result;
|
|
use ruma::{OwnedRoomOrAliasId, RoomId};
|
|
|
|
use crate::admin_command_dispatch;
|
|
|
|
#[admin_command_dispatch]
|
|
#[derive(Debug, Subcommand)]
|
|
pub(super) enum UserCommand {
|
|
/// - Create a new user
|
|
#[clap(alias = "create")]
|
|
CreateUser {
|
|
/// Username of the new user
|
|
username: String,
|
|
/// Password of the new user, if unspecified one is generated
|
|
password: Option<String>,
|
|
},
|
|
|
|
/// - Reset user password
|
|
ResetPassword {
|
|
/// Username of the user for whom the password should be reset
|
|
username: String,
|
|
},
|
|
|
|
/// - Deactivate a user
|
|
///
|
|
/// User will be removed from all rooms by default.
|
|
/// Use --no-leave-rooms to not leave all rooms by default.
|
|
Deactivate {
|
|
#[arg(short, long)]
|
|
no_leave_rooms: bool,
|
|
user_id: String,
|
|
},
|
|
|
|
/// - Deactivate a list of users
|
|
///
|
|
/// Recommended to use in conjunction with list-local-users.
|
|
///
|
|
/// Users will be removed from joined rooms by default.
|
|
///
|
|
/// Can be overridden with --no-leave-rooms.
|
|
///
|
|
/// Removing a mass amount of users from a room may cause a significant
|
|
/// amount of leave events. The time to leave rooms may depend significantly
|
|
/// on joined rooms and servers.
|
|
///
|
|
/// This command needs a newline separated list of users provided in a
|
|
/// Markdown code block below the command.
|
|
DeactivateAll {
|
|
#[arg(short, long)]
|
|
/// Does not leave any rooms the user is in on deactivation
|
|
no_leave_rooms: bool,
|
|
#[arg(short, long)]
|
|
/// Also deactivate admin accounts and will assume leave all rooms too
|
|
force: bool,
|
|
},
|
|
|
|
/// - List local users in the database
|
|
#[clap(alias = "list")]
|
|
ListUsers,
|
|
|
|
/// - Lists all the rooms (local and remote) that the specified user is
|
|
/// joined in
|
|
ListJoinedRooms {
|
|
user_id: String,
|
|
},
|
|
|
|
/// - Manually join a local user to a room.
|
|
ForceJoinRoom {
|
|
user_id: String,
|
|
room_id: OwnedRoomOrAliasId,
|
|
},
|
|
|
|
/// - Grant server-admin privileges to a user.
|
|
MakeUserAdmin {
|
|
user_id: String,
|
|
},
|
|
|
|
/// - Puts a room tag for the specified user and room ID.
|
|
///
|
|
/// This is primarily useful if you'd like to set your admin room
|
|
/// to the special "System Alerts" section in Element as a way to
|
|
/// permanently see your admin room without it being buried away in your
|
|
/// favourites or rooms. To do this, you would pass your user, your admin
|
|
/// room's internal ID, and the tag name `m.server_notice`.
|
|
PutRoomTag {
|
|
user_id: String,
|
|
room_id: Box<RoomId>,
|
|
tag: String,
|
|
},
|
|
|
|
/// - Deletes the room tag for the specified user and room ID
|
|
DeleteRoomTag {
|
|
user_id: String,
|
|
room_id: Box<RoomId>,
|
|
tag: String,
|
|
},
|
|
|
|
/// - Gets all the room tags for the specified user and room ID
|
|
GetRoomTags {
|
|
user_id: String,
|
|
room_id: Box<RoomId>,
|
|
},
|
|
}
|