rustfs-cli 0.1.13

A Rust S3 CLI client for S3-compatible object storage
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

//! object command group - Noun-first object workflows.
//!
//! Provides an agent-friendly object-oriented entrypoint while delegating to the
//! existing command implementations.

use clap::{Args, Subcommand};

use crate::exit_code::ExitCode;
use crate::output::OutputConfig;

use super::{cat, cp, find, head, ls, mv, rm, share, stat, tree};

const OBJECT_AFTER_HELP: &str = "\
Examples:
  rc object list local/my-bucket/logs/
  rc object copy ./report.json local/my-bucket/reports/
  rc object show local/my-bucket/report.json
  rc object remove local/my-bucket/report.json --dry-run
  rc object share local/my-bucket/report.json --expire 1d";

/// Manage object-oriented workflows
#[derive(Args, Debug)]
#[command(after_help = OBJECT_AFTER_HELP)]
pub struct ObjectArgs {
    #[command(subcommand)]
    pub command: ObjectCommands,
}

#[derive(Subcommand, Debug)]
pub enum ObjectCommands {
    /// List objects within a bucket path
    #[command(alias = "ls")]
    List(ls::LsArgs),

    /// Copy objects between local and remote locations
    Copy(cp::CpArgs),

    /// Move objects between local and remote locations
    Move(mv::MvArgs),

    /// Remove objects
    Remove(rm::RmArgs),

    /// Show object metadata
    Stat(stat::StatArgs),

    /// Print the full object body
    Show(cat::CatArgs),

    /// Print the first lines or bytes of an object
    Head(head::HeadArgs),

    /// Search for objects by filters
    Find(find::FindArgs),

    /// Display objects in a tree view
    Tree(tree::TreeArgs),

    /// Generate a presigned object URL
    Share(share::ShareArgs),
}

/// Execute the object command group
pub async fn execute(args: ObjectArgs, output_config: OutputConfig) -> ExitCode {
    match args.command {
        ObjectCommands::List(args) => ls::execute(args, output_config).await,
        ObjectCommands::Copy(args) => cp::execute(args, output_config).await,
        ObjectCommands::Move(args) => mv::execute(args, output_config).await,
        ObjectCommands::Remove(args) => rm::execute(args, output_config).await,
        ObjectCommands::Stat(args) => stat::execute(args, output_config).await,
        ObjectCommands::Show(args) => cat::execute(args, output_config).await,
        ObjectCommands::Head(args) => head::execute(args, output_config).await,
        ObjectCommands::Find(args) => find::execute(args, output_config).await,
        ObjectCommands::Tree(args) => tree::execute(args, output_config).await,
        ObjectCommands::Share(args) => share::execute(args, output_config).await,
    }
}