thumbor 0.1.11

A Rust client for the Thumbor image service
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
54
55
56
57
58
59
60
61
62
63
64
65
66

use super::{Endpoint, EndpointBuilder};
use hmac::{digest::InvalidLength, Hmac, Mac};
use sha1::Sha1;

pub type HmacSha1 = Hmac<Sha1>;

#[derive(Default, Clone)]
pub enum Security {
    #[default]
    Unsafe,
    /// hmac is the signature that ensures [security](https://thumbor.readthedocs.io/en/latest/security.html)
    Hmac(HmacSha1),
}

impl TryFrom<String> for Security {
    type Error = InvalidLength;

    fn try_from(value: String) -> Result<Self, Self::Error> {
        let hmac = HmacSha1::new_from_slice(value.as_bytes())?;
        Ok(Security::Hmac(hmac))
    }
}

/// ```
/// use thumbor::Server;
///
/// let server = Server::new("http://localhost:8888", "my-security-key").unwrap();
/// ```
#[derive(Default, Clone)]
pub struct Server {
    pub origin: String,
    pub security: Security,
}

impl Server {
    pub fn new(origin: impl Into<String>, key: impl Into<String>) -> Result<Self, InvalidLength> {
        Ok(Server {
            origin: origin.into(),
            security: key.into().try_into()?,
        })
    }

    /// ```
    /// use thumbor::Server;
    ///
    /// // Don't use this in production !
    /// let server = Server::new_unsafe("http://localhost:8888");
    /// ```
    pub fn new_unsafe(origin: impl Into<String>) -> Self {
        Server {
            origin: origin.into(),
            security: Security::Unsafe,
        }
    }

    /// Create a new SettingsBuilder with the current Server.
    /// ```
    /// use thumbor::Server;
    ///
    /// let server = Server::new("http://localhost:8888", "my-security-key").unwrap();
    /// let builder = server.endpoint_builder();
    /// ```
    pub fn endpoint_builder(&self) -> EndpointBuilder {
        Endpoint::with_server(self.clone())
    }
}