A high-level, ergonomic Rust crate for interacting with the Uploadthing API.
If you're using Rust and want to use Uploadthing for file uploading, utapi-rs streamlines the process by providing a set of convenient functions mirroring Uploadthing's API.
Add the following to your Cargo.toml file to include utapi-rs as a dependency:
[dependencies]
utapi-rs = "0.1.0"
Below is a quick example of using utapi-rs to list files and delete a file.
use utapi_rs::{UtApi, ListFilesOpts, DeleteFileResponse};
#[tokio::main]
async fn main() {
// Assume `new` attempts to retrieve the API key from an environment variable.
let api = UtApi::new(None).expect("API key must be set");
// List the files
let opts = Some(ListFilesOpts {
limit: Some(10), // Just as an example, limits the results to 10 files
offset: None, // No offset for this example
});
match api.list_files(opts).await {
Ok(file_response) => println!("Files: {:?}", file_response),
Err(e) => eprintln!("Error listing files: {:?}", e),
}
// Delete a file
match api.delete_files(vec!["file_key_to_delete".to_string()]).await {
Ok(DeleteFileResponse { success }) => println!("Successfully deleted file: {}", success),
Err(e) => eprintln!("Error deleting file: {:?}", e),
}
}
Ensure that you have the tokio async runtime in your dependencies, as this library is designed to work asynchronously.
For security purposes, it is recommended not to hardcode the API key in your codebase. Instead, you should set it up as an environment variable:
# .env
UPLOADTHING_SECRET=sk_*************************
Make sure to load the .env file or export the environment variable for your runtime accordingly.
Contributions are welcome! Please read our contributing guidelines for more details.
utapi-rs is released under the MIT License. See the LICENSE file for details.
4 Aug 14, 2022
11 Sep 1, 2023
25 Dec 28, 2023
4 Feb 26, 2024
5 Nov 17, 2022
4 Feb 26, 2023
8 Jul 12, 2023
4 Nov 30, 2023
203 Dec 31, 2022
5 Dec 15, 2022
6 Dec 26, 2022
6 Jun 15, 2023
6 Apr 4, 2023
61 Jul 24, 2024
13 Dec 6, 2022
8 Dec 28, 2022
5 Aug 13, 2023
13 Oct 28, 2023
134 Jul 22, 2024