ruma_events/room/message/
text.rs

Help
1use serde::{Deserialize, Serialize};
2
3#[cfg(feature = "unstable-msc4095")]
4use super::url_preview::UrlPreview;
5use super::FormattedBody;
6
7/// The payload for a text message.
8#[derive(Clone, Debug, Deserialize, Serialize)]
9#[cfg_attr(not(ruma_unstable_exhaustive_types), non_exhaustive)]
10pub struct TextMessageEventContent {
11    /// The body of the message.
12    pub body: String,
13
14    /// Formatted form of the message `body`.
15    #[serde(flatten)]
16    pub formatted: Option<FormattedBody>,
17
18    /// [MSC4095](https://github.com/matrix-org/matrix-spec-proposals/pull/4095)-style bundled url previews
19    #[cfg(feature = "unstable-msc4095")]
20    #[serde(
21        rename = "com.beeper.linkpreviews",
22        skip_serializing_if = "Option::is_none",
23        alias = "m.url_previews"
24    )]
25    pub url_previews: Option<Vec<UrlPreview>>,
26}
27
28impl TextMessageEventContent {
29    /// A convenience constructor to create a plain text message.
30    pub fn plain(body: impl Into<String>) -> Self {
31        let body = body.into();
32        Self {
33            body,
34            formatted: None,
35            #[cfg(feature = "unstable-msc4095")]
36            url_previews: None,
37        }
38    }
39
40    /// A convenience constructor to create an HTML message.
41    pub fn html(body: impl Into<String>, html_body: impl Into<String>) -> Self {
42        let body = body.into();
43        Self {
44            body,
45            formatted: Some(FormattedBody::html(html_body)),
46            #[cfg(feature = "unstable-msc4095")]
47            url_previews: None,
48        }
49    }
50
51    /// A convenience constructor to create a Markdown message.
52    ///
53    /// Returns an HTML message if some Markdown formatting was detected, otherwise returns a plain
54    /// text message.
55    #[cfg(feature = "markdown")]
56    pub fn markdown(body: impl AsRef<str> + Into<String>) -> Self {
57        if let Some(formatted) = FormattedBody::markdown(&body) {
58            Self::html(body, formatted.body)
59        } else {
60            Self::plain(body)
61        }
62    }
63}
ruma_events/room/message/text.rs

ruma_events/room/message/
text.rs
