@ -15,17 +15,6 @@ from disco.types.message import Emoji
from disco . types . permissions import PermissionValue , Permissions , Permissible from disco . types . permissions import PermissionValue , Permissions , Permissible
class DefaultMessageNotificationsLevel ( object ) :
ALL_MESSAGES = 0
ONLY_MENTIONS = 1
class ExplicitContentFilterLevel ( object ) :
NONE = 0
WITHOUT_ROLES = 1
ALL = 2
class MFALevel ( object ) : class MFALevel ( object ) :
NONE = 0 NONE = 0
ELEVATED = 1 ELEVATED = 1
@ -39,6 +28,17 @@ class VerificationLevel(object):
EXTREME = 4 EXTREME = 4
class ExplicitContentFilterLevel ( object ) :
NONE = 0
WITHOUT_ROLES = 1
ALL = 2
class DefaultMessageNotificationsLevel ( object ) :
ALL_MESSAGES = 0
ONLY_MENTIONS = 1
class PremiumTier ( object ) : class PremiumTier ( object ) :
NONE = 0 NONE = 0
TIER_1 = 1 TIER_1 = 1
@ -62,25 +62,25 @@ class GuildEmoji(Emoji):
The ID of this emoji . The ID of this emoji .
name : str name : str
The name of this emoji . The name of this emoji .
roles : list ( snowflake )
Roles this emoji is attached to .
user : User user : User
The User that created this emoji . The User that created this emoji .
require_colons : bool require_colons : bool
Whether this emoji requires colons to use . Whether this emoji requires colons to use .
managed : bool managed : bool
Whether this emoji is managed by an integration . Whether this emoji is managed by an integration .
roles : list ( snowflake )
Roles this emoji is attached to .
animated : bool animated : bool
Whether this emoji is animated . Whether this emoji is animated .
""" """
id = Field ( snowflake ) id = Field ( snowflake )
guild_id = Field ( snowflake )
name = Field ( text ) name = Field ( text )
roles = ListField ( snowflake )
user = Field ( User ) user = Field ( User )
require_colons = Field ( bool ) require_colons = Field ( bool )
managed = Field ( bool ) managed = Field ( bool )
roles = ListField ( snowflake )
animated = Field ( bool ) animated = Field ( bool )
guild_id = Field ( snowflake )
def __str__ ( self ) : def __str__ ( self ) :
return u ' < {} : {} : {} > ' . format ( ' a ' if self . animated else ' ' , self . name , self . id ) return u ' < {} : {} : {} > ' . format ( ' a ' if self . animated else ' ' , self . name , self . id )
@ -100,6 +100,10 @@ class GuildEmoji(Emoji):
return self . client . state . guilds . get ( self . guild_id ) return self . client . state . guilds . get ( self . guild_id )
class PruneCount ( SlottedModel ) :
pruned = Field ( int , default = None )
class Role ( SlottedModel ) : class Role ( SlottedModel ) :
""" """
A role object . A role object .
@ -110,30 +114,30 @@ class Role(SlottedModel):
The role ID . The role ID .
name : string name : string
The role name . The role name .
color : int
The RGB color of this role .
hoist : bool hoist : bool
Whether this role is hoisted ( displayed separately in the sidebar ) . Whether this role is hoisted ( displayed separately in the sidebar ) .
position : int
The position of this role in the hierarchy .
permissions : : class : ` disco . types . permissions . PermissionsValue `
The permissions this role grants .
managed : bool managed : bool
Whether this role is managed by an integration . Whether this role is managed by an integration .
color : int
The RGB color of this role .
permissions : : class : ` disco . types . permissions . PermissionsValue `
The permissions this role grants .
position : int
The position of this role in the hierarchy .
mentionable : bool mentionable : bool
Wherther this role is taggable in chat . Wherther this role is taggable in chat .
guild_id : snowflake guild_id : snowflake
The id of the server the role is in . The id of the server the role is in .
""" """
id = Field ( snowflake ) id = Field ( snowflake )
guild_id = Field ( snowflake )
name = Field ( text ) name = Field ( text )
color = Field ( int )
hoist = Field ( bool ) hoist = Field ( bool )
position = Field ( int )
permissions = Field ( PermissionValue )
managed = Field ( bool ) managed = Field ( bool )
color = Field ( int )
permissions = Field ( PermissionValue )
position = Field ( int )
mentionable = Field ( bool ) mentionable = Field ( bool )
guild_id = Field ( snowflake )
def __str__ ( self ) : def __str__ ( self ) :
return self . name return self . name
@ -158,6 +162,11 @@ class GuildBan(SlottedModel):
reason = Field ( text ) reason = Field ( text )
class GuildEmbed ( SlottedModel ) :
enabled = Field ( bool )
channel_id = Field ( snowflake )
class GuildMember ( SlottedModel ) : class GuildMember ( SlottedModel ) :
""" """
A GuildMember object . A GuildMember object .
@ -166,29 +175,29 @@ class GuildMember(SlottedModel):
- - - - - - - - - - - - - - - - - - - -
user : : class : ` disco . types . user . User ` user : : class : ` disco . types . user . User `
The user object of this member . The user object of this member .
guild_id : snowflake
The guild this member is part of .
nick : str nick : str
The nickname of the member . The nickname of the member .
roles : list ( snowflake ) mute : bool
Roles this member is part of . Whether this member is server voice - muted .
deaf : bool
Whether this member is server voice - deafened .
joined_at : datetime joined_at : datetime
When this user joined the guild . When this user joined the guild .
roles : list ( snowflake )
Roles this member is part of .
premium_since : datetime premium_since : datetime
When this user set their nitro boost to this server . When this user set their Nitro boost to this server .
deaf : bool
Whether this member is server voice - deafened .
mute : bool
Whether this member is server voice - muted .
guild_id : snowflake
The guild this member is part of .
""" """
user = Field ( User ) user = Field ( User )
guild_id = Field ( snowflake )
nick = Field ( text ) nick = Field ( text )
roles = ListField ( snowflake ) mute = Field ( bool )
deaf = Field ( bool )
joined_at = Field ( datetime ) joined_at = Field ( datetime )
roles = ListField ( snowflake )
premium_since = Field ( datetime ) premium_since = Field ( datetime )
deaf = Field ( bool )
mute = Field ( bool )
guild_id = Field ( snowflake )
def __str__ ( self ) : def __str__ ( self ) :
return self . user . __str__ ( ) return self . user . __str__ ( )
@ -220,8 +229,8 @@ class GuildMember(SlottedModel):
""" """
Bans the member from the guild . Bans the member from the guild .
Arg s Parameter s
- - - - - - - - - - - - - -
delete_message_days : int delete_message_days : int
The number of days to retroactively delete messages for . The number of days to retroactively delete messages for .
""" """
@ -237,8 +246,8 @@ class GuildMember(SlottedModel):
""" """
Sets the member ' s nickname (or clears it if None). Sets the member ' s nickname (or clears it if None).
Arg s Parameter s
- - - - - - - - - - - - - -
nickname : Optional [ str ] nickname : Optional [ str ]
The nickname ( or none to reset ) to set . The nickname ( or none to reset ) to set .
""" """
@ -312,6 +321,12 @@ class Guild(SlottedModel, Permissible):
The id of the embed channel . The id of the embed channel .
system_channel_id : snowflake system_channel_id : snowflake
The id of the system channel . The id of the system channel .
name : str
Guild ' s name.
icon : str
Guild ' s icon image hash
splash : str
Guild ' s splash image hash
widget_channel_id : snowflake widget_channel_id : snowflake
The id of the server widget channel The id of the server widget channel
banner : str banner : str
@ -355,47 +370,47 @@ class Guild(SlottedModel, Permissible):
premium_tier : int premium_tier : int
Guild ' s premium tier. Guild ' s premium tier.
premium_subscription_count : int premium_subscription_count : int
The amount of users using their n itroboost on this guild . The amount of users using their N itroboost on this guild .
""" """
id = Field ( snowflake ) id = Field ( snowflake )
name = Field ( text )
icon = Field ( text )
splash = Field ( text )
owner = Field ( bool ) owner = Field ( bool )
owner_id = Field ( snowflake ) owner_id = Field ( snowflake )
permissions = Field ( int ) permissions = Field ( int )
region = Field ( text )
afk_channel_id = Field ( snowflake ) afk_channel_id = Field ( snowflake )
embed_channel_id = Field ( snowflake )
system_channel_id = Field ( snowflake )
name = Field ( text )
icon = Field ( text )
splash = Field ( text )
banner = Field ( text )
region = Field ( text )
afk_timeout = Field ( int ) afk_timeout = Field ( int )
embed_enabled = Field ( bool ) embed_enabled = Field ( bool )
embed_channel_id = Field ( snowflake )
verification_level = Field ( enum ( VerificationLevel ) ) verification_level = Field ( enum ( VerificationLevel ) )
default_message_notifications = Field ( enum ( DefaultMessageNotificationsLevel ) )
explicit_content_filter = Field ( enum ( ExplicitContentFilterLevel ) ) explicit_content_filter = Field ( enum ( ExplicitContentFilterLevel ) )
roles = AutoDictField ( Role , ' id ' ) default_message_notifications = Field ( enum ( DefaultMessageNotificationsLevel ) )
emojis = AutoDictField ( GuildEmoji , ' id ' )
features = ListField ( str )
mfa_level = Field ( int ) mfa_level = Field ( int )
application_id = Field ( snowflake ) application_id = Field ( snowflake )
widget_enabled = Field ( bool ) widget_enabled = Field ( bool )
widget_channel_id = Field ( snowflake ) widget_channel_id = Field ( snowflake )
system_channel_id = Field ( snowflake )
joined_at = Field ( datetime ) joined_at = Field ( datetime )
large = Field ( bool ) large = Field ( bool )
unavailable = Field ( bool ) unavailable = Field ( bool )
member_count = Field ( int ) member_count = Field ( int )
voice_states = AutoDictField ( VoiceState , ' session_id ' ) voice_states = AutoDictField ( VoiceState , ' session_id ' )
features = ListField ( str )
members = AutoDictField ( GuildMember , ' id ' ) members = AutoDictField ( GuildMember , ' id ' )
channels = AutoDictField ( Channel , ' id ' ) channels = AutoDictField ( Channel , ' id ' )
max_presences = Field ( int , default = 5000 ) roles = AutoDictField ( Role , ' id ' )
max_members = Field ( int ) emojis = AutoDictField ( GuildEmoji , ' id ' )
vanity_url_code = Field ( text )
description = Field ( text )
banner = Field ( text )
premium_tier = Field ( int , default = 0 ) premium_tier = Field ( int , default = 0 )
premium_subscription_count = Field ( int , default = 0 ) premium_subscription_count = Field ( int , default = 0 )
system_channel_flags = Field ( int ) system_channel_flags = Field ( int )
preferred_locale = Field ( str ) preferred_locale = Field ( str )
vanity_url_code = Field ( text )
max_presences = Field ( int , default = 5000 )
max_members = Field ( int )
description = Field ( text )
def __init__ ( self , * args , * * kwargs ) : def __init__ ( self , * args , * * kwargs ) :
super ( Guild , self ) . __init__ ( * args , * * kwargs ) super ( Guild , self ) . __init__ ( * args , * * kwargs )
@ -470,6 +485,12 @@ class Guild(SlottedModel, Permissible):
return self . members . get ( user ) return self . members . get ( user )
def get_prune_count ( self , days = None ) :
return self . client . api . guilds_prune_count_get ( self . id , days = days )
def prune ( self , days = None , compute_prune_count = None ) :
return self . client . api . guilds_prune_create ( self . id , days = days , compute_prune_count = compute_prune_count )
def create_role ( self , * * kwargs ) : def create_role ( self , * * kwargs ) :
""" """
Create a new role . Create a new role .
@ -545,7 +566,8 @@ class Guild(SlottedModel, Permissible):
""" """
return self . client . api . guilds_channels_create ( return self . client . api . guilds_channels_create (
self . id , ChannelType . GUILD_TEXT , name = name , permission_overwrites = permission_overwrites , self . id , ChannelType . GUILD_TEXT , name = name , permission_overwrites = permission_overwrites ,
parent_id = parent_id , nsfw = nsfw , position = position , reason = reason ) parent_id = parent_id , nsfw = nsfw , position = position , reason = reason ,
)
def create_voice_channel ( def create_voice_channel (
self , self ,
@ -569,15 +591,15 @@ class Guild(SlottedModel, Permissible):
def get_invites ( self ) : def get_invites ( self ) :
return self . client . api . guilds_invites_list ( self . id ) return self . client . api . guilds_invites_list ( self . id )
def get_vanity_url ( self ) :
return self . client . api . guilds_vanity_url_get ( self . id )
def get_emojis ( self ) : def get_emojis ( self ) :
return self . client . api . guilds_emojis_list ( self . id ) return self . client . api . guilds_emojis_list ( self . id )
def get_emoji ( self , emoji ) : def get_emoji ( self , emoji ) :
return self . client . api . guilds_emojis_get ( self . id , emoji ) return self . client . api . guilds_emojis_get ( self . id , emoji )
def get_voice_regions ( self ) :
return self . client . api . guilds_voice_regions_list ( self . id )
def get_icon_url ( self , still_format = ' webp ' , animated_format = ' gif ' , size = 1024 ) : def get_icon_url ( self , still_format = ' webp ' , animated_format = ' gif ' , size = 1024 ) :
if not self . icon : if not self . icon :
return ' ' return ' '
@ -591,6 +613,12 @@ class Guild(SlottedModel, Permissible):
self . id , self . icon , still_format , size self . id , self . icon , still_format , size
) )
def get_vanity_url ( self ) :
if not self . vanity_url_code :
return ' '
return ' https://discord.gg/ ' + self . vanity_url_code
def get_splash_url ( self , fmt = ' webp ' , size = 1024 ) : def get_splash_url ( self , fmt = ' webp ' , size = 1024 ) :
if not self . splash : if not self . splash :
return ' ' return ' '
@ -607,6 +635,10 @@ class Guild(SlottedModel, Permissible):
def icon_url ( self ) : def icon_url ( self ) :
return self . get_icon_url ( ) return self . get_icon_url ( )
@property
def vanity_url ( self ) :
return self . get_vanity_url ( )
@property @property
def splash_url ( self ) : def splash_url ( self ) :
return self . get_splash_url ( ) return self . get_splash_url ( )
@ -635,6 +667,25 @@ class Guild(SlottedModel, Permissible):
return self . client . api . guilds_auditlogs_list ( self . id , * args , * * kwargs ) return self . client . api . guilds_auditlogs_list ( self . id , * args , * * kwargs )
class IntegrationAccount ( SlottedModel ) :
id = Field ( text )
name = Field ( text )
class Integration ( SlottedModel ) :
id = Field ( snowflake )
name = Field ( text )
type = Field ( text )
enabled = Field ( bool )
syncing = Field ( bool )
role_id = Field ( snowflake )
expire_behavior = Field ( int )
expire_grace_period = Field ( int )
user = Field ( User )
account = Field ( IntegrationAccount )
synced_at = Field ( datetime )
class AuditLogActionTypes ( object ) : class AuditLogActionTypes ( object ) :
GUILD_UPDATE = 1 GUILD_UPDATE = 1
CHANNEL_CREATE = 10 CHANNEL_CREATE = 10
“elderlabs”
5 years ago