tus_async_client 0.2.0

A Rust native async client library to interact with *tus* enabled endpoints.
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

# tus_async_client


Fork of [tus_client](https://github.com/rambus-dumbledore/tus_async_client)

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

## Usage


Create an instance of the `tus_client::Client` struct.

```rust
use tus_async_client::{Client, HttpHandler};
use reqwest;
use std::rc::Rc;

let client = Client::new(Rc::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.

```rust
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`.

```rust
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.