#async-client #tus #upload #async #resumable #file-upload #file-server

tus_async_client

A Rust native async client library to interact with *tus* enabled endpoints

3 unstable releases

0.2.1 Jun 24, 2022
0.2.0 Jun 24, 2022
0.1.0 Jul 30, 2021

#1167 in Asynchronous

43 downloads per month

MIT license

24KB
403 lines

tus_async_client

Fork of tus_client

A Rust native async client library to interact with tus enabled endpoints.

Usage

Create an instance of the tus_async_client::Client struct.

use tus_async_client::{Client, HttpHandler};
use reqwest;
use std::sync::Arc;

let client = Client::new(Arc::new(reqwest::Client::new()));

You'll need an upload URL to be able to upload a files. This may be provided to you (through a separate API, for example), or you might need to create the file through the tus protocol. If an upload URL is provided for you, you can skip this step.

let upload_url = client
    .create("https://my.tus.server/files/", "/path/to/file").await?
    .expect("Failed to create file on server");

Next, you can start uploading the file by calling upload. The file will be uploaded in 5 MiB chunks by default. To customize the chunk size, use upload_with_chunk_size instead of upload.

client
    .upload(&upload_url, "/path/to/file").await?
    .expect("Failed to upload file to server");

upload (and upload_with_chunk_size) will automatically resume the upload from where it left off, if the upload transfer is interrupted.

Dependencies

~3–17MB
~233K SLoC