Safe Haskell	Safe-Inferred
Language	Haskell2010

Calamity.Types.Tellable

Description

Things that are messageable

Synopsis

class ToMessage a where
- intoMsg :: a -> Endo CreateMessageOptions
class Tellable a where
- getChannel :: (BotC r, Member (Error RestError) r) => a -> Sem r (Snowflake Channel)
newtype TMention a = TMention (Snowflake a)
tell :: forall msg r t. (BotC r, ToMessage msg, Tellable t) => t -> msg -> Sem r (Either RestError Message)
reply :: forall msg r t. (BotC r, ToMessage msg, HasID Channel t, HasID Message t) => t -> msg -> Sem r (Either RestError Message)
runToMessage :: ToMessage a => a -> CreateMessageOptions

Documentation

class ToMessage a where Source #

Things that can be used to send a message

Can be used to compose text, embeds, and files. e.g.

intoMsg Text "A message" <> intoMsg Embed (def & #description ?~ "Embed description")

Methods

intoMsg :: a -> Endo CreateMessageOptions Source #

Turn a into a CreateMessageOptions builder

Instances

Instances details

ToMessage AllowedMentions Source #	Allowed mentions, `(<>)` combines allowed mentions
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: AllowedMentions -> Endo CreateMessageOptions Source #
ToMessage CreateMessageAttachment Source #	Message attachments, `(<>)` appends a new file
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: CreateMessageAttachment -> Endo CreateMessageOptions Source #
ToMessage CreateMessageOptions Source #
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: CreateMessageOptions -> Endo CreateMessageOptions Source #
ToMessage Button Source #	Add a singleton row containing a `Button` to the message,
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: Button -> Endo CreateMessageOptions Source #
ToMessage Component Source #	Add a singleton row containing a `Component` to the message If the component is not already an actionrow, it is wrapped in a singleton row
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: Component -> Endo CreateMessageOptions Source #
ToMessage LinkButton Source #	Add a singleton row containing a `LinkButton` to the message,
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: LinkButton -> Endo CreateMessageOptions Source #
ToMessage Select Source #	Add a singleton row containing a `Select` to the message,
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: Select -> Endo CreateMessageOptions Source #
ToMessage Embed Source #	Message embed, `(<>)` appends a new embed
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: Embed -> Endo CreateMessageOptions Source #
ToMessage MessageReference Source #	Set a `MessageReference` as the message to reply to
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: MessageReference -> Endo CreateMessageOptions Source #
ToMessage Text Source #	Message content, `(<>)` concatenates the content
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: Text -> Endo CreateMessageOptions Source #
ToMessage Text Source #	Message content, `(<>)` concatenates the content
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: Text -> Endo CreateMessageOptions Source #
ToMessage String Source #	Message content, `(<>)` concatenates the content
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: String -> Endo CreateMessageOptions Source #
ToMessage (Endo CreateMessageOptions) Source #
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: Endo CreateMessageOptions -> Endo CreateMessageOptions Source #
ToMessage (TMention Member) Source #	Add a `Member` id to the list of allowed user mentions
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: TMention Member -> Endo CreateMessageOptions Source #
ToMessage (TMention Role) Source #	Add a `Role` id to the list of allowed role mentions
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: TMention Role -> Endo CreateMessageOptions Source #
ToMessage (TMention User) Source #	Add a `User` id to the list of allowed user mentions
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: TMention User -> Endo CreateMessageOptions Source #
ToMessage [Button] Source #	Add an row of `Button`s to the message
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: [Button] -> Endo CreateMessageOptions Source #
ToMessage [Component] Source #	Add many components to a message. Each component will be wrapped in a singleton ActionRow if not already
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: [Component] -> Endo CreateMessageOptions Source #
ToMessage [LinkButton] Source #	Add an row of `LinkButton`s to the message
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: [LinkButton] -> Endo CreateMessageOptions Source #
ToMessage [Select] Source #	Add an row of `Select`s to the message
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: [Select] -> Endo CreateMessageOptions Source #
ToMessage (CreateMessageOptions -> CreateMessageOptions) Source #
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: (CreateMessageOptions -> CreateMessageOptions) -> Endo CreateMessageOptions Source #

class Tellable a where Source #

Methods

getChannel :: (BotC r, Member (Error RestError) r) => a -> Sem r (Snowflake Channel) Source #

Instances

Instances details

Tellable FullContext Source #
Instance details Defined in Calamity.Commands.Context Methods getChannel :: forall (r :: EffectRow). (BotC r, Member (Error RestError) r) => FullContext -> Sem r (Snowflake Channel) Source #
Tellable LightContext Source #
Instance details Defined in Calamity.Commands.Context Methods getChannel :: forall (r :: EffectRow). (BotC r, Member (Error RestError) r) => LightContext -> Sem r (Snowflake Channel) Source #
Tellable Channel Source #
Instance details Defined in Calamity.Types.Tellable Methods getChannel :: forall (r :: EffectRow). (BotC r, Member (Error RestError) r) => Channel -> Sem r (Snowflake Channel) Source #
Tellable DMChannel Source #
Instance details Defined in Calamity.Types.Tellable Methods getChannel :: forall (r :: EffectRow). (BotC r, Member (Error RestError) r) => DMChannel -> Sem r (Snowflake Channel) Source #
Tellable TextChannel Source #
Instance details Defined in Calamity.Types.Tellable Methods getChannel :: forall (r :: EffectRow). (BotC r, Member (Error RestError) r) => TextChannel -> Sem r (Snowflake Channel) Source #
Tellable Message Source #
Instance details Defined in Calamity.Types.Tellable Methods getChannel :: forall (r :: EffectRow). (BotC r, Member (Error RestError) r) => Message -> Sem r (Snowflake Channel) Source #
Tellable Member Source #
Instance details Defined in Calamity.Types.Tellable Methods getChannel :: forall (r :: EffectRow). (BotC r, Member0 (Error RestError) r) => Member -> Sem r (Snowflake Channel) Source #
Tellable User Source #
Instance details Defined in Calamity.Types.Tellable Methods getChannel :: forall (r :: EffectRow). (BotC r, Member (Error RestError) r) => User -> Sem r (Snowflake Channel) Source #
Tellable (Snowflake Channel) Source #
Instance details Defined in Calamity.Types.Tellable Methods getChannel :: forall (r :: EffectRow). (BotC r, Member (Error RestError) r) => Snowflake Channel -> Sem r (Snowflake Channel) Source #
Tellable (Snowflake DMChannel) Source #
Instance details Defined in Calamity.Types.Tellable Methods getChannel :: forall (r :: EffectRow). (BotC r, Member (Error RestError) r) => Snowflake DMChannel -> Sem r (Snowflake Channel) Source #
Tellable (Snowflake TextChannel) Source #
Instance details Defined in Calamity.Types.Tellable Methods getChannel :: forall (r :: EffectRow). (BotC r, Member (Error RestError) r) => Snowflake TextChannel -> Sem r (Snowflake Channel) Source #
Tellable (Snowflake Member) Source #
Instance details Defined in Calamity.Types.Tellable Methods getChannel :: forall (r :: EffectRow). (BotC r, Member0 (Error RestError) r) => Snowflake Member -> Sem r (Snowflake Channel) Source #
Tellable (Snowflake User) Source #
Instance details Defined in Calamity.Types.Tellable Methods getChannel :: forall (r :: EffectRow). (BotC r, Member (Error RestError) r) => Snowflake User -> Sem r (Snowflake Channel) Source #

newtype TMention a Source #

A wrapper type for allowing mentions

Constructors

TMention (Snowflake a)

Instances

Instances details

Show (TMention a) Source #
Instance details Defined in Calamity.Types.Tellable Methods showsPrec :: Int -> TMention a -> ShowS # show :: TMention a -> String # showList :: [TMention a] -> ShowS #
ToMessage (TMention Member) Source #	Add a `Member` id to the list of allowed user mentions
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: TMention Member -> Endo CreateMessageOptions Source #
ToMessage (TMention Role) Source #	Add a `Role` id to the list of allowed role mentions
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: TMention Role -> Endo CreateMessageOptions Source #
ToMessage (TMention User) Source #	Add a `User` id to the list of allowed user mentions
Instance details Defined in Calamity.Types.Tellable Methods intoMsg :: TMention User -> Endo CreateMessageOptions Source #

tell :: forall msg r t. (BotC r, ToMessage msg, Tellable t) => t -> msg -> Sem r (Either RestError Message) Source #

Send a message to something that is messageable

To send a string literal you'll probably want to use TypeApplication to specify the type of msg

Examples

Sending a string:

void $ tell @Text m ("Somebody told me to tell you about: " <> s)

reply :: forall msg r t. (BotC r, ToMessage msg, HasID Channel t, HasID Message t) => t -> msg -> Sem r (Either RestError Message) Source #

Create a reply to an existing message in the same channel

To send a string literal you'll probably want to use TypeApplication to specify the type of msg

Examples

Sending a string:

void $ reply @Text msgToReplyTo ("Somebody told me to tell you about: " <> s)

runToMessage :: ToMessage a => a -> CreateMessageOptions Source #