2 releases

0.0.2 Oct 31, 2023
0.0.1 Oct 29, 2023

#38 in #cloud-storage

Apache-2.0

26KB
650 lines

Gette-rs: Rust Downloader Library

Rust Version rust

Gette-rs is a versatile and high-performance Rust library designed for downloading files from various sources, including local files and cloud blob stores. This library is intended for developers who need a reliable and efficient way to fetch data from a wide range of sources while maintaining Rust's safety and performance standards.

Features

  • Source Agnostic: Gette-rs supports multiple sources, including local files, Amazon S3, Azure Blob Storage, Google Cloud Storage, GIT, and HTTP/HTTPS URLs.

  • Asynchronous: Take full advantage of Rust's asynchronous capabilities for concurrent and non-blocking operations.

  • Error Handling: Robust error handling to ensure the integrity of your downloads.

  • Extensible: Easily extend Gette-rs to support additional sources and protocols. Extending Gette-rs

Getting Started

Add Gette-rs to your project's Cargo.toml:

[dependencies]
gette = "0.1"

Basic Usage

Downloading a file is straightforward with Gette-rs:

use gette::RequestBuilder

fn main()  {
    let dest = "/tmp/readme.md";
    let source = "test-bucket.amazonaws.com/test.txt";
    // this will automatically download the file from s3 to the local file system
    let builder = RequestBuilder::builder().src(source.to_string()).dest(dest).get().await.unwrap();
    println!("File downloaded successfully!");
    Ok(())
}

For more advanced usage, including cloud storage integration, please refer to the official documentation.

Contributing

Gette-rs is an open-source project, and we welcome contributions from the community. If you find a bug, have a feature request, or want to contribute code, please file an issue/PR.

Contact

If you have questions or need assistance, feel free to contact us via email or open an issue.


Thank you for choosing Gette-rs! We hope this library serves you well in your Rust project. Your feedback and contributions are highly appreciated.

Dependencies

~30MB
~489K SLoC