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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

use serde::Serialize;

/// [Image element](https://api.slack.com/reference/block-kit/block-elements#image)
/// representation.
///
/// # Example
///
/// ```
/// use slack_messaging::blocks::elements::Image;
/// use serde_json::json;
///
/// let image = Image::new()
///     .set_image_url("http://placekitten.com/700/500")
///     .set_alt_text("Multiple cute kittens");
///
/// let expected = json!({
///     "type": "image",
///     "image_url": "http://placekitten.com/700/500",
///     "alt_text": "Multiple cute kittens"
/// });
///
/// let image_json = serde_json::to_value(image).unwrap();
///
/// assert_eq!(image_json, expected);
/// ```
#[derive(Debug, Clone, Serialize)]
pub struct Image {
    #[serde(rename = "type")]
    kind: &'static str,

    image_url: String,

    alt_text: String,
}

impl Default for Image {
    fn default() -> Self {
        Self {
            kind: "image",
            image_url: "".into(),
            alt_text: "".into(),
        }
    }
}

impl Image {
    /// Constructs a Image element with empty values.
    ///
    /// ```
    /// use slack_messaging::blocks::elements::Image;
    /// use serde_json::json;
    ///
    /// let image = Image::new();
    ///
    /// let expected = json!({
    ///     "type": "image",
    ///     "image_url": "",
    ///     "alt_text": ""
    /// });
    ///
    /// let image_json = serde_json::to_value(image).unwrap();
    ///
    /// assert_eq!(image_json, expected);
    /// ```
    pub fn new() -> Self {
        Self::default()
    }

    /// Sets image_url field.
    ///
    /// ```
    /// use slack_messaging::blocks::elements::Image;
    /// use serde_json::json;
    ///
    /// let image = Image::new().set_image_url("http://placekitten.com/700/500");
    ///
    /// let expected = json!({
    ///     "type": "image",
    ///     "image_url": "http://placekitten.com/700/500",
    ///     "alt_text": ""
    /// });
    ///
    /// let image_json = serde_json::to_value(image).unwrap();
    ///
    /// assert_eq!(image_json, expected);
    /// ```
    pub fn set_image_url<T: Into<String>>(self, url: T) -> Self {
        Self {
            image_url: url.into(),
            ..self
        }
    }

    /// Sets alt_text field.
    ///
    /// ```
    /// use slack_messaging::blocks::elements::Image;
    /// use serde_json::json;
    ///
    /// let image = Image::new().set_alt_text("Multiple cute kittens");
    ///
    /// let expected = json!({
    ///     "type": "image",
    ///     "image_url": "",
    ///     "alt_text": "Multiple cute kittens"
    /// });
    ///
    /// let image_json = serde_json::to_value(image).unwrap();
    ///
    /// assert_eq!(image_json, expected);
    /// ```
    pub fn set_alt_text<T: Into<String>>(self, alt: T) -> Self {
        Self {
            alt_text: alt.into(),
            ..self
        }
    }
}