mirror of
https://github.com/Rapptz/discord.py.git
synced 2025-05-10 07:49:48 +00:00
Implement some missing attributes of Guild
(and Guild.edit
)
This commit is contained in:
parent
40a4604604
commit
ed80ba6a5e
@ -103,6 +103,10 @@ class Guild(Hashable):
|
|||||||
The maximum amount of presences for the guild.
|
The maximum amount of presences for the guild.
|
||||||
max_members: Optional[:class:`int`]
|
max_members: Optional[:class:`int`]
|
||||||
The maximum amount of members for the guild.
|
The maximum amount of members for the guild.
|
||||||
|
max_video_channel_users: Optional[:class:`int`]
|
||||||
|
The maximum amount of users in a video channel.
|
||||||
|
|
||||||
|
.. versionadded:: 1.4
|
||||||
banner: Optional[:class:`str`]
|
banner: Optional[:class:`str`]
|
||||||
The guild's banner.
|
The guild's banner.
|
||||||
description: Optional[:class:`str`]
|
description: Optional[:class:`str`]
|
||||||
@ -158,9 +162,10 @@ class Guild(Hashable):
|
|||||||
'owner_id', 'mfa_level', 'emojis', 'features',
|
'owner_id', 'mfa_level', 'emojis', 'features',
|
||||||
'verification_level', 'explicit_content_filter', 'splash',
|
'verification_level', 'explicit_content_filter', 'splash',
|
||||||
'_voice_states', '_system_channel_id', 'default_notifications',
|
'_voice_states', '_system_channel_id', 'default_notifications',
|
||||||
'description', 'max_presences', 'max_members', 'premium_tier',
|
'description', 'max_presences', 'max_members', 'max_video_channel_users',
|
||||||
'premium_subscription_count', '_system_channel_flags',
|
'premium_tier', 'premium_subscription_count', '_system_channel_flags',
|
||||||
'preferred_locale', 'discovery_splash', '_rules_channel_id')
|
'preferred_locale', 'discovery_splash', '_rules_channel_id',
|
||||||
|
'_public_updates_channel_id')
|
||||||
|
|
||||||
_PREMIUM_GUILD_LIMITS = {
|
_PREMIUM_GUILD_LIMITS = {
|
||||||
None: _GuildLimit(emoji=50, bitrate=96e3, filesize=8388608),
|
None: _GuildLimit(emoji=50, bitrate=96e3, filesize=8388608),
|
||||||
@ -284,12 +289,14 @@ class Guild(Hashable):
|
|||||||
self.description = guild.get('description')
|
self.description = guild.get('description')
|
||||||
self.max_presences = guild.get('max_presences')
|
self.max_presences = guild.get('max_presences')
|
||||||
self.max_members = guild.get('max_members')
|
self.max_members = guild.get('max_members')
|
||||||
|
self.max_video_channel_users = guild.get('max_video_channel_users')
|
||||||
self.premium_tier = guild.get('premium_tier', 0)
|
self.premium_tier = guild.get('premium_tier', 0)
|
||||||
self.premium_subscription_count = guild.get('premium_subscription_count') or 0
|
self.premium_subscription_count = guild.get('premium_subscription_count') or 0
|
||||||
self._system_channel_flags = guild.get('system_channel_flags', 0)
|
self._system_channel_flags = guild.get('system_channel_flags', 0)
|
||||||
self.preferred_locale = guild.get('preferred_locale')
|
self.preferred_locale = guild.get('preferred_locale')
|
||||||
self.discovery_splash = guild.get('discovery_splash')
|
self.discovery_splash = guild.get('discovery_splash')
|
||||||
self._rules_channel_id = utils._get_as_snowflake(guild, 'rules_channel_id')
|
self._rules_channel_id = utils._get_as_snowflake(guild, 'rules_channel_id')
|
||||||
|
self._public_updates_channel_id = utils._get_as_snowflake(guild, 'public_updates_channel_id')
|
||||||
|
|
||||||
for mdata in guild.get('members', []):
|
for mdata in guild.get('members', []):
|
||||||
member = Member(data=mdata, guild=self, state=state)
|
member = Member(data=mdata, guild=self, state=state)
|
||||||
@ -458,6 +465,19 @@ class Guild(Hashable):
|
|||||||
channel_id = self._rules_channel_id
|
channel_id = self._rules_channel_id
|
||||||
return channel_id and self._channels.get(channel_id)
|
return channel_id and self._channels.get(channel_id)
|
||||||
|
|
||||||
|
@property
|
||||||
|
def public_updates_channel(self):
|
||||||
|
"""Optional[:class:`TextChannel`]: Return's the guild's channel where admins and
|
||||||
|
moderators of the guilds receive notices from Discord. This is only available to
|
||||||
|
guilds that contain `PUBLIC` in :attr:`Guild.features`.
|
||||||
|
|
||||||
|
If no channel is set, then this returns ``None``.
|
||||||
|
|
||||||
|
.. versionadded:: 1.4
|
||||||
|
"""
|
||||||
|
channel_id = self._public_updates_channel_id
|
||||||
|
return channel_id and self._channels.get(channel_id)
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def emoji_limit(self):
|
def emoji_limit(self):
|
||||||
""":class:`int`: The maximum number of emoji slots this guild has."""
|
""":class:`int`: The maximum number of emoji slots this guild has."""
|
||||||
@ -947,6 +967,9 @@ class Guild(Hashable):
|
|||||||
You must have the :attr:`~Permissions.manage_guild` permission
|
You must have the :attr:`~Permissions.manage_guild` permission
|
||||||
to edit the guild.
|
to edit the guild.
|
||||||
|
|
||||||
|
.. versionchanged:: 1.4
|
||||||
|
The `rules_channel` and `public_updates_channel` keyword-only parameters were added.
|
||||||
|
|
||||||
Parameters
|
Parameters
|
||||||
----------
|
----------
|
||||||
name: :class:`str`
|
name: :class:`str`
|
||||||
@ -956,7 +979,7 @@ class Guild(Hashable):
|
|||||||
contain `PUBLIC` in :attr:`Guild.features`.
|
contain `PUBLIC` in :attr:`Guild.features`.
|
||||||
icon: :class:`bytes`
|
icon: :class:`bytes`
|
||||||
A :term:`py:bytes-like object` representing the icon. Only PNG/JPEG supported
|
A :term:`py:bytes-like object` representing the icon. Only PNG/JPEG supported
|
||||||
and GIF for guilds with ``ANIMATED_ICON`` feature.
|
and GIF This is only available to guilds that contain `ANIMATED_ICON` in :attr:`Guild.features`.
|
||||||
Could be ``None`` to denote removal of the icon.
|
Could be ``None`` to denote removal of the icon.
|
||||||
banner: :class:`bytes`
|
banner: :class:`bytes`
|
||||||
A :term:`py:bytes-like object` representing the banner.
|
A :term:`py:bytes-like object` representing the banner.
|
||||||
@ -964,8 +987,8 @@ class Guild(Hashable):
|
|||||||
splash: :class:`bytes`
|
splash: :class:`bytes`
|
||||||
A :term:`py:bytes-like object` representing the invite splash.
|
A :term:`py:bytes-like object` representing the invite splash.
|
||||||
Only PNG/JPEG supported. Could be ``None`` to denote removing the
|
Only PNG/JPEG supported. Could be ``None`` to denote removing the
|
||||||
splash. Only available for partnered guilds with ``INVITE_SPLASH``
|
splash. This is only available to guilds that contain `INVITE_SPLASH`
|
||||||
feature.
|
in :attr:`Guild.features`.
|
||||||
region: :class:`VoiceRegion`
|
region: :class:`VoiceRegion`
|
||||||
The new region for the guild's voice communication.
|
The new region for the guild's voice communication.
|
||||||
afk_channel: Optional[:class:`VoiceChannel`]
|
afk_channel: Optional[:class:`VoiceChannel`]
|
||||||
@ -987,6 +1010,14 @@ class Guild(Hashable):
|
|||||||
The new channel that is used for the system channel. Could be ``None`` for no system channel.
|
The new channel that is used for the system channel. Could be ``None`` for no system channel.
|
||||||
system_channel_flags: :class:`SystemChannelFlags`
|
system_channel_flags: :class:`SystemChannelFlags`
|
||||||
The new system channel settings to use with the new system channel.
|
The new system channel settings to use with the new system channel.
|
||||||
|
rules_channel: Optional[:class:`TextChannel`]
|
||||||
|
The new channel that is used for rules. This is only available to
|
||||||
|
guilds that contain `PUBLIC` in :attr:`Guild.features`. Could be ``None`` for no rules
|
||||||
|
channel.
|
||||||
|
public_updates_channel: Optional[:class:`TextChannel`]
|
||||||
|
The new channel that is used for public updates from Discord. This is only available to
|
||||||
|
guilds that contain `PUBLIC` in :attr:`Guild.features`. Could be ``None`` for no
|
||||||
|
public updates channel.
|
||||||
reason: Optional[:class:`str`]
|
reason: Optional[:class:`str`]
|
||||||
The reason for editing this guild. Shows up on the audit log.
|
The reason for editing this guild. Shows up on the audit log.
|
||||||
|
|
||||||
@ -1095,6 +1126,26 @@ class Guild(Hashable):
|
|||||||
raise InvalidArgument('system_channel_flags field must be of type SystemChannelFlags')
|
raise InvalidArgument('system_channel_flags field must be of type SystemChannelFlags')
|
||||||
|
|
||||||
fields['system_channel_flags'] = system_channel_flags.value
|
fields['system_channel_flags'] = system_channel_flags.value
|
||||||
|
|
||||||
|
try:
|
||||||
|
rules_channel = fields.pop('rules_channel')
|
||||||
|
except KeyError:
|
||||||
|
pass
|
||||||
|
else:
|
||||||
|
if rules_channel is None:
|
||||||
|
fields['rules_channel_id'] = rules_channel
|
||||||
|
else:
|
||||||
|
fields['rules_channel_id'] = rules_channel.id
|
||||||
|
|
||||||
|
try:
|
||||||
|
public_updates_channel = fields.pop('public_updates_channel')
|
||||||
|
except KeyError:
|
||||||
|
pass
|
||||||
|
else:
|
||||||
|
if rules_channel is None:
|
||||||
|
fields['public_updates_channel_id'] = rules_channel
|
||||||
|
else:
|
||||||
|
fields['public_updates_channel_id'] = rules_channel.id
|
||||||
await http.edit_guild(self.id, reason=reason, **fields)
|
await http.edit_guild(self.id, reason=reason, **fields)
|
||||||
|
|
||||||
async def fetch_channels(self):
|
async def fetch_channels(self):
|
||||||
|
@ -620,7 +620,8 @@ class HTTPClient:
|
|||||||
'afk_channel_id', 'splash', 'verification_level',
|
'afk_channel_id', 'splash', 'verification_level',
|
||||||
'system_channel_id', 'default_message_notifications',
|
'system_channel_id', 'default_message_notifications',
|
||||||
'description', 'explicit_content_filter', 'banner',
|
'description', 'explicit_content_filter', 'banner',
|
||||||
'system_channel_flags')
|
'system_channel_flags', 'rules_channel_id',
|
||||||
|
'public_updates_channel_id')
|
||||||
|
|
||||||
payload = {
|
payload = {
|
||||||
k: v for k, v in fields.items() if k in valid_keys
|
k: v for k, v in fields.items() if k in valid_keys
|
||||||
|
Loading…
x
Reference in New Issue
Block a user