lists3 0.1.1

Light-weight CLI tool to create a file browser for S3 buckets provisioning bucket listing.
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

#![allow(rustdoc::bare_urls)]
#![doc = include_str!("../README.md")]


use aws_config::Region;

mod templates;
mod squire;
mod aws;

/// Generates the HTML file required with template.
///
/// # Arguments
///
/// * `config` - Configuration settings passed as flags or env vars.
/// * `region` - Reference to the AWS region object.
/// * `metadata` - Project's metadata information stored as a struct.
///
/// # Returns
///
/// Returns a `String` response of the HTML page.
async fn generate_html(
    config: &squire::settings::Config,
    region: &Region,
    metadata: &squire::constant::MetaData
) -> String {
    let jinja = templates::environment();
    let template_string = format!("list-s3-{}", config.style);
    let list_object = jinja.get_template(template_string.as_str()).unwrap();
    let html_data = list_object.render(minijinja::context!(
        bucket_name => config.bucket,
        region_name => region.to_string(),
        folder_names => config.filter,
        ignore_objects => config.ignore,
        cargo_version => metadata.pkg_version
    ));
    html_data.unwrap()
}

/// Initializes the application and uploads the generated HTML to S3.
pub async fn initiate() {
    let metadata = squire::constant::build_info();
    let config = squire::parser::arguments(&metadata);

    let region = aws::get_region(&config).await;
    let aws_client = aws::get_client(&region).await;

    let mut bucket_names = Vec::new();
    match aws::get_buckets(&aws_client).await {
        Some(buckets) => {
            for bucket in buckets {
                bucket_names.push(bucket.name.unwrap());
            }
        }
        None => {
            eprintln!("Failed to fetch S3 buckets.");
            std::process::exit(1)
        }
    }
    if !bucket_names.contains(&config.bucket) {
        eprintln!("\n{:?}\n\tBucket name is invalid.\n\tExpected one of {:?}\n",
                  &config.bucket, bucket_names);
        std::process::exit(1)
    }
    let data = generate_html(&config, &region, &metadata).await;
    aws::upload_object(&aws_client, &config.bucket, &data, &config.object).await;
    aws::update_cors(&aws_client, &config.bucket, &config.website).await;
}