Taskcluster 上传支持

此库是 Taskcluster 客户端的配套库，支持上传对象。

用法

有关详细用法信息，请参阅 docs.rs。

兼容性

此库与 Taskcluster 本身协同版本化。也就是说，版本为 x.y.z 的客户端包含与 Taskcluster 版本 x.y.z 对应的 API 方法。Taskcluster 会注意保持 API 兼容性，并在主要版本内保证其兼容性。这意味着任何版本为 x.* 的客户端都可以针对任何版本为 x.* 的 Taskcluster 服务运行，并且很可能适用于许多其他主要版本的 Taskcluster 服务。任何不兼容性将在 变更日志 中注明。

lib.rs:

支持将数据上传到 Taskcluster 对象服务器。

此 crate 提供了一组函数来执行对象服务上传。这些函数与对象服务协商上传方法，然后执行上传，遵循所有 Taskcluster 推荐的最佳实践。

每个函数都接受上传所需的必要元数据、要上传的数据的句柄以及一个 taskcluster::Object 客户端。要上传的数据可以有多种形式，如下所述。客户端必须配置必要的凭证以访问对象服务。

便捷函数

此 crate 的大多数用法可以利用 [upload_from_buf] 或 [upload_from_file]，分别提供缓冲区和 tokio::fs::File。

工厂

上传可能需要重试，在这种情况下，上传功能必须从开始就有访问对象数据的权限。这通过AsyncReaderFactory特征实现，该特征定义了一个get_reader方法来为每次尝试生成一个新的tokio::io::AsyncRead。对于提供的便捷函数不足以使用的用户，可以添加他们自己的该特征实现。