slack-messaging 0.7.3

Support building Slack Block Kit message
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
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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142

use serde::Serialize;

/// Builders for blocks.
pub mod builders;
/// Objects from which blocks are composed.
pub mod elements;
/// Module for building [RichText] block.
pub mod rich_text;
/// Module for building [Table] block.
pub mod table;

mod actions;
mod context;
mod context_actions;
mod divider;
mod file;
mod header;
mod image;
mod input;
mod markdown;
mod section;
mod task_card;
mod video;

pub use actions::{Actions, ActionsElement};
pub use context::{Context, ContextElement};
pub use context_actions::{ContextActions, ContextActionsElement};
pub use divider::Divider;
pub use file::{File, FileSource};
pub use header::Header;
pub use image::Image;
pub use input::{Input, InputElement};
pub use markdown::Markdown;
pub use rich_text::RichText;
pub use section::{Accessory, Section};
pub use table::Table;
pub use task_card::{TaskCard, TaskStatus};
pub use video::Video;

/// Objects that can be set to blocks in [Message](crate::message::Message).
#[derive(Debug, Clone, Serialize, PartialEq)]
#[serde(untagged)]
pub enum Block {
    /// [Actions block](https://docs.slack.dev/reference/block-kit/blocks/actions-block) representation
    Actions(Box<Actions>),

    /// [Context block](https://docs.slack.dev/reference/block-kit/blocks/context-block) representation
    Context(Box<Context>),

    /// [Context actions block](https://docs.slack.dev/reference/block-kit/blocks/context-actions-block) representation
    ContextActions(Box<ContextActions>),

    /// [Divider block](https://docs.slack.dev/reference/block-kit/blocks/divider-block) representation
    Divider(Box<Divider>),

    /// [File block](https://docs.slack.dev/reference/block-kit/blocks/file-block) representation
    File(Box<File>),

    /// [Header block](https://docs.slack.dev/reference/block-kit/blocks/header-block) representation
    Header(Box<Header>),

    /// [Image block](https://docs.slack.dev/reference/block-kit/blocks/image-block) representation
    Image(Box<Image>),

    /// [Input block](https://docs.slack.dev/reference/block-kit/blocks/input-block) representation
    Input(Box<Input>),

    /// [Markdown block](https://docs.slack.dev/reference/block-kit/blocks/markdown-block) representation
    Markdown(Box<Markdown>),

    /// [Rich text block](https://docs.slack.dev/reference/block-kit/blocks/rich-text-block) representation
    RichText(Box<RichText>),

    /// [Section block](https://docs.slack.dev/reference/block-kit/blocks/section-block) representation
    Section(Box<Section>),

    /// [Table block](https://docs.slack.dev/reference/block-kit/blocks/table-block) representation
    Table(Box<Table>),

    /// [Video block](https://docs.slack.dev/reference/block-kit/blocks/video-block) representation
    Video(Box<Video>),
}

macro_rules! block_from {
    ($($ty:ident,)*) => {
        $(
            impl From<$ty> for Block {
                fn from(value: $ty) -> Self {
                    Self::$ty(Box::new(value))
                }
            }
         )*
    }
}

block_from! {
    Actions,
    Context,
    ContextActions,
    Divider,
    File,
    Header,
    Image,
    Input,
    Markdown,
    RichText,
    Section,
    Table,
    Video,
}

#[cfg(test)]
pub mod test_helpers {
    use super::rich_text::test_helpers as rich_text_helper;
    use super::rich_text::types::test_helpers::*;
    use super::*;
    use crate::composition_objects::test_helpers::*;

    pub fn header(text: impl Into<String>) -> Header {
        Header {
            block_id: None,
            text: Some(plain_text(text)),
        }
    }

    pub fn section(text: impl Into<String>) -> Section {
        Section {
            block_id: None,
            text: Some(mrkdwn_text(text).into()),
            fields: None,
            accessory: None,
            expand: None,
        }
    }

    pub fn rich_text() -> RichText {
        RichText {
            block_id: Some("rich_text_0".into()),
            elements: Some(vec![rich_text_helper::section(vec![el_text("foo")]).into()]),
        }
    }
}