nmode's Git Repositories - signal-cli/blob - client/src/cli.rs

   1 use std::{ffi::OsString, net::SocketAddr};
   2
   3 use clap::{crate_version, Parser, Subcommand, ValueEnum};
   4
   5 /// JSON-RPC client for signal-cli
   6 #[derive(Parser, Debug)]
   7 #[command(rename_all = "kebab-case", version = crate_version!())]
   8 pub struct Cli {
   9     /// Account to use (for daemon in multi-account mode)
  10     #[arg(short = 'a', long)]
  11     pub account: Option<String>,
  12
  13     /// TCP host and port of signal-cli daemon
  14     #[arg(long, conflicts_with = "json_rpc_http")]
  15     pub json_rpc_tcp: Option<Option<SocketAddr>>,
  16
  17     /// UNIX socket address and port of signal-cli daemon
  18     #[cfg(unix)]
  19     #[arg(long, conflicts_with = "json_rpc_tcp")]
  20     pub json_rpc_socket: Option<Option<OsString>>,
  21
  22     /// HTTP URL of signal-cli daemon
  23     #[arg(long, conflicts_with = "json_rpc_socket")]
  24     pub json_rpc_http: Option<Option<String>>,
  25
  26     #[arg(long)]
  27     pub verbose: bool,
  28
  29     #[command(subcommand)]
  30     pub command: CliCommands,
  31 }
  32
  33 #[allow(clippy::large_enum_variant)]
  34 #[derive(Subcommand, Debug)]
  35 #[command(rename_all = "camelCase", version = crate_version!())]
  36 pub enum CliCommands {
  37     AddDevice {
  38         #[arg(long)]
  39         uri: String,
  40     },
  41     AddStickerPack {
  42         #[arg(long)]
  43         uri: String,
  44     },
  45     #[command(rename_all = "kebab-case")]
  46     Block {
  47         recipient: Vec<String>,
  48
  49         #[arg(short = 'g', long)]
  50         group_id: Vec<String>,
  51     },
  52     DeleteLocalAccountData {
  53         #[arg(long = "ignore-registered")]
  54         ignore_registered: Option<bool>,
  55     },
  56     FinishChangeNumber {
  57         number: String,
  58         #[arg(short = 'v', long = "verification-code")]
  59         verification_code: String,
  60
  61         #[arg(short = 'p', long)]
  62         pin: Option<String>,
  63     },
  64     GetAttachment {
  65         #[arg(long)]
  66         id: String,
  67         #[arg(long)]
  68         recipient: Option<String>,
  69         #[arg(short = 'g', long = "group-id")]
  70         group_id: Option<String>,
  71     },
  72     GetAvatar {
  73         #[arg(long)]
  74         contact: Option<String>,
  75         #[arg(long)]
  76         profile: Option<String>,
  77         #[arg(short = 'g', long = "group-id")]
  78         group_id: Option<String>,
  79     },
  80     GetSticker {
  81         #[arg(long = "pack-id")]
  82         pack_id: String,
  83         #[arg(long = "sticker-id")]
  84         sticker_id: u32,
  85     },
  86     GetUserStatus {
  87         recipient: Vec<String>,
  88         #[arg(long)]
  89         username: Vec<String>,
  90     },
  91     JoinGroup {
  92         #[arg(long)]
  93         uri: String,
  94     },
  95     Link {
  96         #[arg(short = 'n', long)]
  97         name: String,
  98     },
  99     ListAccounts,
 100     ListContacts {
 101         recipient: Vec<String>,
 102         #[arg(short = 'a', long = "all-recipients")]
 103         all_recipients: bool,
 104         #[arg(long)]
 105         blocked: Option<bool>,
 106         #[arg(long)]
 107         name: Option<String>,
 108     },
 109     ListDevices,
 110     ListGroups {
 111         #[arg(short = 'd', long)]
 112         detailed: bool,
 113         #[arg(short = 'g', long = "group-id")]
 114         group_id: Vec<String>,
 115     },
 116     ListIdentities {
 117         #[arg(short = 'n', long)]
 118         number: Option<String>,
 119     },
 120     ListStickerPacks,
 121     QuitGroup {
 122         #[arg(short = 'g', long = "group-id")]
 123         group_id: String,
 124         #[arg(long)]
 125         delete: bool,
 126         #[arg(long)]
 127         admin: Vec<String>,
 128     },
 129     Receive {
 130         #[arg(short = 't', long, default_value_t = 3.0)]
 131         timeout: f64,
 132     },
 133     Register {
 134         #[arg(short = 'v', long)]
 135         voice: bool,
 136         #[arg(long)]
 137         captcha: Option<String>,
 138     },
 139     RemoveContact {
 140         recipient: String,
 141         #[arg(long)]
 142         forget: bool,
 143         #[arg(long)]
 144         hide: bool,
 145     },
 146     RemoveDevice {
 147         #[arg(short = 'd', long = "device-id")]
 148         device_id: u32,
 149     },
 150     RemovePin,
 151     RemoteDelete {
 152         #[arg(short = 't', long = "target-timestamp")]
 153         target_timestamp: u64,
 154
 155         recipient: Vec<String>,
 156
 157         #[arg(short = 'g', long = "group-id")]
 158         group_id: Vec<String>,
 159
 160         #[arg(long = "note-to-self")]
 161         note_to_self: bool,
 162     },
 163     #[command(rename_all = "kebab-case")]
 164     Send {
 165         recipient: Vec<String>,
 166
 167         #[arg(short = 'g', long)]
 168         group_id: Vec<String>,
 169
 170         #[arg(long)]
 171         note_to_self: bool,
 172
 173         #[arg(short = 'e', long)]
 174         end_session: bool,
 175
 176         #[arg(short = 'm', long)]
 177         message: Option<String>,
 178
 179         #[arg(short = 'a', long)]
 180         attachment: Vec<String>,
 181
 182         #[arg(long)]
 183         view_once: bool,
 184
 185         #[arg(long)]
 186         mention: Vec<String>,
 187
 188         #[arg(long)]
 189         text_style: Vec<String>,
 190
 191         #[arg(long)]
 192         quote_timestamp: Option<u64>,
 193
 194         #[arg(long)]
 195         quote_author: Option<String>,
 196
 197         #[arg(long)]
 198         quote_message: Option<String>,
 199
 200         #[arg(long)]
 201         quote_mention: Vec<String>,
 202
 203         #[arg(long)]
 204         quote_text_style: Vec<String>,
 205
 206         #[arg(long)]
 207         quote_attachment: Vec<String>,
 208
 209         #[arg(long)]
 210         preview_url: Option<String>,
 211
 212         #[arg(long)]
 213         preview_title: Option<String>,
 214
 215         #[arg(long)]
 216         preview_description: Option<String>,
 217
 218         #[arg(long)]
 219         preview_image: Option<String>,
 220
 221         #[arg(long)]
 222         sticker: Option<String>,
 223
 224         #[arg(long)]
 225         story_timestamp: Option<u64>,
 226
 227         #[arg(long)]
 228         story_author: Option<String>,
 229
 230         #[arg(long)]
 231         edit_timestamp: Option<u64>,
 232     },
 233     SendContacts,
 234     SendPaymentNotification {
 235         recipient: String,
 236
 237         #[arg(long)]
 238         receipt: String,
 239
 240         #[arg(long)]
 241         note: String,
 242     },
 243     SendReaction {
 244         recipient: Vec<String>,
 245
 246         #[arg(short = 'g', long = "group-id")]
 247         group_id: Vec<String>,
 248
 249         #[arg(long = "note-to-self")]
 250         note_to_self: bool,
 251
 252         #[arg(short = 'e', long)]
 253         emoji: String,
 254
 255         #[arg(short = 'a', long = "target-author")]
 256         target_author: String,
 257
 258         #[arg(short = 't', long = "target-timestamp")]
 259         target_timestamp: u64,
 260
 261         #[arg(short = 'r', long)]
 262         remove: bool,
 263
 264         #[arg(long)]
 265         story: bool,
 266     },
 267     SendReceipt {
 268         recipient: String,
 269
 270         #[arg(short = 't', long = "target-timestamp")]
 271         target_timestamp: Vec<u64>,
 272
 273         #[arg(value_enum, long)]
 274         r#type: ReceiptType,
 275     },
 276     SendSyncRequest,
 277     SendTyping {
 278         recipient: Vec<String>,
 279
 280         #[arg(short = 'g', long = "group-id")]
 281         group_id: Vec<String>,
 282
 283         #[arg(short = 's', long)]
 284         stop: bool,
 285     },
 286     SendMessageRequestResponse {
 287         recipient: Vec<String>,
 288
 289         #[arg(short = 'g', long = "group-id")]
 290         group_id: Vec<String>,
 291
 292         r#type: MessageRequestResponseType,
 293     },
 294     SetPin {
 295         pin: String,
 296     },
 297     StartChangeNumber {
 298         number: String,
 299         #[arg(short = 'v', long)]
 300         voice: bool,
 301         #[arg(long)]
 302         captcha: Option<String>,
 303     },
 304     SubmitRateLimitChallenge {
 305         challenge: String,
 306         captcha: String,
 307     },
 308     Trust {
 309         recipient: String,
 310
 311         #[arg(short = 'a', long = "trust-all-known-keys")]
 312         trust_all_known_keys: bool,
 313
 314         #[arg(short = 'v', long = "verified-safety-number")]
 315         verified_safety_number: Option<String>,
 316     },
 317     #[command(rename_all = "kebab-case")]
 318     Unblock {
 319         recipient: Vec<String>,
 320
 321         #[arg(short = 'g', long)]
 322         group_id: Vec<String>,
 323     },
 324     Unregister {
 325         #[arg(long = "delete-account")]
 326         delete_account: bool,
 327     },
 328     UpdateAccount {
 329         #[arg(short = 'n', long = "device-name")]
 330         device_name: Option<String>,
 331         #[arg(long = "unrestricted-unidentified-sender")]
 332         unrestricted_unidentified_sender: Option<bool>,
 333         #[arg(long = "discoverable-by-number")]
 334         discoverable_by_number: Option<bool>,
 335         #[arg(long = "number-sharing")]
 336         number_sharing: Option<bool>,
 337     },
 338     UpdateConfiguration {
 339         #[arg(long = "read-receipts")]
 340         read_receipts: Option<bool>,
 341
 342         #[arg(long = "unidentified-delivery-indicators")]
 343         unidentified_delivery_indicators: Option<bool>,
 344
 345         #[arg(long = "typing-indicators")]
 346         typing_indicators: Option<bool>,
 347
 348         #[arg(long = "link-previews")]
 349         link_previews: Option<bool>,
 350     },
 351     UpdateContact {
 352         recipient: String,
 353
 354         #[arg(short = 'e', long)]
 355         expiration: Option<u32>,
 356
 357         #[arg(short = 'n', long)]
 358         name: Option<String>,
 359     },
 360     UpdateGroup {
 361         #[arg(short = 'g', long = "group-id")]
 362         group_id: Option<String>,
 363
 364         #[arg(short = 'n', long)]
 365         name: Option<String>,
 366
 367         #[arg(short = 'd', long)]
 368         description: Option<String>,
 369
 370         #[arg(short = 'a', long)]
 371         avatar: Option<String>,
 372
 373         #[arg(short = 'm', long)]
 374         member: Vec<String>,
 375
 376         #[arg(short = 'r', long = "remove-member")]
 377         remove_member: Vec<String>,
 378
 379         #[arg(long)]
 380         admin: Vec<String>,
 381
 382         #[arg(long = "remove-admin")]
 383         remove_admin: Vec<String>,
 384
 385         #[arg(long)]
 386         ban: Vec<String>,
 387
 388         #[arg(long)]
 389         unban: Vec<String>,
 390
 391         #[arg(long = "reset-link")]
 392         reset_link: bool,
 393
 394         #[arg(value_enum, long)]
 395         link: Option<LinkState>,
 396
 397         #[arg(value_enum, long = "set-permission-add-member")]
 398         set_permission_add_member: Option<GroupPermission>,
 399
 400         #[arg(value_enum, long = "set-permission-edit-details")]
 401         set_permission_edit_details: Option<GroupPermission>,
 402
 403         #[arg(value_enum, long = "set-permission-send-messages")]
 404         set_permission_send_messages: Option<GroupPermission>,
 405
 406         #[arg(short = 'e', long)]
 407         expiration: Option<u32>,
 408     },
 409     UpdateProfile {
 410         #[arg(long = "given-name")]
 411         given_name: Option<String>,
 412
 413         #[arg(long = "family-name")]
 414         family_name: Option<String>,
 415
 416         #[arg(long)]
 417         about: Option<String>,
 418
 419         #[arg(long = "about-emoji")]
 420         about_emoji: Option<String>,
 421
 422         #[arg(long = "mobile-coin-address", visible_alias = "mobilecoin-address")]
 423         mobile_coin_address: Option<String>,
 424
 425         #[arg(long)]
 426         avatar: Option<String>,
 427
 428         #[arg(long = "remove-avatar")]
 429         remove_avatar: bool,
 430     },
 431     UploadStickerPack {
 432         path: String,
 433     },
 434     Verify {
 435         verification_code: String,
 436
 437         #[arg(short = 'p', long)]
 438         pin: Option<String>,
 439     },
 440     Version,
 441 }
 442
 443 #[derive(ValueEnum, Clone, Debug)]
 444 #[value(rename_all = "kebab-case")]
 445 pub enum ReceiptType {
 446     Read,
 447     Viewed,
 448 }
 449
 450 #[derive(ValueEnum, Clone, Debug)]
 451 #[value(rename_all = "kebab-case")]
 452 pub enum LinkState {
 453     Enabled,
 454     EnabledWithApproval,
 455     Disabled,
 456 }
 457
 458 #[derive(ValueEnum, Clone, Debug)]
 459 #[value(rename_all = "kebab-case")]
 460 pub enum GroupPermission {
 461     EveryMember,
 462     OnlyAdmins,
 463 }
 464
 465 #[derive(ValueEnum, Clone, Debug)]
 466 #[value(rename_all = "kebab-case")]
 467 pub enum MessageRequestResponseType {
 468     Accept,
 469     Delete,
 470 }