use internal::prelude::*; use model::channel::ReactionType; use std::fmt::Display; use super::CreateEmbed; use utils::{self, VecMap}; /// A builder to specify the contents of an [`http::send_message`] request, /// primarily meant for use through [`ChannelId::send_message`]. /// /// There are two situations where different field requirements are present: /// /// 1. When sending an [`embed`], no other field is required; /// 2. Otherwise, [`content`] is the only required field that is required to be /// set. /// /// Note that if you only need to send the content of a message, without /// specifying other fields, then [`ChannelId::say`] may be a more preferable /// option. /// /// # Examples /// /// Sending a message with a content of `"test"` and applying text-to-speech: /// /// ```rust,no_run /// use serenity::model::id::ChannelId; /// /// let channel_id = ChannelId(7); /// /// let _ = channel_id.send_message(|m| m /// .content("test") /// .tts(true) /// .embed(|e| e /// .title("This is an embed") /// .description("With a description"))); /// ``` /// /// [`ChannelId::say`]: ../model/id/struct.ChannelId.html#method.say /// [`ChannelId::send_message`]: ../model/id/struct.ChannelId.html#method.send_message /// [`content`]: #method.content /// [`embed`]: #method.embed /// [`http::send_message`]: ../http/fn.send_message.html #[derive(Clone, Debug)] pub struct CreateMessage(pub VecMap<&'static str, Value>, pub Option>); impl CreateMessage { /// Set the content of the message. /// /// **Note**: Message contents must be under 2000 unicode code points. #[inline] pub fn content(self, content: D) -> Self { self._content(content.to_string()) } fn _content(mut self, content: String) -> Self { self.0.insert("content", Value::String(content)); self } /// Set an embed for the message. pub fn embed(mut self, f: F) -> Self where F: FnOnce(CreateEmbed) -> CreateEmbed { let map = utils::vecmap_to_json_map(f(CreateEmbed::default()).0); let embed = Value::Object(map); self.0.insert("embed", embed); self } /// Set whether the message is text-to-speech. /// /// Think carefully before setting this to `true`. /// /// Defaults to `false`. pub fn tts(mut self, tts: bool) -> Self { self.0.insert("tts", Value::Bool(tts)); self } /// Adds a list of reactions to create after the message's sent. #[inline] pub fn reactions, It: IntoIterator>(self, reactions: It) -> Self { self._reactions(reactions.into_iter().map(Into::into).collect()) } fn _reactions(mut self, reactions: Vec) -> Self { self.1 = Some(reactions); self } } impl Default for CreateMessage { /// Creates a map for sending a [`Message`], setting [`tts`] to `false` by /// default. /// /// [`Message`]: ../model/channel/struct.Message.html /// [`tts`]: #method.tts fn default() -> CreateMessage { let mut map = VecMap::new(); map.insert("tts", Value::Bool(false)); CreateMessage(map, None) } }