from .base import DiscordModelsBase from .. import configs from flask import current_app class User(DiscordModelsBase): """Class representing Discord User. Attributes ---------- id : int The discord ID of the user. username : str The discord username of the user. discriminator : str 4 length string representing discord tag of the user. avatar_hash : str Hash of users avatar. bot : bool A boolean representing whether the user belongs to an OAuth2 application. mfa_enabled : bool A boolean representing whether the user has two factor enabled on their account. locale : str The user's chosen language option. verified : bool A boolean representing whether the email on this account has been verified. email : str User's email ID. flags : int An integer representing the `user flags `_. premium_type : int An integer representing the `type of nitro subscription `_. """ def __init__(self, payload): self._payload = payload self.id = int(self._payload["id"]) self.username = self._payload["username"] self.discriminator = self._payload["discriminator"] self.avatar_hash = self._payload.get("avatar", self.discriminator) self.bot = self._payload.get("bot", False) self.mfa_enabled = self._payload.get("mfa_enabled") self.locale = self._payload.get("locale") self.verified = self._payload.get("verified") self.email = self._payload.get("email") self.flags = self._payload.get("flags") self.premium_type = self._payload.get("premium_type") def __str__(self): return f"{self.name}#{self.discriminator}" @property def name(self): """An alias to the username attribute.""" return self.username @property def avatar_url(self): """A property returning direct URL to user's avatar.""" image_format = configs.DISCORD_ANIMATED_IMAGE_FORMAT \ if self.is_avatar_animated else configs.DISCORD_IMAGE_FORMAT return configs.DISCORD_USER_AVATAR_BASE_URL.format( user_id=self.id, avatar_hash=self.avatar_hash, format=image_format) @property def is_avatar_animated(self): """A boolean representing if avatar of user is animated. Meaning user has GIF avatar.""" return self.avatar_hash.startswith("a_") def add_to_guild(self, guild_id): discord = current_app.discord return discord.request( f"/guilds/{guild_id}/members/{self.id}", method="PUT", headers=discord.bot_authorization_header) class Bot(User): """Class representing the client user itself."""