bucket
Gleam S3 API client, suitable for AWS S3, Garage, Minio, Storj, Backblaze B2, Cloudflare R2, Ceph, Wasabi, and so on!
This package uses the sans-io approach, meaning it does not send HTTP requests itself, instead it gives you functions for creating HTTP requests for and decoding HTTP responses from an S3 API, and you send the requests with a HTTP client of your choosing.
This HTTP client independence gives you full control over HTTP, and means this library can be used on both the Erlang and JavaScript runtimes.
gleam add bucket@1
import bucket
import bucket/get_object.{Found}
import gleam/bit_array
import gleam/http.{Https}
import gleam/io
import httpc
/// This program downloads an object and prints the string contents.
///
/// It uses `let assert` to handle errors, but in a real program you'd most
/// likely want to use pattern matching or the `gleam/result` module to handle
/// the error values gracefully.
///
pub fn main() {
let creds = bucket.credentials(
host: "s3-api-host.example.com",
access_key_id: "YOUR_ACCESS_KEY",
secret_access_key: "YOUR_SECRET_ACCESS_KEY",
)
// Create a HTTP request to download an object
let request =
get_object.request(bucket: "my-bucket", key: "my/key.txt")
|> get_object.build()
// Send the HTTP request
let assert Ok(response) = httpc.send_bits(request)
// Decode the response from the API
let assert Ok(Found(object)) = get_object.response(response)
// Print the string contents
let assert Ok(text) = bit_array.from_string(object)
io.println(text)
}
Further documentation can be found at https://hexdocs.pm/bucket.