iars 0.1.0

A synchronous (blocking) client written purely in Rust, for interfacing with Internet Archive APIs.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

use ureq::Request;

#[derive(Debug, Clone, PartialEq)]
pub enum Header {
    /// Normally added automatically when sending bytes.
    ContentLength(usize),
    Authorization {
        access: String,
        secret: String,
    },
    ContentType(String),
    ContentMd5(String),
    
    XAutoMakeBucket(bool),
    XCascadeDelete(bool),
    XIgnorePreexistingBucket(bool),
    XKeepOldVersion(bool),
    XMeta {
        name: String,
        value: String,
    },
    XQueueDerive(bool),
    XSizeHint(usize),
    
    Custom(String, String),
}

pub trait RequestHeaderExt {
    /// Set a header field used by Internet Archive's S3-like API.
    fn set_header(self, header: Header) -> Self;
}
impl RequestHeaderExt for Request {
    fn set_header(self, header: Header) -> Self {
        use Header::*;
        
        match header {
            ContentLength(val) => self.set("content-length", &val.to_string()),
            Authorization { access, secret } => self.set("authorization", &format!("LOW {access}:{secret}")),
            ContentType(val) => self.set("content-type", &val),
            ContentMd5(val) => self.set("content-md5", &val),
            
            XAutoMakeBucket(val) => self.set("x-amz-auto-make-bucket", &(val as u8).to_string()),
            XCascadeDelete(val) => self.set("x-archive-cascade-delete", &(val as u8).to_string()),
            XIgnorePreexistingBucket(val) => self.set("x-archive-ignore-preexisting-bucket", &(val as u8).to_string()),
            XKeepOldVersion(val) => self.set("x-archive-keep-old-version", &(val as u8).to_string()),
            XMeta { name, value } => self.set(format!("x-archive-meta-{name}").as_str(), &value),
            XQueueDerive(val) => self.set("x-archive-queue-derive", &(val as u8).to_string()),
            XSizeHint(val) => self.set("x-archive-size-hint", &val.to_string()),
            
            Custom(key, val) => self.set(key.as_str(), &val),
        }
    }
}