#image #interop #client #international #framework #api #requests

iiif

A client library for the International Image Interoperability Framework (IIIF)

2 releases

0.1.1 Feb 28, 2020
0.1.0 Feb 26, 2020

#23 in #international

Apache-2.0

31KB
518 lines

IIIF

A rust client for the International Image Interoperability Framework.

For now only contains the Image API.

Install

[dependencies]
iiif = "0.1.0"

Usage

A convenience fetch function is provided and will create a new client for each request, it is advised to create a reusable client and pass that to the request function for multiple requests.

Fetch and write to file
let api = Image::new("https://ids.lib.harvard.edu/ids/iiif");
api.identifier("25286607");
let response = api.fetch()
                  .await
                  .unwrap();

// Write to foo.jpg
response.write_to_file("foo.jpg")
        .await
        .expect("Writing file to disk");
Reusable client requests
let client = Client::new();
let base = "https://ids.lib.harvard.edu/ids/iiif";
let mut images: Vec<Bytes> = Vec::new();

// Iterate through some images
let ids = ["25286607", "25286608", "25286609"];
for id in ids {
  let mut api = Image::new(base);
  api.identifier(id);
  let response = api.request(&client)
                    .await
                    .unwrap();
  images.push(response.image);
}

Dependencies

~7–11MB
~226K SLoC