Module: Discordrb::UserAttributes

Included in:
Light::LightProfile, User
Defined in:
lib/discordrb/data/user.rb

Overview

Mixin for the attributes users should have

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#avatar_id ⇒ String

Returns the ID of this user's current avatar, can be used to generate an avatar URL.

Returns:

  • (String) —

    the ID of this user's current avatar, can be used to generate an avatar URL.

See Also:



22
23
24
 
# File 'lib/discordrb/data/user.rb', line 22

def avatar_id
  @avatar_id
end

#bot_account ⇒ true, false (readonly) Also known as: bot_account?

Returns whether this user is a Discord bot account.

Returns:

  • (true, false) —

    whether this user is a Discord bot account



17
18
19
 
# File 'lib/discordrb/data/user.rb', line 17

def 
  @bot_account
end

#discriminator ⇒ String (readonly) Also known as: discrim, tag, discord_tag

Returns this user's discriminator which is used internally to identify users with identical usernames.

Returns:

  • (String) —

    this user's discriminator which is used internally to identify users with identical usernames.



11
12
13
 
# File 'lib/discordrb/data/user.rb', line 11

def discriminator
  @discriminator
end

#username ⇒ String (readonly) Also known as: name

Returns this user's username.

Returns:

  • (String) —

    this user's username



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

def username
  @username
end

Instance Method Details

#avatar_url(format = nil) ⇒ String

Utility function to get a user's avatar URL.

Parameters:

  • format (String, nil) (defaults to: nil) —

    If nil, the URL will default to webp for static avatars, and will detect if the user has a gif avatar. You can otherwise specify one of webp, jpg, png, or gif to override this. Will always be PNG for default avatars.

Returns:

  • (String) —

    the URL to the avatar image.



39
40
41
42
43
 
# File 'lib/discordrb/data/user.rb', line 39

def avatar_url(format = nil)
  return API::User.default_avatar(@discriminator) unless @avatar_id

  API::User.avatar_url(@id, @avatar_id, format)
end

#distinct ⇒ String

Utility function to get Discord's distinct representation of a user, i.e. username + discriminator

Returns:

  • (String) —

    distinct representation of user



32
33
34
 
# File 'lib/discordrb/data/user.rb', line 32

def distinct
  "#{@username}##{@discriminator}"
end

#mention ⇒ String

Utility function to mention users in messages

Returns:

  • (String) —

    the mention code in the form of <@id>



26
27
28
 
# File 'lib/discordrb/data/user.rb', line 26

def mention
  "<@#{@id}>"
end