Class: Discordrb::Events::MessageEvent

Inherits:
Event
  • Object
show all
Includes:
Respondable
Defined in:
lib/discordrb/events/message.rb

Overview

Event raised when a text message is sent to a channel

Instance Attribute Summary collapse

Attributes inherited from Event

#bot

Instance Method Summary collapse

Methods included from Respondable

#<<, #drain, #drain_into, #send_embed, #send_message, #send_temporary_message

Constructor Details

#initialize(message, bot) ⇒ MessageEvent

Returns a new instance of MessageEvent.



124
125
126
127
128
129
130
131
132
 
# File 'lib/discordrb/events/message.rb', line 124

def initialize(message, bot)
  @bot = bot
  @message = message
  @channel = message.channel
  @saved_message = ''
  @file = nil
  @filename = nil
  @file_spoiler = nil
end

Instance Attribute Details

#author ⇒ Member, User (readonly) Also known as: user

Returns who sent this message.

Returns:

See Also:



117
 
# File 'lib/discordrb/events/message.rb', line 117

delegate :author, :channel, :content, :timestamp, to: :message

#channel ⇒ Channel (readonly)

Returns the channel in which this message was sent.

Returns:

  • (Channel) —

    the channel in which this message was sent.

See Also:



117
 
# File 'lib/discordrb/events/message.rb', line 117

delegate :author, :channel, :content, :timestamp, to: :message

#content ⇒ String (readonly) Also known as: text

Returns the message's content.

Returns:

  • (String) —

    the message's content.

See Also:



117
 
# File 'lib/discordrb/events/message.rb', line 117

delegate :author, :channel, :content, :timestamp, to: :message

#file ⇒ File (readonly)

Returns the file that has been saved by a call to #attach_file and will be sent to Discord upon completion.

Returns:

  • (File) —

    the file that has been saved by a call to #attach_file and will be sent to Discord upon completion.



97
98
99
 
# File 'lib/discordrb/events/message.rb', line 97

def file
  @file
end

#file_spoiler ⇒ true, false (readonly)

Returns Whether or not this file should appear as a spoiler. Set by #attach_file.

Returns:

  • (true, false) —

    Whether or not this file should appear as a spoiler. Set by #attach_file



103
104
105
 
# File 'lib/discordrb/events/message.rb', line 103

def file_spoiler
  @file_spoiler
end

#filename ⇒ String (readonly)

Returns the filename set in #attach_file that will override the original filename when sent.

Returns:

  • (String) —

    the filename set in #attach_file that will override the original filename when sent.



100
101
102
 
# File 'lib/discordrb/events/message.rb', line 100

def filename
  @filename
end

#message ⇒ Message (readonly)

Returns the message which triggered this event.

Returns:

  • (Message) —

    the message which triggered this event.



91
92
93
 
# File 'lib/discordrb/events/message.rb', line 91

def message
  @message
end

#saved_message ⇒ String (readonly)

Returns the message that has been saved by calls to Respondable#<< and will be sent to Discord upon completion.

Returns:

  • (String) —

    the message that has been saved by calls to Respondable#<< and will be sent to Discord upon completion.



94
95
96
 
# File 'lib/discordrb/events/message.rb', line 94

def saved_message
  @saved_message
end

#server ⇒ Server? (readonly)

Returns the server where this message was sent, or nil if it was sent in PM.

Returns:

  • (Server, nil) —

    the server where this message was sent, or nil if it was sent in PM.

See Also:



122
 
# File 'lib/discordrb/events/message.rb', line 122

delegate :server, to: :channel

#timestamp ⇒ Time (readonly)

Returns the time at which the message was sent.

Returns:

  • (Time) —

    the time at which the message was sent.

See Also:



117
 
# File 'lib/discordrb/events/message.rb', line 117

delegate :author, :channel, :content, :timestamp, to: :message

Instance Method Details

#attach_file(file, filename: nil, spoiler: nil) ⇒ Object

Attaches a file to the message event and converts the message into a caption.

Parameters:

  • file (File) —

    The file to be attached

  • filename (String) (defaults to: nil) —

    Overrides the filename of the uploaded file

  • spoiler (true, false) (defaults to: nil) —

    Whether or not this file should appear as a spoiler.

Raises:

  • (ArgumentError) 


153
154
155
156
157
158
159
160
 
# File 'lib/discordrb/events/message.rb', line 153

def attach_file(file, filename: nil, spoiler: nil)
  raise ArgumentError, 'Argument is not a file!' unless file.is_a?(File)

  @file = file
  @filename = filename
  @file_spoiler = spoiler
  nil
end

#detach_file ⇒ Object

Detaches a file from the message event.



163
164
165
166
167
 
# File 'lib/discordrb/events/message.rb', line 163

def detach_file
  @file = nil
  @filename = nil
  @file_spoiler = nil
end

#from_bot? ⇒ true, false

Returns whether or not this message was sent by the bot itself.

Returns:

  • (true, false) —

    whether or not this message was sent by the bot itself



170
171
172
 
# File 'lib/discordrb/events/message.rb', line 170

def from_bot?
  @message.user.id == @bot.profile.id
end

#send_file(file, caption: nil, filename: nil, spoiler: nil) ⇒ Discordrb::Message

Sends file with a caption to the channel this message was sent in, right now. It is usually preferable to use Respondable#<< and #attach_file instead because it avoids rate limiting problems

Examples:

Send a file from disk

event.send_file(File.open('rubytaco.png', 'r'))

Parameters:

  • file (File) —

    The file to send to the channel

  • caption (String) (defaults to: nil) —

    The caption attached to the file

  • filename (String) (defaults to: nil) —

    Overrides the filename of the uploaded file

  • spoiler (true, false) (defaults to: nil) —

    Whether or not this file should appear as a spoiler.

Returns:



144
145
146
 
# File 'lib/discordrb/events/message.rb', line 144

def send_file(file, caption: nil, filename: nil, spoiler: nil)
  @message.channel.send_file(file, caption: caption, filename: filename, spoiler: spoiler)
end

#voice ⇒ VoiceBot?

Utility method to get the voice bot for the current server

Returns:

  • (VoiceBot, nil) —

    the voice bot connected to this message's server, or nil if there is none connected



176
177
178
 
# File 'lib/discordrb/events/message.rb', line 176

def voice
  @bot.voice(@message.channel.server.id)
end