bujnlc8 / qcos

腾讯云对象存储(COS) Rust

腾讯云对象存储(COS) Rust

本包提供腾讯云对象存储(cos) 基本的操作，包括bucket创建及删除，对象的上传、下载、删除等。

上传文件支持以下特点:

• 支持文件直传，推荐 1GB 以下的文件

• 支持分块传输，设置分块大小和最大上传线程数量

• 支持显示上传进度条(需开启progress-bar feature)，上传方法名称加了_progress_bar后缀与不显示进度条的方法区分

从0.1.9版本之后，下载文件也支持显示进度条 🚀🚀🚀

How to use

use std::path::PathBuf;
use qcos::acl::{AclHeader, ObjectAcl};
use qcos::client::Client;
use qcos::objects::{mime, ErrNo};

#[tokio::main]
async fn main() {
    let client = Client::new(
        "Your secrect id",
        "Your secrect key",
        "bucket name",
        "region",
    );
    let mut acl_header = AclHeader::new();
    acl_header.insert_object_x_cos_acl(ObjectAcl::PublicRead);
    let file_path = PathBuf::from("test.png");
    let res = client.put_object(&file_path, "test.png", Some(mime::IMAGE_PNG), Some(acl_header)).await;
    if res.error_no == ErrNo::SUCCESS {
        println!("success");
    } else {
        println!("{}", res.error_message);
    }
    // 分块上传，带进度条
    #[cfg(feature = "progress-bar")]
    let res = client
        .clone()
        .put_big_object_progress_bar(
            &file_path,
            "test.png",
            None,
            Some(qcos::objects::StorageClassEnum::ARCHIVE),
            None,
            Some(1024 * 1024),
            None,
            None,
        )
        .await;

    // 下载文件到本地，启用10个线程，并开启进度条
    #[cfg(feature = "progress-bar")]
    let res = client
        .get_object_progress_bar("Cargo.toml", "local_Cargo.toml", Some(10), None)
        .await;
}

更多的例子请参考examples。

Installation

[dependencies]
qcos = "0.1.12"

如果需要开启显示进度条的方法:

[dependencies]
qcos = {version = "0.1.12", features=["progress-bar"]}