129 stable releases (16 major)

new 59.1.0 Dec 6, 2023
58.0.2 Nov 22, 2023
57.1.0 Nov 2, 2023
56.0.3 Oct 18, 2023
43.2.0 Apr 28, 2021

#87 in Testing

Download history 121/week @ 2023-08-15 213/week @ 2023-08-22 67/week @ 2023-08-29 196/week @ 2023-09-05 121/week @ 2023-09-12 219/week @ 2023-09-19 76/week @ 2023-09-26 60/week @ 2023-10-03 158/week @ 2023-10-10 192/week @ 2023-10-17 87/week @ 2023-10-24 239/week @ 2023-10-31 14/week @ 2023-11-07 151/week @ 2023-11-14 228/week @ 2023-11-21 279/week @ 2023-11-28

672 downloads per month

MPL-2.0 license

5.5K SLoC

Taskcluster Upload Support

This library is a companion to the [docs.rs](https://docs.rs/taskcluster) Taskcluster client, with support for uploading objects.


See docs.rs for detailed usage information.


This library is co-versioned with Taskcluster itself. That is, a client with version x.y.z contains API methods corresponding to Taskcluster version x.y.z. Taskcluster is careful to maintain API compatibility, and guarantees it within a major version. That means that any client with version x.* will work against any Taskcluster services at version x.*, and is very likely to work for many other major versions of the Taskcluster services. Any incompatibilities are noted in the Changelog.


Support for uploading data to the Taskcluster object server.

This crate provides a set of functions to perform an object-service upload. These functions negotiate an upload method with the object service, and then perform the upload, following all of the Taskcluster recommended practices.

Each function takes the necessary metadata for the upload, a handle to the data to be uploaded, and a taskcluster::Object client. The data to be uploaded can come in a variety of forms, described below. The client must be configured with the necessary credentials to access the object service.

Convenience Functions

Most uses of this crate can utilize [upload_from_buf] or [upload_from_file], providing the data in the form of a buffer and a tokio::fs::File, respectively.


An upload may be retried, in which case the upload function must have access to the object data from the beginning. This is accomplished with the AsyncReaderFactory trait, which defines a get_reader method to generate a fresh tokio::io::AsyncRead for each attempt. Users for whom the supplied convenience functions are inadequate can add their own implementation of this trait.


~501K SLoC