Struct AttachmentBuilder

pub struct AttachmentBuilder { /* private fields */ }

AttachmentBuilder is used to build a Attachment

Implementations

impl AttachmentBuilder

pub fn new<S: Into<SlackText>>(fallback: S) -> Self

Make a new AttachmentBuilder

Fallback is the only required field which is a plain-text summary of the attachment.

pub fn text<S: Into<SlackText>>(self, text: S) -> Self

Optional text that appears within the attachment

pub fn color<C: TryInto<HexColor, Error = Error>>(self, color: C) -> Self

Set the color of the attachment

The color can be one of:

1. Strings: good, warning, danger
2. The built-in enums: SlackColor::Good, etc.
3. Any valid hex color code: e.g. #b13d41 or #000.

hex color codes will be checked to ensure a valid hex number is provided

pub fn pretext<S: Into<SlackText>>(self, pretext: S) -> Self

Optional text that appears above the attachment block

pub fn actions(self, actions: Vec<Action>) -> Self

Actions are defined as an array, and hashes contained within it will be displayed in a table inside the message attachment.

pub fn fields(self, fields: Vec<Field>) -> Self

Fields are defined as an array, and hashes contained within it will be displayed in a table inside the message attachment.

pub fn author_name<S: Into<SlackText>>(self, author_name: S) -> Self

Optional small text used to display the author’s name.

pub fn author_link<U: IntoUrl>(self, author_link: U) -> Self

Optional URL that will hyperlink the author_name.

pub fn author_icon<U: IntoUrl>(self, author_icon: U) -> Self

Optional URL that displays a small 16x16px image to the left of the author_name text.

pub fn title<S: Into<SlackText>>(self, title: S) -> Self

Optional larger, bolder text above the main body

pub fn callback_id<S: Into<SlackText>>(self, callback_id: S) -> Self

Optional larger, bolder text above the main body

pub fn title_link<U: IntoUrl>(self, title_link: U) -> Self

Optional URL to link to from the title

pub fn image_url<U: IntoUrl>(self, image_url: U) -> Self

Optional URL to an image that will be displayed in the body

pub fn thumb_url<U: IntoUrl>(self, thumb_url: U) -> Self

Optional URL to an image that will be displayed as a thumbnail to the right of the body

pub fn footer<S: Into<SlackText>>(self, footer: S) -> Self

Optional text that will appear at the bottom of the attachment

pub fn footer_icon<U: IntoUrl>(self, footer_icon: U) -> Self

Optional URL to an image that will be displayed at the bottom of the attachment

pub fn ts(self, time: &NaiveDateTime) -> Self

Optional timestamp to be displayed with the attachment

pub fn markdown_in<'a, I: IntoIterator<Item = &'a Section>>( self, sections: I, ) -> Self

Optional sections formatted as markdown.

pub fn build(self) -> Result<Attachment>

Attempt to build the Attachment

Trait Implementations

impl Debug for AttachmentBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.