nextcloud-preview 0.1.3

Nextcloud preview and thumbnail generation client
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

//! Preview scaling modes for Nextcloud thumbnails.

use std::fmt;

/// Scaling mode for generating previews.
///
/// Controls how Nextcloud resizes or crops the image when generating a thumbnail
/// with dimensions that do not match the original aspect ratio.
///
/// See the Nextcloud preview endpoint parameters for details.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum PreviewMode {
    /// Scale image to fill dimensions and crop excess to fit the requested box.
    Cover,
    /// Scale image to fit within dimensions without cropping (preserving aspect ratio).
    Fill,
}

impl PreviewMode {
    /// Returns the wire parameter string for this preview mode.
    pub const fn as_str(self) -> &'static str {
        match self {
            Self::Cover => "cover",
            Self::Fill => "fill",
        }
    }
}

impl fmt::Display for PreviewMode {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.write_str(self.as_str())
    }
}

#[cfg(test)]
mod tests {
    use super::PreviewMode;

    #[test]
    fn as_str_returns_expected_wire_values() {
        assert_eq!(PreviewMode::Cover.as_str(), "cover");
        assert_eq!(PreviewMode::Fill.as_str(), "fill");
    }

    #[test]
    fn display_matches_as_str() {
        assert_eq!(PreviewMode::Cover.to_string(), "cover");
        assert_eq!(PreviewMode::Fill.to_string(), "fill");
    }

    #[test]
    fn equality_and_copy() {
        let mode = PreviewMode::Cover;
        let copied = mode;
        assert_eq!(mode, copied);
        assert_ne!(mode, PreviewMode::Fill);
    }
}