Class: Discordrb::Profile

Inherits:
User
  • Object
show all
Defined in:
lib/discordrb/data/profile.rb

Overview

This class is a special variant of User that represents the bot's user profile (things like own username and the avatar). It can be accessed using Bot#profile.

Instance Attribute Summary

Attributes inherited from User

#game, #status, #stream_type, #stream_url

Attributes included from UserAttributes

#avatar_id, #bot_account, #discriminator, #username

Attributes included from IDObject

#id

Instance Method Summary collapse

Methods inherited from User

#await, #await!, #dnd?, #idle?, #offline?, #on, #online?, #pm, #send_file, #webhook?

Methods included from UserAttributes

#avatar_url, #distinct, #mention

Methods included from IDObject

#==, #creation_time, synthesise

Constructor Details

#initialize(data, bot) ⇒ Profile

Returns a new instance of Profile.



7
8
9
 
# File 'lib/discordrb/data/profile.rb', line 7

def initialize(data, bot)
  super(data, bot)
end

Instance Method Details

#avatar=(avatar) ⇒ Object

Changes the bot's avatar.

Parameters:

  • avatar (String, #read) —

    A JPG file to be used as the avatar, either something readable (e.g. File Object) or as a data URL.



28
29
30
31
32
33
34
35
36
37
38
39
 
# File 'lib/discordrb/data/profile.rb', line 28

def avatar=(avatar)
  if avatar.respond_to? :read
    # Set the file to binary mode if supported, so we don't get problems with Windows
    avatar.binmode if avatar.respond_to?(:binmode)

    avatar_string = 'data:image/jpg;base64,'
    avatar_string += Base64.strict_encode64(avatar.read)
    update_profile_data(avatar: avatar_string)
  else
    update_profile_data(avatar: avatar)
  end
end

#current_bot? ⇒ true

Whether or not the user is the bot. The Profile can only ever be the bot user, so this always returns true.

Returns:

  • (true) 


13
14
15
 
# File 'lib/discordrb/data/profile.rb', line 13

def current_bot?
  true
end

#dnd ⇒ Object Also known as: busy

Note:

Only usable on User accounts.

Sets the user status setting to Do Not Disturb.



63
64
65
 
# File 'lib/discordrb/data/profile.rb', line 63

def dnd
  update_profile_status_setting('dnd')
end

#idle ⇒ Object

Note:

Only usable on User accounts.

Sets the user status setting to Idle.



57
58
59
 
# File 'lib/discordrb/data/profile.rb', line 57

def idle
  update_profile_status_setting('idle')
end

#inspect ⇒ Object

The inspect method is overwritten to give more useful output



76
77
78
 
# File 'lib/discordrb/data/profile.rb', line 76

def inspect
  "<Profile user=#{super}>"
end

#invisible ⇒ Object

Note:

Only usable on User accounts.

Sets the user status setting to Invisible.



71
72
73
 
# File 'lib/discordrb/data/profile.rb', line 71

def invisible
  update_profile_status_setting('invisible')
end

#online ⇒ Object

Note:

Only usable on User accounts.

Sets the user status setting to Online.



51
52
53
 
# File 'lib/discordrb/data/profile.rb', line 51

def online
  update_profile_status_setting('online')
end

#username=(username) ⇒ Object Also known as: name=

Sets the bot's username.

Parameters:

  • username (String) —

    The new username.



19
20
21
 
# File 'lib/discordrb/data/profile.rb', line 19

def username=(username)
  update_profile_data(username: username)
end