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

use serde::{Deserialize, Serialize};

pub mod validation {
    use crate::val_helpr::error;
    use validator::ValidationError;
    type ValidationResult = Result<(), ValidationError>;

    pub fn text_max_len(text: &super::Text, max_len: usize) -> ValidationResult {
        let len = text.text().chars().count();

        if len > max_len {
 	    let message = format!(
                "Section#text has max len of {}, but got text of len {}.",
                max_len, len
            );

            Err(error("text_max_len", message))
        } else {
            Ok(())
        }
    }
}

/// # Text Object
/// [_slack api docs 🔗_](https://api.slack.com/reference/block-kit/composition-objects#text)
///
/// An object containing some text,
/// formatted either as `plain_text`
/// or using [`mrkdwn` 🔗](https://api.slack.com/reference/surfaces/formatting),
/// our proprietary textual markup that's just different enough
/// from Markdown to frustrate you.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "type")]
pub enum Text {
    /// ## Markdown text
    /// [_for more info, check out the slack api docs 🔗_](https://api.slack.com/reference/surfaces/formatting)
    ///
    /// ### Reserved Characters
    ///
    /// Slack uses the following special characters,
    /// and recommends you HTML escape them like so:
    ///
    /// <details>
    /// <summary><b>➤ Click to expand</b></summary>
    ///
    /// |character|how to escape|
    /// |---      |---          |
    /// |`&`      |`&amp;`      |
    /// |`<`      |`&lt;`       |
    /// |`>`      |`&gt;`       |
    /// </details>
    ///
    /// ### Basic Formatting
    ///
    /// NOTE: This is **not** an exhaustive list
    ///
    /// This should, however, capture most basic
    /// use cases without requiring that you check with
    /// the Slack documentation.
    ///
    /// For more info, please visit
    /// [Slack's docs for markdown formatting 🔗](https://api.slack.com/reference/surfaces/formatting)
    ///
    /// <details>
    /// <summary><b>➤ Click to expand</b></summary>
    ///
    /// <!-- markdown tables strike again! -->
    /// |slack markdown    |formatted result     |
    /// |---               |---                  |
    /// |`_italic_`        |_italic_             |
    /// |`*bold*`          |**bold**             |
    /// |`~strike~`        |<del>strike</del>    |
    /// |`\n`              |line break           |
    /// |`> a block quote` | <blockquote> a block quote </blockquote> |
    /// |`` `some code!` ``| `some code!`        |
    /// |`` ```multiline code\n2 lines!``` `` | <code>multiline code<br> 2 lines!</code> |
    /// |` - li \n - li `  | <ul><li>li</li><li>li</li></ul> |
    /// |<code>&lt;http://www.foo.com&#124;link name&gt;</code>| [link name](http://www.foo.com) |
    /// |`:joy:` (list from [iamcal/emoji-data 🔗](https://github.com/iamcal/emoji-data)) | 😂 |
    /// | link to #channel: `<#Cxxxxxx>` | [#channel](https://work.slack.com/some-public-channel) |
    /// | link to @user: `<@Uxxxxxx>` | [@user](https://work.slack.com/some-user) |
    /// | link to @user_group: `<!subteam^xxxxxx>` | [@user_group](https://work.slack.com/some-user-group) |
    /// </details>
    #[serde(rename = "mrkdwn")]
    Markdown {
        /// The text for the block.
        ///
        /// This field accepts any of the [standard text formatting markup](#markdown-text)
        text: String,
        /// When set to false (as is default)
        /// URLs will be auto-converted into links,
        /// conversation names will be link-ified,
        /// and certain mentions will be automatically parsed.
        ///
        /// Using a value of true will skip any preprocessing
        /// of this nature, although you can
        /// still include manual parsing strings.
        verbatim: Option<bool>,
    },
    #[serde(rename = "plain_text")]
    Plain {
        /// The text for the block
        text: String,
        /// Indicates whether emojis in a text field
        /// should be escaped into the colon emoji format
        emoji: Option<bool>,
    },
}

impl Text {
    pub fn plain(text: String) -> Text {
        Text::Plain { text, emoji: None }
    }

    pub fn markdown(text: String) -> Text {
        Text::Markdown {
            text,
            verbatim: None,
        }
    }

    pub fn text(&self) -> &str {
        use Text::*;

        match self {
            Plain { text, .. } => text,
            Markdown { text, .. } => text,
        }
    }
}