Skip to content

Latest commit

 

History

History
35 lines (24 loc) · 1.21 KB

README.md

File metadata and controls

35 lines (24 loc) · 1.21 KB

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.