prefixload 0.12.3

S3 cli backup by file name prefix
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

pub mod commands;

use crate::error::Result;
use clap::{Args, Parser, Subcommand};
use std::path::PathBuf;

/// Nested subcommands for the `config` command.
/// Allows you to show, edit, and modify specific config fields.
#[derive(Subcommand, Debug, PartialEq)]
pub enum ConfigCommand {
    /// Show current configuration file content
    Show,
    /// Open configuration file in the default system editor ($EDITOR)
    Edit,
    /// Update one or more top-level fields in the config
    Set(ConfigSetArgs),
    /// Add an entry to the 'directory_struct' array
    DirAdd(DirectoryAddArgs),
    /// Remove an entry from 'directory_struct' by local_name_prefix
    DirRm(DirectoryRemoveArgs),
}

/// Arguments for the 'config set' subcommand.
/// Each field corresponds to a top-level config property.
#[derive(Args, Debug, PartialEq)]
pub struct ConfigSetArgs {
    /// S3 endpoint URL (e.g., https://s3.amazonaws.com)
    #[arg(long)]
    pub endpoint: Option<String>,
    /// S3 bucket name to use for backups
    #[arg(long)]
    pub bucket: Option<String>,
    /// The AWS region to use
    #[arg(long)]
    pub region: Option<String>,
    /// Force path-style addressing (for MinIO, etc.)
    #[arg(long)]
    pub force_path_style: Option<bool>,
    /// Size of each upload part in bytes (default: 5MB)
    #[arg(long)]
    pub part_size: Option<u64>,
    /// Local directory path to scan for files
    #[arg(long)]
    pub local_directory_path: Option<PathBuf>,
}

/// Arguments for the 'config directory-add' subcommand.
/// Adds a new directory mapping.
#[derive(Args, Debug, PartialEq)]
pub struct DirectoryAddArgs {
    pub local_name_prefix: String,
    pub remote_path: String,
}

/// Arguments for the 'config directory-remove' subcommand.
/// Removes an entry by its local_name_prefix.
#[derive(Args, Debug, PartialEq)]
pub struct DirectoryRemoveArgs {
    pub local_name_prefix: String,
}

/// Top-level application subcommands
#[derive(Subcommand, Debug, PartialEq)]
pub enum Commands {
    /// Configuration management entrypoint.
    /// This variant accepts nested config subcommands.
    Config {
        #[command(subcommand)]
        command: ConfigCommand,
    },
    /// Store your S3 credentials securely
    Login,
    /// Run the main backup operation (with optional 'quiet' mode)
    Run {
        #[arg(short, long, default_value_t = false)]
        quiet: bool,
    },
    /// Schedule a backup job using a cron expression
    Schedule { cron: String },
}

/// Application entrypoint.
/// This struct represents the full CLI and top-level command parsing.
#[derive(Parser, Debug, PartialEq)]
#[command(name = "prefixload")]
#[command(about = "S3 cli backup by file name prefix")]
#[command(version)]
pub struct Cli {
    #[command(subcommand)]
    command: Commands,
}

impl Cli {
    /// Dispatch the parsed CLI command to the appropriate handler.
    /// Returns a Result with a String (output message or error).
    pub async fn run(self) -> Result<String> {
        match self.command {
            Commands::Config { command } => commands::config::run(command).await,
            Commands::Login => commands::login::run().await,
            Commands::Run { quiet } => commands::run::run(quiet).await,
            Commands::Schedule { cron } => commands::schedule::run(cron.as_ref()).await,
        }
    }

    /// Returns a reference to the parsed command.
    ///
    /// This method provides access to the command that was parsed from
    /// the command-line arguments. Useful for testing and introspection.
    pub fn get_command(&self) -> &Commands {
        &self.command
    }
}